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

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

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

1. يمكنك تحميل ملف APK واحد أو أكثر من خلال الاتصال Edits.apks: upload.

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

2. إصدار حِزم APK على "مسارات" من خلال إجراء مكالمة Edits.tracks: تحديث. يمكنك تحرير حِزم APK في المسارات التالية:

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

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

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

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

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

     إصدارات حول "الإنتاج" نشر المسار لجميع المستخدمين. إِنْتَ الاستفادة من إصدارات مرحلية حول "الإنتاج" تتبُّعها بأمان نشر إصدارك أولاً لنسبة صغيرة من مستخدمي الإصدار العلني ثم تزيد هذه النسبة تدريجيًا لتؤكد ثقتك في يكبر الإصدار.

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

اسم المسار لمسارات أشكال الأجهزة

يكون اسم المسار لمسار شكل الجهاز مسبوقًا بمقطع المُعرف.

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

كيف يمكن حساب اسم المسار لمسار شكل جهاز معيّن؟

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

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

يمكن احتساب اسم المسار لمسار شكل جهاز محدّد على النحو التالي: "[prefix]:defaultTrackName" على سبيل المثال، سيتضمّن شكل الجهاز Wear OS قنوات تحمل الاسم التالي: ""wear:production"" و"wear:beta"" و""wear:qa""

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

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

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

1. فتح تعديل جديد، كما هو موضَّح في تعديل سير العمل
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. تنفيذ التغييرات في التعديل النشط من خلال طلب التعديلات: الالتزام خلال الأحداث القليلة القادمة سيتم طرح APK الجديد للمستخدمين. الكسر من المستخدمين الذين تختارهم سيتلقّون حزمة APK الجديدة.

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

زيادة نسبة المستخدمين لعملية الطرح على مراحل

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

الإصدارات التمهيدية

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

1. فتح تعديل جديد، كما هو موضَّح في تعديل سير العمل
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."}
      ]
  }]
}