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

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

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

• يمكنك تشغيل حِزم APK محسّنة (يعرضها Google Play) ومُحسَّنة لتعمل على أجهزة المختبِرين.

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

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

• يمكنك تقليل حجم الملفات التي يتم تنزيلها من قِبل المختبِرين.

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

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

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

ينطبق الجدول التالي على ربط تطبيق Firebase بتطبيق في Google Play، بالإضافة إلى تحميل حِزم 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. لإنشاء رابط Firebase بمنصّة Google Play وتحميل حِزم APK القابلة للحمل، تأكّد من أنّ تطبيقك يستوفي المتطلبات التالية:

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

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

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

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

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

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

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

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

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

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

الخطوة 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 على مختبِري ضمان الجودة باستخدام ميزة "التكامل والنشر".