‫Play ایپ سائننگ کا استعمال کریں

اس عمل کے کام کرنے کا طریقہ:

1. اپنے ایپ بنڈل پر دستخط کریں اور اسے Play کونسول پر اپ لوڈ کریں۔
2. ‫Google آپ کے ایپ بنڈل سے بہتر کردہ APKs تخلیق کرتا ہے اور ایپ سائننگ کلید سے ان پر دستخط کرتا ہے۔
3. ‫Google آپ کی ایپ کے مینی فیسٹ (com.android.stamp.source اور com.android.stamp.type) میں دو اسٹیمپس شامل کرنے کے لیے apksigner کا استعمال کرتا ہے اور پھر آپ کی ایپ سائننگ کلید کے ساتھ APKs پر دستخط کرتا ہے۔ ‫apksigner کے ذریعے شامل کردہ اسٹیمپس سے APKs کے تعلق سے یہ ٹریس کرنا ممکن ہوتا ہے کہ ان پر کس نے دستخط کیے ہیں۔
4. ‫Google صارفین کے لیے دستخط شدہ APKs فراہم کرتا ہے۔

جب آپ Google کی تخلیق کردہ کلید استعمال کرتے ہیں تو Google کرپٹوگرافک کے لحاظ سے مضبوط RSA کلید خودکار طور پر تخلیق کرتا ہے جو کہ 4096 بٹس ہیں۔ اگر آپ اپنی ذاتی ایپ سائننگ کلید کو اپ لوڈ کرنے کا انتخاب کرتے ہیں تو اس کا 2048 بٹس یا اس سے زیادہ کی ایک RSA کلید ہونا ضروری ہے۔

مرحلہ 1: Play ایپ سائننگ کو کنفیگر کریں

1. ‫Play کونسول کھولیں اور Play ایپ سائننگ صفحہ (جانچ کریں اور ریلیز کریں > سیٹ اپ کریں > ایپ سائننگ) پر جائیں۔
   • تجویز: آپ ایپ کی سالمیت کے صفحے (جانچ کریں اور ریلیز کریں > ایپ کی سالمیت)، جس میں سالمیت اور دستخط کرنے کی سروسز شامل ہیں جو آپ کو اس بات کو یقینی بنانے میں مدد کرتی ہیں کہ صارفین آپ کی ایپس اور گیمز کا تجربہ آپ کے ارادے کے مطابق کریں۔
2. اگر آپ کے پاس پہلے سے نہیں ہے تو Play ایپ سائننگ کی سروس کی شرائط کا جائزہ لیں اور قبول کریں کو منتخب کریں۔

مرحلہ 2: اپنی اصل کلید کی ایک کاپی Google کو بھیجیں اور ایک اپ لوڈ کلید تخلیق کریں

1. اپنی اصل ایپ سائننگ کلید کا پتا لگائیں۔
2. ‫Play کونسول کھولیں اور Play ایپ سائننگ صفحہ (جانچ کریں اور ریلیز کریں > سیٹ اپ کریں > ایپ سائننگ) پر جائیں۔
3. ایکسپورٹ اور اپ لوڈ کا وہ اختیار منتخب کریں جو آپ کی ریلیز کے عمل کے لیے موزوں ترین ہے اور ایک موجودہ ایپ سائننگ کلید اپ لوڈ کریں۔

مرحلہ 3: ایک اپ لوڈ کلید تخلیق کریں (اختیاری اور تجویز کردہ)

1. ایک اپ لوڈ کلید تخلیق کریں اور سرٹیفکیٹ کو Google Play پر اپ لوڈ کریں۔
   • آپ ایپ سائننگ کلید کو اپنی اپ لوڈ کلید کے طور پر بھی استعمال کرنا جاری رکھ سکتے ہیں۔
2. اپنی ایپ سائننگ کے سرٹیفکیٹ کے فنگر پرنٹس (MD5, SHA-1 اور SHA-256) کاپی کریں۔
   • ٹیسٹ کے مقاصد کے لیے، آپ کو سرٹیفکیٹ فنگر پرنٹ اور ایپ سائننگ کلید کا استعمال کر کے API فراہم کنندگان کے ساتھ اپنی اپ لوڈ کلید کا سرٹیفکیٹ رجسٹر کرنے کی ضرورت پڑ سکتی ہے۔

مرحلہ 4: اپ لوڈ کلید کے ساتھ اپنی اگلی ایپ اپ ڈیٹ پر دستخط کریں

جب آپ اپنی ایپ کے لیے اپ ڈیٹس ریلیز کرتے ہیں تو آپ کو اپنی اپ لوڈ کلید کے ساتھ ان پر دستخط کرنے کی ضرورت ہوتی ہے۔

