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

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

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

1. حمِّل ملف APK واحدًا أو أكثر باستدعاء طريقة Edits.APKs: تحميل.

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

2. إصدار ملفات APK في "track;tracks" عبر طلب Edits.tracks: update. يمكنك إصدار ملفات APK على المسارات التالية:

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

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

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

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

   • قناة الإصدار: "production"

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

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

مثال على سير عمل حزمة APK

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

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 &Roll&"APK{/1} أي مشاكل (مثل حالات التعطّل وما إلى ذلك)، قد تزيد نسبة المستخدمين الذين يستفيدون من هذا الإصدار، وعندما تصبح جاهزًا، يمكنك نشر ملف APK هذا كإصدار جديد للإنتاج.

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

1. أنشئ تعديلاً، كما هو موضّح في مقالة Edit Workflow.

2. حمِّل ملف APK جديدًا إلى التعديل، باستخدام طريقة Edits.APKs: تحميل.

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

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

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

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

زيادة جزء المستخدم لعملية الطرح على مراحل

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

1. أنشئ تعديلاً، كما هو موضّح في مقالة Edit Workflow.

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

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

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

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

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

1. أنشئ تعديلاً، كما هو موضّح في مقالة Edit Workflow.

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

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

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

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

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

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

1. أنشئ تعديلاً، كما هو موضّح في مقالة Edit Workflow.

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

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

3. لتنفيذ التغييرات في التعديل النشط من خلال طلب التعديلات: إتمام. خلال الساعات القليلة القادمة، سيتم طرح حزمة 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 resource إلى طريقة Edits.tracks: update.

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