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

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

تتكامل ميزة "توزيع التطبيقات" مع خدمة مشاركة التطبيقات الداخلية في 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 أحد الأدوار التالية: إذن الوصول إلى حساب مطوِّر على Google Play بصفتك مشرفًا
تحميل ملفات AAB إلى ميزة App Distribution firebaseappdistro.releases.update أحد الأدوار التالية: ––

قبل البدء

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

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

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

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

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

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

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

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

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

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

    مزيد من المعلومات عن الربط بخدمة Google Play

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

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

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

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

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

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

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

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

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

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

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

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

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

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

الخطوات اللاحقة