• اگر آپ نے کوئی نئی اپ لوڈ کلید تخلیق نہیں کی ہے: ایپ بنڈلز کو Google Play پر اپ لوڈ کرنے سے پہلے دستخط کرنے کے لیے اپنی اصل ایپ سائننگ کلید کا استعمال جاری رکھیں۔ اگر آپ اپنی اصل ایپ سائننگ کلید کھو دیتے ہیں تو آپ ایک نئی اپ لوڈ کلید تخلیق کر سکتے ہیں اور اپنی ایپ کو اپ ڈیٹ کرنا جاری رکھنے کے لیے اسے Google کے ساتھ رجسٹر کر سکتے ہیں۔
• اگر آپ نے ایک نئی اپ لوڈ کلید تخلیق کی ہے: اپنی نئی اپ لوڈ کلید کو Google Play پر اپ لوڈ کرنے سے پہلے ایپ بنڈلز پر دستخط کرنے کے لیے استعمال کریں۔ ‫Google آپ کی شناخت کی توثیق کے لیے اپ لوڈ کلید کا استعمال کرتا ہے۔ اگر آپ اپنی اپ لوڈ کلید کھو دیتے ہیں تو آپ اسے ری سیٹ کرنے کے لیے سپورٹ سے رابطہ کر سکتے ہیں۔

اگر آپ اپنی موجودہ کلید کا اشتراک کرنے کے اہل نہیں ہیں تو ممکن ہے کہ آپ یہ کرنا چاہیں۔ اس سے پہلے کہ آپ اندراج کے لیے اپنی ایپ سائننگ کلید کو اپ گریڈ کرنے کا انتخاب کریں، نوٹ کریں کہ:

• اس اختیار کو دوہری ریلیز کی ضرورت ہوگی۔
• آپ کو ہر ریلیز میں اپنی پرانی کلید کے ساتھ دستخط شدہ ایک ایپ بنڈل اور ایک APK اپ لوڈ کرنے کی ضرورت ہوگی۔ ‫Google Play آپ کے ایپ بنڈلز کو *Android R (API لیول 30) یا اس کے بعد کے آلات کے لیے نئی کلید کے ساتھ دستخط شدہ APKs تخلیق کرنے کے لیے استعمال کرے گا۔ آپ کے پرانے APKs پرانے Android ریلیزز (API لیول 29 تک) کے لیے استعمال کیے جائیں گے۔

*اگر آپ کی ایپ SharedUserId کا استعمال کرتی ہے تو یہ تجویز کی جاتی ہے کہ Android T (API لیول 33) یا اس کے بعد کے ورژن چلانے والے آلات پر انسٹالز اور اپ ڈیٹس کے لیے کلیدی اپ گریڈ کا اطلاق کریں۔ اسے کنفیگر کرنے کے لیے، براہ کرم بنڈل کنفیگریشن میں ایک درست کم از کم SDK ورژن سیٹ کریں۔

مرحلہ 1: اپنی نئی کلید اپ لوڈ کریں اور گردش کا ثبوت تخلیق کریں اور اپ لوڈ کریں

‫Android آلات پر نئی کلید پر بھروسہ کرنے کے لیے، آپ کو ریپوزٹری سے ایک نئی سائننگ کلید اپ لوڈ کرنی ہوگی اور گردش کا ثبوت تخلیق اور اپ لوڈ کرنا ہوگا:

1. ‫Play کونسول کھولیں اور Play ایپ سائننگ صفحہ (جانچ کریں اور ریلیز کریں > سیٹ اپ کریں > ایپ سائننگ) پر جائیں۔
   • تجویز: آپ ایپ کی سالمیت کے صفحے (جانچ کریں اور ریلیز کریں > ایپ کی سالمیت)، جس میں سالمیت اور دستخط کرنے کی سروسز شامل ہیں جو آپ کو اس بات کو یقینی بنانے میں مدد کرتی ہیں کہ صارفین آپ کی ایپس اور گیمز کا تجربہ آپ کے ارادے کے مطابق کریں۔
2. ایپ سائننگ ٹیب منتخب کریں۔
3. جدید ترین اختیارات دکھائیں پر کلک کریں اور ایک نئی ایپ سائننگ کلید (اس کے لیے جاری دوہری ریلیز کی ضرورت ہے) استعمال کریں کو منتخب کریں۔
4. اپنے ڈویلپر اکاؤنٹ میں دیگر ایپ کی طرح ایک ہی ایپ سائننگ کلید استعمال کرنے کا انتخاب کریں یا Android اسٹوڈیو، Java KeyStore یا کسی اور ریپازٹری سے ایک نئی ایپ سائننگ کلید اپ لوڈ کرنے کا انتخاب کریں۔
5. آن اسکرین ہدایات کی پیروی کر کے، PEPK ٹول ڈاؤن لوڈ کریں اور چلائیں۔
6. آپ کے ZIP کے تیار ہونے پر تخلیق کردہ ZIP اپ لوڈ کریں پر کلک کریں اور اسے Play کونسول پر اپ لوڈ کریں۔
7. "5۔ گردش کا ثبوت اپ لوڈ کر کے نئی کلید کو Android آلات پر بھروسہ کرنے کی اجازت دیں،"کے برابر میں ہدایات دکھائیں پر کلک کریں۔
8. APKSigner ڈاؤن لوڈ کریں اور اس کمانڈ کو چلا کر گردش کا ثبوت تخلیق کریں:
   • $ apksigner rotate --out /path/to/new/file --old-signer --ks old-signer-jks --set-rollback true --new-signer --ks new-signer-jks --set-rollback true
