ملفات APK والمسارات

تسمح لك واجهة برمجة تطبيقات مطوّر برامج Google Play بتحميل ملفات APK جديدة لتطبيقاتك وإصدارها إلى شرائح إصدارات مختلفة. ويسمح لك ذلك بنشر إصدارات ألفا والتجريبية من تطبيقك، والتي تمت إتاحتها للمستخدمين المعتمدين. ويسمح لك هذا أيضًا بنشر إصدار عملية الطرح على مراحل، والذي يتم توفيره تلقائيًا لعدد صغير من مستخدمي التطبيق. بعد طرح إصدار الطرح المرحلي، يمكنك زيادة عدد المستخدمين الذين يحصلون على هذا الإصدار من التطبيق تدريجيًا، إلى أن يتم نشره أخيرًا كإصدار "الإنتاج".

إضافة ملفات APK وتعديلها

1. يمكنك تحميل ملف APK واحد أو أكثر من خلال استدعاء طريقة Edits.apks: upload.

   وتعمل هذه الطريقة على تحميل ملف APK في "حزمة" للتخزين، حيث يمكن تعيينه إلى "مسار" لنشره للمستخدمين. (إذا تم حذف التعديل أو تجاهله، فسيتم فقد ملفات APK التي تم تحميلها لهذا التعديل.)

2. عليك بإطلاق ملفات APK في "tracks" عبر استدعاء Edits.tracks: update. يمكنك إصدار حزم APK للمقاطع الصوتية التالية:

   • مسارات اختبار مثل "alpha" و"beta"

     يتم نشر الإصدارات الأولية والتجريبية من التطبيق للمستخدمين الذين تعينهم إلى مجموعات الاختبار الأولي والتجريبي. يمكنك تعيين المستخدمين لهذه المجموعات باستخدام Google Play Console.

   • مرحلة الاختبار الداخلي: "internal"

     يتم نشر الإصدارات الداخلية من تطبيقك في مسار الاختبار الداخلي كما تم إعداده في Google Play Console.

   • مرحلة الإنتاج: "production"

     يتم نشر الإصدارات في مرحلة "الإنتاج" إلى جميع المستخدمين. يمكنك استخدام الإصدارات المرحلية في مسار "الإنتاج" لنشر إصدارك بأمان أولاً إلى نسبة صغيرة من مستخدمي الإنتاج، ثم زيادة هذه النسبة تدريجيًا مع زيادة ثقتك في الإصدار.

   يجب ألا يضع المستخدمون في الوضع البسيط أكثر من ملف APK واحد على أي مسار. يمكن للمستخدمين في الوضع المتقدم الذين يستخدمون دعم APK متعدد تحميل صفر أو ملف APK واحد أو أكثر لكل مسار.

اسم المسار للمسارات التي تأخذ شكل النموذج

يسبق اسم المسار لمسار عامل الشكل معرّفًا محددًا.

عامل الشكل	بادئة
نظام التشغيل Android Automotive	سيارات
Wear OS	رداء

كيف يتم حساب اسم المسار لمسار عامل شكل معين؟

تتمتّع أنواع المقاطع الصوتية الشائعة، مثل الإنتاج والاختبار المفتوح ومسار الاختبار الداخلي، بأسماء مقاطع صوتية معروفة.

نوع التتبع	اسم المقطع الصوتي التلقائي
الإنتاج	إصدار
الاختبار المفتوح	إصدار تجريبي
الاختبار الداخلي	قطر

يمكن حساب اسم المسار لمسار عامل معيّن من النموذج على النحو التالي: "[prefix]:defaultTrackName". على سبيل المثال، سيتضمن عامل النموذج Wear OS مقاطع صوتية بالاسم: "wear:production" و"wear:beta" و"wear:qa".

ويتم إنشاء مسارات الاختبار المغلقة يدويًا ولها أسماء مخصصة. وبالتالي، سيكون مسار الاختبار المغلق لعامل الشكل بالاسم $name سيكون اسم المسار "[prefix]:$name".

مثال على سير عمل APK

يصف هذا القسم طريقة نموذجية لاستخدام واجهة برمجة التطبيقات للمسارات. في هذه الحالة، نفترض أنك تريد تحميل نُسخ جديدة من حِزمة APK لكل مسار، وتعيين عدد من المستخدمين للحصول على إصدار الطرح على مراحل. (من الناحية العملية، من غير المحتمل أن يتخذ مطوّر البرامج كل هذه الإجراءات في العملية نفسها، وبدلاً من ذلك، يمكنك تحديث الإصدار التجريبي في يوم ما، وإنشاء إصدار مرحلي في مرحلة "الإنتاج" في يوم آخر، وهكذا).

