يوضّح هذا الدليل كيفية تحميل "مجموعات حزمات تطبيق Android" (AAB) إلى App Distribution وتوزيع حِزم APK التي تم إنشاؤها باستخدام Firebase console.
تتكامل App Distribution مع خدمة مشاركة التطبيقات مع الفريق الداخلي في Google Play لمعالجة تنسيقات AAB التي تحمّلونها وعرض حِزم APK المحسّنة لتتوافق مع إعدادات أجهزة المختبِرين. يتيح لكم توزيع "مجموعات حزمات تطبيق Android" إجراء ما يلي:
تشغيل حِزم APK المحسّنة (التي يعرضها Google Play) والمحسّنة لتتوافق مع أجهزة المختبِرين
اكتشاف المشاكل الخاصة بالأجهزة وتصحيحها
اختبار ميزات "مجموعة حزمات التطبيق"، مثل عرض الميزات في Play وعرض المواد في Play.
تقليل حجم التنزيلات للمختبِرين
الأذونات المطلوبة
لتحميل "مجموعات حزمات تطبيق Android" إلى App Distribution، يجب ربط تطبيق Firebase بتطبيق في Google Play. يجب أن يكون لديكم مستوى الوصول المطلوب لتنفيذ هذه الإجراءات.
إذا لم يكن لديكم إذن الوصول اللازم إلى Firebase، يمكنكم أن تطلبوا من مالك مشروع Firebase منحكم الدور المناسب باستخدام Firebaseإعدادات إدارة الهوية وإمكانية الوصول في "وحدة تحكّم Firebase". إذا كانت لديكم أسئلة حول الوصول إلى مشروعكم على Firebase، بما في ذلك العثور على مالك أو إسناده، يُرجى مراجعة الأسئلة الشائعة حول الأذونات والوصول إلى مشاريع Firebase.
ينطبق الجدول التالي على ربط تطبيق Firebase بتطبيق في Google Play، بالإضافة إلى تحميل "مجموعات حزمات تطبيق Android".
| الإجراء في Firebase وحدة التحكّم | إذن "إدارة الهوية وإمكانية الوصول" المطلوب | أدوار "إدارة الهوية وإمكانية الوصول" التي تتضمّن الأذونات المطلوبة تلقائيًا | الأدوار الإضافية المطلوبة |
|---|---|---|---|
| ربط تطبيق Firebase بتطبيق في Google Play | firebase.playLinks.update
|
أحد الأدوار التالية: | إذن الوصول إلى حساب مطوّر Google Play بصفتكم مشرفًا |
| تحميل "مجموعات حزمات تطبيق Android" إلى App Distribution | firebaseappdistro.releases.update
|
أحد الأدوار التالية: | –– |
قبل البدء
إذا لم يسبق لكم ذلك، أضيفوا Firebase إلى مشروعكم على Android project. في نهاية سير العمل هذا، سيكون لديكم تطبيق Android على Firebase في مشروع Firebase.
إذا كنتم لا تستخدمون أي منتجات أخرى من Firebase، ما عليكم سوى إنشاء مشروع وتسجيل تطبيقكم. أما إذا قررتم استخدام منتجات إضافية، احرصوا على إكمال جميع الخطوات في إضافة Firebase إلى مشروع Android.
افتحوا App Distribution صفحة من Firebase "وحدة التحكّم". اختاروا مشروع Firebase عندما يُطلب منكم ذلك، واختاروا تطبيقكم باستخدام أداة تبديل التطبيقات، ثم انقروا على البدء.
لإنشاء رابط Firebase إلى Google Play وتحميل "مجموعات حزمات تطبيق Android"، تأكّدوا من استيفاء تطبيقكم للمتطلبات التالية:
تم تسجيل التطبيق في Google Play وتطبيق Android على Firebase باستخدام اسم الحزمة نفسه.
تم إعداد التطبيق في Google Play على لوحة بيانات التطبيق وتم توزيعه على إحدى قنوات الإصدار في Google Play (الاختبار الداخلي أو الاختبار المغلق أو الاختبار المفتوح أو الإصدار العلني).
اكتملت مراجعة التطبيق في Google Play وتم نشره. يتم نشر تطبيقكم إذا كانت إحدى الحالات التالية تظهر في عمود حالة التطبيق: الاختبار الداخلي (وليس اختبارًا داخليًا لمسوّدة) أو الاختبار المغلق أو الاختبار المفتوح أو الإصدار العلني.
اربطوا تطبيق Android على Firebase بحساب المطوّر على Google Play:
في Firebase، انتقِلوا إلى
إعدادات المشروع ، ثم اختاروا علامة التبويب عمليات الدمج.في بطاقة Google Play ، انقروا على ربط.
إذا كانت لديكم روابط حالية إلى Google Play، انقروا على إدارة بدلاً من ذلك.اتّبِعوا التعليمات الظاهرة على الشاشة لتفعيل عملية التكامل مع ميزة App Distribution واختاروا تطبيقات Android على Firebase التي تريدون ربطها بـ Google Play.
مزيد من المعلومات حول الربط بـ Google Play.
الخطوة 1: إنشاء تطبيقكم
عندما يصبح بإمكانكم توزيع إصدار تجريبي من تطبيقكم على المختبِرين، أنشئوا تنسيق AAB (يمكنكم الاطّلاع على مستندات "استوديو Android" للحصول على التعليمات).
الخطوة 2: توزيع تطبيقكم على المختبِرين
لتوزيع تطبيقك على المختبِرين، حمِّل ملف تنسيق AAB باستخدام الـ Firebase وحدة تحكّم:
افتحوا App Distribution صفحة من Firebase "وحدة التحكّم". اختاروا مشروع Firebase عندما يُطلب منكم ذلك.
في صفحة الإصدارات ، اختاروا التطبيق الذي تريدون توزيعه من القائمة المنسدلة.
اسحب ملف تنسيق AAB لتطبيقك إلى وحدة التحكّم لتحميله.
عند اكتمال التحميل، حدِّدوا مجموعات المختبِرين والمختبِرين الفرديين الذين تريدون أن يتلقوا الإصدار. بعد ذلك، أضيفوا ملاحظات الإصدار للإصدار.
يمكنكم الاطّلاع على مقالة إدارة المختبِرين لمزيد من المعلومات حول إنشاء مجموعات المختبِرين.
انقروا على توزيع لإتاحة الإصدار للمختبِرين. يتلقّى المختبِر تلقائيًا دعوة عبر البريد الإلكتروني لاختبار التطبيق.
(اختياري) لمشاركة روابط لإصدارات معيّنة مع المختبِرين الذين يمكنهم الوصول إلى هذه الإصدارات، انقروا على رمز الرابط لنسخ رابط الإصدار إلى الحافظة.
بعد توزيع الإصدار، يصبح متاحًا في لوحة بيانات App Distribution في Firebase لمدة 150 يومًا (خمسة أشهر). عندما يتبقى 30 يومًا على انتهاء صلاحية الإصدار، يظهر إشعار بانتهاء الصلاحية في كلٍّ من "وحدة التحكّم" وقائمة الإصدارات الخاصة بالمختبِر على جهازه التجريبي.
يتلقّى المختبِرون الذين لم تتم دعوتهم لاختبار التطبيق دعوات عبر البريد الإلكتروني للبدء، ويتلقّى المختبِرون الحاليون إشعارات عبر البريد الإلكتروني بأنّ إصدارًا جديدًا أصبح جاهزًا للاختبار. للتعرّف على كيفية تثبيت التطبيق التجريبي، يُرجى الاطّلاع على مقالة الإعداد كمختبِر باستخدام App Distribution. يمكنكم مراقبة حالة كل مختبِر، بما في ذلك ما إذا كان قد قبل الدعوة وما إذا كان قد نزّل التطبيق، في Firebase console.
أمام المختبِرين 30 يومًا لقبول دعوة اختبار التطبيق قبل انتهاء صلاحيتها. عندما يتبقى 5 أيام على انتهاء صلاحية الدعوة، يظهر إشعار بانتهاء الصلاحية في الـ Firebase وحدة تحكّم بجانب المختبِر في إصدار معيّن. يمكن تجديد الدعوة عن طريق إعادة إرسالها باستخدام القائمة المنسدلة في صف المختبِر.
الخطوات التالية
يمكنكم تنفيذ ميزة الملاحظات داخل التطبيق لتسهيل إرسال المختبِرين ملاحظات حول تطبيقكم (بما في ذلك لقطات الشاشة).
تعلَّموا كيفية عرض تنبيهات داخل التطبيق للمختبِرين عندما تتوفّر إصدارات جديدة من تطبيقكم لتثبيتها.
تعلَّموا أفضل الممارسات لـ توزيع تطبيقات Android على المختبِرين المسؤولين عن ضمان الجودة باستخدام التكامل المستمر/التسليم المستمر (CI/CD).