توزيع تطبيقات 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، بالإضافة إلى تحميل حِزم AAB.

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

قبل البدء

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

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

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

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

   • تم إعداد التطبيق على لوحة بيانات التطبيق على 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: إنشاء تطبيقك

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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