1. افتح تعديلاً جديدًا، كما هو موضّح في القسم Edit Workflow.
2. استدع طريقة Edits.apks: upload لكل ملف APK تريد تحميله. تمرير ملف APK في نص طلب الطريقة. (تضع هذه حزِمة APK في منطقة تخزين، ولكنها لا تُصدرها على قناة الإصدار أو تنشرها.) تعرض هذه الطريقة رمز إصدار لكل ملف APK تحمّله؛ وستستخدم رمز الإصدار هذا للرجوع إلى ملف APK عند إصداره على قناة إصدار.

3. استدع طريقة Edits.tracks: update لكل مقطع صوتي تريد إصدار ملفات APK عليه. في نص الطلب، مرِّر مورد Edits.tracks الذي يحتوي على الإصدار الذي تريد طرحه. على سبيل المثال، لإصدار APK يحمل رمز الإصدار 88:

   {
   "releases": [{
     "versionCodes": ["88"],
     "status": "completed"
   }]
   }
   

   في هذه المرحلة، تظل ملفات APK غير متاحة للمستخدمين. كما هو الحال مع التعديلات الأخرى، لا يتم تفعيل التغييرات حتى تنفذها.

4. استدعاء طريقة التعديلات: تنفيذ لتنفيذ التغييرات. وبعد القيام بذلك، سيتم منح المستخدمين على كل مسار الإصدار المحدَّث من APK. (كما هو الحال مع جميع التعديلات، قد يستغرق تطبيق التغييرات عدة ساعات.)

عمليات الطرح على مراحل

عندما يكون لديك إصدار جديد من حِزمة APK تريد نشره تدريجيًا، يمكنك اختيار إصداره كإصدار "طرح على مراحل". وفي هذه الحالة، ينشره Google Play تلقائيًا على الكسر المطلوب من مستخدمي التطبيق الذين تحددهم. إذا لم تكن هناك أية مشكلات في حزمة APK "الطرح" (مثل حالات التعطُّل، وما إلى ذلك)، قد تزيد نسبة المستخدمين الذين يتلقون هذا الإصدار، وعندما تكون جاهزًا، يمكنك نشر ملف APK هذا كإصدار إنتاج جديد.

يصف هذا القسم الخطوات التي يمكنك اتباعها لتنفيذ طرح تدريجي لملف APK، ثم الترويج له في مرحلة الإنتاج:

1. أنشِئ تعديلاً، كما هو موضَّح في القسم تعديل سير العمل.

2. حمِّل حزمة APK جديدة للتعديل، باستخدام طريقة Edits.apks: upload.

3. بدء إصدار مرحلي من "inProgress" على قناة الإصدار باستخدام طريقة Edits.tracks: update. اختر قسمًا من المستخدمين الذين ينبغي أن يتلقوا حزمة APK الجديدة. في الوقت الحالي، لا تزال حزمة APK غير متاحة لأي مستخدم نهائي.

   {
   "releases": [{
     "versionCodes": ["99"],
     "userFraction": 0.05,
     "status": "inProgress"
   }]
   }
   

4. نفِّذ التغييرات في التعديل النشط من خلال استدعاء Edits: mit. خلال الساعات القليلة القادمة، سيتم طرح ملف APK الجديد للمستخدمين. وسيتلقى الجزء من المستخدمين الذي تحدده ملف APK الجديد.

وبناءً على نجاح الطرح المرحلي، يمكنك بعد ذلك زيادة النسبة المئوية للمستخدمين المؤهّلين لذلك الإصدار أو إيقاف الإصدار.

زيادة كسر المستخدم للطرح المرحلي

إذا افترضنا أنّ لديك عملية طرح على مراحل بنسبة 5%، كما هو موضّح في القسم السابق، يوضّح هذا القسم طريقة زيادة النسبة المئوية في حال نجاح الإصدار:

1. أنشِئ تعديلاً، كما هو موضَّح في القسم تعديل سير العمل.

