توزيع تطبيقات Android على المختبِرين باستخدام "وحدة تحكُّم Firebase"

يوضّح هذا الدليل كيفية تحميل "مجموعات حزمات تطبيق Android"‏ (AAB) إلى App Distribution وتوزيع حِزم APK التي تم إنشاؤها باستخدام وحدة تحكّم Firebase.

تتكامل أداة App Distribution مع خدمة مشاركة التطبيقات مع الفريق الداخلي في Google Play لمعالجة ملفات AAB التي تحمّلها وتقديم حِزم APK محسّنة للتوافق مع إعدادات أجهزة المختبرِين لديك. يتيح لك توزيع ملفات بتنسيق AAB إجراء ما يلي:

• تشغيل حِزم APK المحسّنة (التي يوفّرها Google Play) والمتوافقة مع أجهزة المختبِرين

• اكتشاف المشاكل المتعلّقة بأجهزة معيّنة وتصحيحها

• اختبِر ميزات حِزم التطبيقات، مثل عرض الميزات في Play وعرض المواد في Play.

• تقليل حجم عمليات التنزيل للمختبِرين

الأذونات المطلوبة

لتحميل حِزم AAB إلى "App Distribution"، عليك ربط تطبيق Firebase بتطبيق في "Google Play". يجب أن يكون لديك مستوى الوصول المطلوب لتنفيذ هذه الإجراءات.

إذا لم يكن لديك إذن الوصول اللازم إلى Firebase، يمكنك أن تطلب من مالك مشروع Firebase منحك الدور المناسب باستخدام إعدادات إدارة الهوية وإمكانية الوصول في وحدة تحكّم Firebase. إذا كانت لديك أسئلة حول الوصول إلى مشروعك على Firebase، بما في ذلك العثور على مالك أو تعيينه، يُرجى مراجعة الأسئلة الشائعة حول "الأذونات والوصول إلى مشاريع Firebase".

ينطبق الجدول التالي على ربط تطبيق Firebase بتطبيق في Google Play، بالإضافة إلى تحميل حِزمات تطبيق Android‏ (AAB).

الإجراء في وحدة تحكّم "Firebase"	إذن "إدارة الهوية وإمكانية الوصول" المطلوب	أدوار "إدارة الهوية وإمكانية الوصول" التي تتضمّن الأذونات المطلوبة تلقائيًا	الأدوار الإضافية المطلوبة
ربط تطبيق Firebase بتطبيق في Google Play	firebase.playLinks.update	أحد الأدوار التالية: المالك مشرف Firebase	الوصول إلى حساب مطوِّر على Google Play بصفتك مشرفًا
تحميل ملفات بتنسيق AAB إلى App Distribution	firebaseappdistro.releases.update	أحد الأدوار التالية: المالك محرِّر مشرف Firebase مشرف الجودة في Firebase مشرف Firebase App Distribution	––

قبل البدء

1. أضِف Firebase إلى مشروع Android الخاص بك، في حال لم يسبق لك إجراء ذلك. في نهاية سير العمل هذا، سيكون لديك تطبيق Android على Firebase في مشروع Firebase.

   إذا لم تكن تستخدم أي منتجات أخرى من Firebase، ما عليك سوى إنشاء مشروع وتسجيل تطبيقك. وإذا قررت استخدام منتجات إضافية، تأكَّد من إكمال جميع الخطوات الواردة في مقالة إضافة Firebase إلى مشروع Android.

2. افتح صفحة App Distribution في وحدة تحكّم Firebase. اختَر مشروع Firebase عندما يُطلب منك ذلك، ثم اختَر تطبيقك باستخدام التبديل بين التطبيقات، وانقر على البدء.

3. لإنشاء رابط Firebase يؤدي إلى Google Play وتحميل حِزمات تطبيق Android، تأكَّد من أنّ تطبيقك يستوفي المتطلبات التالية:

   • تم تسجيل كل من التطبيق في Google Play وتطبيق Firebase المتوافق مع Android باستخدام اسم الحزمة نفسه.

   • التطبيق في Google Play مُعدّ على لوحة بيانات التطبيق وموزّع على أحد مسارات Google Play (الاختبار الداخلي أو الاختبار المغلق أو الاختبار المفتوح أو قناة الإصدار العلني).

   • اكتملت مراجعة التطبيق في Google Play وتم نشره. يتم نشر تطبيقك إذا كان عمود حالة التطبيق يعرض إحدى الحالات التالية: "اختبار داخلي" (وليس "اختبار داخلي لمسوّدة") أو "اختبار مغلق" أو "اختبار مفتوح" أو "إصدار".