9. تخلیق کردہ گردش کے ثبوت کی فائل اپ لوڈ کریں پر کلک کریں اور مرحلہ 8 میں تخلیق کردہ گردش کا ثبوت اپ لوڈ کریں۔
10. محفوظ کریں پر کلک کریں۔

• ایک RSA کلید 2048 بٹس یا اس سے زیادہ کی ہونی چاہیے۔

اپ لوڈ کلید تخلیق کرنے کے بعد، یہاں کچھ مقامات ہیں جنہیں ممکن ہے کہ آپ چیک اور اپ ڈیٹ کرنا چاہیں:

• مقامی مشینیں
• سائٹ پر مقفل سرور (مختلف ACLs)
• کلاؤڈ مشین (مختلف ACLs)
• وقف کردہ رازوں کے مینیجمنٹ کی سروسز
• ‫(Git) ریپازٹریز

کلید کو اپ گریڈ کرنے کی درخواست کرنے سے پہلے، ان تبدیلیوں کو سمجھنا ضروری ہے جنہیں اپ گریڈ مکمل ہونے کے بعد آپ کو کرنے کی ضرورت پڑ سکتی ہے۔

• اگر آپ متعدد ایپس کے درمیان ڈیٹا/کوڈ کا اشتراک کرنے کے لیے ایک ہی ایپ سائننگ کلید کا استعمال کرتے ہیں تو آپ کو ایپ سائننگ کلید کی اپنی نئی اور پرانی دونوں سرٹیفکیٹس کی شناخت کے لیے اپنی ایپس کو اپ ڈیٹ کرنا ہوگا۔ Android S (API لیول 32) یا اس سے پرانے ورژن پر چلائے جانے والے آلات پر، ڈیٹا/کوڈ کے اشتراک کے مقصد کے لیے Android پلیٹ فارم کے ذریعے صرف پرانی ایپ سائننگ کلید کے سرٹیفکیٹ کی شناخت کی جاتی ہے۔
• اگر آپ کی ایپ APIs کا استعمال کرتی ہے تو APIs کے کام جاری رکھنے کو یقینی بنانے کے لیے اپ ڈیٹ شائع کرنے سے پہلے API فراہم کنندگان کے ساتھ اپنی نئی اور پرانی ایپ سائننگ کلید کے سرٹیفکیٹس کو رجسٹر کرنا یقینی بنائیں۔ سرٹیفکیٹس Play کونسول میں Play ایپ سائننگ صفحہ (جانچ کریں اور ریلیز کریں > سیٹ اپ کریں > ایپ سائننگ) پر دستیاب ہیں۔  
• اگر آپ کے صارفین میں سے کوئی پئیر ٹو پئیر اشتراک کے ذریعے اپ ڈیٹس انسٹال کرتا ہے تو وہ صرف ان اپ ڈیٹس کو انسٹال کر سکیں گے جن پر آپ کی ایپ کے اس ورژن کی طرح ایک ہی کلید سے دستخط کیے گئے ہوں جو ان کے پاس پہلے سے انسٹال کرہ ہے۔ اگر وہ اپنی ایپ کو اپ ڈیٹ کرنے سے قاصر ہیں کیونکہ ان کے پاس آپ کی ایپ کا ایک ایسا ورژن ہے جس پر ایک مختلف کلید سے دستخط کیے گئے ہیں تو ان کے پاس اپ ڈیٹ حاصل کرنے کے لیے ایپ کو ان انسٹال اور دوبارہ انسٹال کرنے کا اختیار ہے۔

ہر ایپ اپنی ایپ سائننگ کلید کو Android N (API لیول 24) اور اس سے اوپر کے ورژن پر تمام انسٹالز کے لیے سال میں ایک بار اپ گریڈ کر سکتی ہے۔