2. غيِّر الإصدار المرحلي "inProgress" على قناة الإصدار باستخدام طريقة Edits.tracks: update. زيادة نسبة المستخدمين الذين ينبغي أن يتلقوا حزمة APK الجديدة:

   {
   "releases": [{
     "versionCodes": ["99"],
     "userFraction": 0.1,
     "status": "inProgress"
   }]
   }
   

3. نفِّذ التغييرات في التعديل النشط من خلال استدعاء Edits: mit. خلال الساعات القليلة القادمة، سيتم طرح ملف APK الجديد للمستخدمين. وسيتلقى الجزء من المستخدمين الذي تحدده ملف APK الجديد.

تعليق الطرح على مراحل

إذا افترضنا أنّ لديك عملية طرح على مراحل بنسبة 5%، كما هو موضّح في القسم السابق، يصف هذا القسم كيفية إيقاف الطرح على مراحل في حال اكتشاف مشكلة:

1. أنشِئ تعديلاً، كما هو موضَّح في القسم تعديل سير العمل.

2. غيِّر الإصدار المرحلي "inProgress" على قناة الإصدار باستخدام طريقة Edits.tracks: update. اضبط الحالة على "halted".

   {
   "releases": [{
     "versionCodes": ["99"],
     "status": "halted"
   }]
   }
   

3. نفِّذ التغييرات في التعديل النشط من خلال استدعاء Edits: mit. لن يكون إصدارك متاحًا بعد الآن للمستخدمين الجدد.

إذا قرّرت لاحقًا استئناف عملية تعليق إصدار التطبيق المتوقف، يمكنك إجراء ذلك من خلال إعادة ضبط حالته على "inProgress".

إكمال الطرح على مراحل

بعد أن تكون راضيًا عن الطرح على مراحل وترغب في طرح الإصدار لـ 100% من المستخدمين، يمكنك ضبط حالة الإصدار على "completed":

1. أنشِئ تعديلاً، كما هو موضَّح في القسم تعديل سير العمل.

2. غيِّر الإصدار المرحلي "inProgress" على قناة الإصدار باستخدام طريقة Edits.tracks: update. اضبط الحالة على "halted".

   {
   "releases": [{
     "versionCodes": ["99"],
     "status": "completed"
   }]
   }
   

3. نفِّذ التغييرات في التعديل النشط من خلال استدعاء Edits: mit. خلال الساعات القليلة القادمة، سيتم طرح ملف APK الجديد للمستخدمين. وسيتلقى الجزء من المستخدمين الذي تحدده ملف APK الجديد.

مسودات الإصدارات

تتيح لك مسودات الإصدارات تحميل ملفات APK تلقائيًا وإنشاء إصدار عبر واجهة برمجة التطبيقات الذي يمكن نشره لاحقًا عبر Google Play Console. لإنشاء إصدار مسودة على مسار:

1. افتح تعديلاً جديدًا، كما هو موضّح في القسم Edit Workflow.
2. استدع طريقة Edits.apks: upload لكل ملف APK تريد تحميله. تمرير ملف APK في نص طلب الطريقة تعرض الطريقة رمز إصدار لكل ملف APK تحمّله؛ وستستخدم رمز الإصدار هذا للإشارة إلى ملف APK عند تعيينه لإصدار ما.

3. استدعِ الطريقة Edits.tracks: update لكل مقطع صوتي تريد نشره. في نص الطلب، مرِّر مورد Edits.tracks الذي يحتوي على الإصدار التمهيدي الذي تريد إنشاءه. على سبيل المثال:

   {
   "releases": [{
     "name": "My draft release",
     "versionCodes": ["88"],
     "status": "draft"
   }]
   }
   

4. استدعاء طريقة التعديلات: تنفيذ لتنفيذ التغييرات. يمكن الآن فحص إصدار المسودة وطرحه عبر Google Play Console أو واجهة برمجة التطبيقات.

تحديد ملاحظات الإصدار

عند طرح إصدار جديد من تطبيقك، يمكنك تسليط الضوء على الميزات الجديدة للمستخدمين من خلال تحديد ملاحظات الإصدار في إصدارك.

لإجراء ذلك، استخدم الحقل "releaseNotes" عند توفير مورد Edits.tracks إلى طريقة Edits.tracks: update.

{
  "releases": [{
      "name": "Release with notes",
      "versionCodes": ["88"],
      "status": "completed",
      "releaseNotes": [
        {"language": "en-US", "text": "Describe what's new in this release."}
      ]
  }]
}