4. ربط تطبيق Android على Firebase بحساب المطوِّر على Google Play:

   1. في وحدة تحكّم Firebase، انتقِل إلى settings إعدادات المشروع، ثم اختَر علامة التبويب عمليات الدمج.

   2. في بطاقة Google Play، انقر على ربط.
      إذا كان لديك روابط تؤدي إلى Google Play، انقر على إدارة بدلاً من ذلك.

   3. اتّبِع التعليمات الظاهرة على الشاشة لتفعيل عملية دمج App Distribution واختَر تطبيقات Android على Firebase التي تريد ربطها بـ Google Play.

   مزيد من المعلومات حول الربط بـ Google Play

الخطوة 1: إنشاء تطبيقك

عندما تكون مستعدًا لتوزيع إصدار تجريبي من تطبيقك على المختبِرين، أنشئ حزمة تطبيق Android (انتقِل إلى مستندات Android Studio للحصول على التعليمات).

الخطوة 2: توزيع تطبيقك على المختبِرين

لتوزيع تطبيقك على المختبِرين، حمِّل ملف AAB باستخدام وحدة تحكّم "Firebase":

1. افتح صفحة App Distribution في وحدة تحكّم Firebase. اختَر مشروع Firebase عندما يُطلب منك ذلك.

2. في صفحة الإصدارات، اختَر التطبيق الذي تريد توزيعه من القائمة المنسدلة.

3. اسحب ملف AAB الخاص بتطبيقك إلى وحدة التحكّم لتحميله.

4. عند اكتمال التحميل، حدِّد مجموعات المختبِرين والمختبِرين الفرديين الذين تريد أن يتلقّوا الإصدار. بعد ذلك، أضِف ملاحظات الإصدار الخاصة بالإصدار.

   يمكنك الاطّلاع على مقالة إدارة المختبِرين لمزيد من المعلومات حول إنشاء مجموعات المختبِرين.

5. انقر على توزيع لإتاحة الإصدار للمختبِرين. يتلقّى المختبِر تلقائيًا دعوة عبر البريد الإلكتروني لاختبار التطبيق.

6. (اختياري) لمشاركة روابط لإصدارات محدّدة مع المختبِرين الذين لديهم إذن الوصول إلى هذه الإصدارات، انقر على رمز الرابط لنسخ رابط الإصدار إلى الحافظة.

بعد توزيع الإصدار، يصبح متاحًا في لوحة بيانات App Distribution ضمن وحدة تحكّم Firebase لمدة 150 يومًا (خمسة أشهر). عندما يتبقى 30 يومًا على انتهاء صلاحية الإصدار، سيظهر إشعار بانتهاء الصلاحية في كل من وحدة التحكّم وقائمة الإصدارات الخاصة بالمختبِر على جهازه الاختباري.

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

أمام المختبِرين 30 يومًا لقبول دعوة اختبار التطبيق قبل انتهاء صلاحيتها. عندما يتبقى 5 أيام على انتهاء صلاحية الدعوة، يظهر إشعار بانتهاء الصلاحية في "وحدة تحكّم Firebase" بجانب اسم المختبِر في الإصدار. يمكن تجديد الدعوة من خلال إعادة إرسالها باستخدام القائمة المنسدلة في صف المختبِر.

الخطوات التالية

• يمكنك تنفيذ الملاحظات داخل التطبيق لتسهيل إرسال الملاحظات على المختبِرين بشأن تطبيقك (بما في ذلك لقطات الشاشة).

• تعرَّف على كيفية عرض تنبيهات داخل التطبيق للمختبِرين عندما تتوفّر إصدارات جديدة من تطبيقك للتثبيت.

• تعرَّف على أفضل الممارسات لتوزيع تطبيقات Android على مختبِري تأكيد الجودة باستخدام CI/CD.