اگر آپ کامیابی کے ساتھ اس کلید کو اپ گریڈ کرنے کی درخواست کرتے ہیں تو آپ کی نئی کلید تمام انسٹالز اور ایپ اپ ڈیٹس پر دستخط کرنے کے لیے استعمال ہوتی ہے۔ ‫Android T (API لیول 33) اور اس سے اوپر کے ورژن پر چلائے جانے والے آلات پر، Android پلیٹ فارم اپ گریڈ شدہ کلید کے استعمال کو نافذ کرتا ہے۔ ‫Android S (API لیول 32) یا اس سے پرانے ورژن پر چلائے جانے والے آلات پر، Android پلیٹ فارم اس اپ گریڈ شدہ کلید کے استعمال کو نافذ نہیں کرتا ہے اور پھر بھی پرانے سائننگ کلید کی ایپ کی سائننگ کلید کے طور پر شناخت کرتا ہے۔ اس میں Android پلیٹ فارم کی وہ خصوصیات بھی شامل ہیں (مثال کے طور پر، حسب ضرورت اجازت کا اشتراک) جو ایپ کی سائننگ کلید پر انحصار کرتی ہے۔ ‫Android N (API لیول 24) سے Android S (API لیول 32) پر چلنے والے آلات پر، Google Play Protect یہ چیک کرے گا کہ ایپ اپ ڈیٹس آپ کی اپ گریڈ شدہ کلید کے ساتھ دستخط کردہ ہیں الّا یہ کہ صارف اسے آف کر دے۔ یہ ایک اضافی توثیق فراہم کرتا ہے کیونکہ Android پلیٹ فارم Android S (API لیول 32) یا اس سے پرانے ورژن پر چلائے جانے والے آلات پر اپ گریڈ شدہ کلید کے استعمال کو نافذ نہیں کرتا ہے۔

1. ‫Play کونسول کھولیں اور Play ایپ سائننگ صفحہ (جانچ کریں اور ریلیز کریں > سیٹ اپ کریں > ایپ سائننگ) پر جائیں۔
   • تجویز: آپ ایپ کی سالمیت کے صفحے (جانچ کریں اور ریلیز کریں > ایپ کی سالمیت)، جس میں سالمیت اور دستخط کرنے کی سروسز شامل ہیں جو آپ کو اس بات کو یقینی بنانے میں مدد کرتی ہیں کہ صارفین آپ کی ایپس اور گیمز کا تجربہ آپ کے ارادے کے مطابق کریں۔
2. "اپنی ایپ سائننگ کلید کو اپ گریڈ کریں" کارڈ میں، کلید کو اپ گریڈ کرنے کی درخواست کریں کو منتخب کریں۔
3. اپنی ایپ سائننگ کلید کو Android N اور اس سے اوپر کے ورژن پر تمام انسٹالز کے لیے اپ گریڈ کرنے کی خاطر ایک اختیار منتخب کریں۔
4. ‫Google کو ایک نئی ایپ سائننگ کلید (تجویز کردہ) تخلیق کرنے یا اپ لوڈ کرنے کو کہیں۔
   • اپنی ایپ سائننگ کلید کو اپ گریڈ کرنے کے بعد، اگر آپ اپنی ایپ سائننگ اور اپ لوڈ کلید کے لیے ایک ہی کلید استعمال کر رہے تھے تو آپ اپنی پرانی ایپ سائننگ کلید کو اپنی اپ لوڈ کلید کے طور پر استعمال کرنا جاری رکھ سکتے ہیں یا ایک نئی اپ لوڈ کلید تخلیق کر سکتے ہیں۔
5. ایپ سائننگ کلید کو اپ گریڈ کی درخواست کرنے کی وجہ منتخب کریں۔
6. ضرورت پڑنے پر، API فراہم کنندگان کے ساتھ اپنی نئی ایپ سائننگ کلید کو رجسٹر کریں۔

تجویز: اگر آپ اپنی ایپ کو متعدد ڈسٹری بیوشن چینلز پر ڈسٹری بیوٹ کرتے ہیں اور آپ اپنے صارفین کے لیے ایپ اپ ڈیٹ کی موافقت کو زیادہ سے زیادہ کرنا چاہتے ہیں تو آپ کو ہر ڈسٹری بیوشن چینل پر اپنی کلید کو اپ گریڈ کرنا چاہیے۔ ‫Google Play کے کلیدی اپ گریڈ کے ساتھ موافق ہونے کے لیے، Android SDK بنانے کے ٹولز کے ساتھ بنڈل کردہ (نظرثانی 33.0.1+) ApkSigner ٹول کا استعمال کریں:

$ apksigner sign --in ${INPUT_APK}

--out ${OUTPUT_APK}

--ks ${ORIGINAL_KEYSTORE}

--ks-key-alias ${ORIGINAL_KEY_ALIAS}

--next-signer --ks ${UPGRADED_KEYSTORE}

--ks-key-alias ${UPGRADED_KEY_ALIAS}

--lineage ${LINEAGE}

 ایپ اپ ڈیٹس کے کام کرنے کے طریقے کے بارے میں مزید جانیں۔