يقدم هذا المستند أفضل الممارسات لاستخدام Firebase App Distribution لجعل مهام سير عمل اختبار الإصدار التجريبي من Android مستدامة وقابلة للتكرار في بيئة CI / CD. تشمل الحلول Gradle و fastlane ، ولكن لمنحك المزيد من المرونة ، فإننا نضمن أيضًا الحلول المتاحة من خلال وحدة تحكم Firebase و Firebase CLI وواجهة برمجة تطبيقات Firebase App Distribution العامة. نصف أيضًا حدود الإصدار والمختبِر حتى تتمكن من التخطيط مسبقًا للحصول على تجربة مثالية.
إذا كنت تستخدم أنظمة Apple الأساسية أيضًا ، فراجع أفضل الممارسات لتوزيع تطبيقات Apple على مختبري ضمان الجودة باستخدام CI / CD والمسار السريع .
قبل ان تبدأ
قبل تنفيذ أفضل الممارسات في هذا المستند ، تأكد من تمكين توزيع التطبيقات في وحدة تحكم Firebase لكل تطبيق . إذا لم تقم بتمكين توزيع التطبيق ، فستتلقى خطأ 404.
لتمكين توزيع التطبيق ، اتبع الخطوات التالية:
- افتح صفحة توزيع التطبيق في وحدة تحكم Firebase.
- حدد تطبيق Android الخاص بك.
- انقر فوق البدء .
نظرًا لأن حزم تطبيقات Android (AAB) أصبحت تنسيق حزمة Android الأكثر شيوعًا ، فإننا نوصي بإعداد القدرة على توزيع AABs على المختبرين لديك عن طريق الارتباط بـ Google Play .
قم بأتمتة سير عمل اختبار ما قبل الإصدار باستخدام خط أنابيب CI / CD
إذا كنت ترغب في أتمتة إنشاء التطبيقات وإصدارها للمختبرين لديك وكنت تستخدم CI / CD ، نوصيك باستخدام Fastlane أو Gradle . هناك خيار آخر وهو استخدام Firebase CLI ، والذي يتيح لك الوصول إلى مجموعة واسعة من منتجات Firebase.
استخدم الخط السريع
ادمج توزيع التطبيقات في خط أنابيب CI / CD باستخدام fastlane ، وهي أداة مفتوحة المصدر تعمل على إنشاء تطبيقات iOS و Android وإصدارها تلقائيًا. من خلال إنشاء أحدث إصداراتك وتوزيعها على المختبرين تلقائيًا ، فإنك تضمن دائمًا حصول المختبرين على أحدث إصدار تجريبي من تطبيقك.
لمعرفة كيفية دمج توزيع التطبيقات مع الخط السريع ، راجع توزيع تطبيقات Android على المختبرين باستخدام الخط السريع .
استخدم Gradle
استخدم Gradle لدمج توزيع التطبيقات في عملية إنشاء Android باستخدام البرنامج الإضافي لتوزيع التطبيقات Gradle. يتيح لك المكون الإضافي تحديد المختبرين وملاحظات الإصدار في ملف build.gradle
الخاص بتطبيقك ، والذي يمكّنك من تكوين توزيعات لأنواع بناء ومتغيرات مختلفة لتطبيقك.
لمعرفة كيفية تكامل توزيع التطبيقات مع Gradle ، راجع توزيع تطبيقات Android على المختبرين باستخدام Gradle .
استخدم Firebase CLI
استخدم أدوات Firebase CLI التي يوفرها App Distribution لتوزيع الإصدارات على المختبرين برمجيًا. يمكنك تحديد المختبرين وملاحظات الإصدار للبنية.
قم بتوزيع أحدث إصدار من Android عن طريق تحديد معرف تطبيق Firebase للتطبيق ، وإضافة ملاحظة إصدار وملف يحتوي على رسائل البريد الإلكتروني الخاصة بالمختبرين اختياريًا:
firebase appdistribution:distribute test.aab \
--app 1:1234567890:android:0a1b2c3d4e5f67890 \
--release-notes "Bug fixes and improvements" --testers-file testers.txt
لمعرفة المزيد حول استخدام Firebase CLI لأتمتة إصداراتك ، راجع توزيع تطبيقات Android على المختبرين باستخدام Firebase CLI .
استخدم بيانات اعتماد الخدمة للمصادقة
استخدم المكوِّن الإضافي Fastlane لتوزيع التطبيقات أو المكوِّن الإضافي لـ Gradle أو Firebase CLI مع حسابات الخدمة. حساب الخدمة هو نوع من أنواع حسابات Google يمثل التطبيقات (على عكس المستخدمين). يمكن لنظام CI الخاص بك استخدام حسابات الخدمة لتشغيل أحمال عمل توزيع التطبيقات. لمعرفة المزيد ، راجع المصادقة باستخدام حساب خدمة .
إذا كنت تستخدم اتحاد هوية حمل العمل ، فيمكنك إنشاء واستخدام ملف تكوين بيانات الاعتماد بدلاً من مفتاح حساب الخدمة.
ضع في اعتبارك حدود الإصدار
يدعم توزيع التطبيق 1000 إصدار كحد أقصى لكل تطبيق. هذا يعني أنه عند تجاوز حد الإصدار ، يحذف App Distribution تلقائيًا الإصدارات الأقدم فوق الحد. لمعرفة كيفية إدارة حدود الإصدار ، راجع ما هي مدة توفر إصدارات التطبيق؟
أضف نفس مجموعة المختبرين إلى إصدارات متعددة
إذا كنت ترغب في إضافة عدد كبير من المختبرين إلى إصداراتك ، فاستخدم وظيفة إدارة المختبرين المجمعين في App Distribution.
نوصي باستخدام المجموعات لإضافة نفس المختبرين إلى إصدارات متعددة. تعمل المجموعة كقائمة تحكم في الوصول ؛ عند إزالة أحد المختبرين من مجموعة ، فإنه يفقد الوصول إلى جميع الإصدارات الموزعة على تلك المجموعة. لمعرفة المزيد ، راجع إضافة المختبرين وإزالتهم من مجموعة .
إذا كان لديك الكثير من المختبرين لإدارتهم ، فيمكنك إضافة وحذف المختبرين بشكل مجمّع باستخدام وحدة تحكم Firebase. لأتمتة إضافة المختبرين وإزالتهم ، استخدم Firebase CLI أو fastlane أو Gradle أو Firebase App Distribution API العامة .
ضع في اعتبارك حدود المختبر
يحد توزيع التطبيق من عدد المختبرين الذين يمكنك إضافتهم إلى مشروع Firebase أو مجموعة توزيع التطبيقات. عندما تتجاوز هذه الحدود ، لن تتمكن من توزيع تطبيقك على مختبرين إضافيين. لمعرفة المزيد حول حدود المختبرين ، راجع هل توجد حدود لإضافة المختبرين إلى تطبيقي؟
تمكين المختبرين المحتملين من التسجيل الذاتي للاختبار
لتسهيل توزيع تطبيقك على المزيد من المختبرين ، نوصي باستخدام روابط الدعوة. رابط الدعوة هو عنوان URL فريد يتيح للمختبرين إدخال عناوين بريدهم الإلكتروني للتسجيل لاختبار أحد التطبيقات. يُعد تمكين المستخدمين من إضافة أنفسهم إلى قائمة مختبري التطبيقات طريقة سلسة لزيادة قاعدة الاختبار الداخلية.
تتضمن حالات استخدام ارتباطات الدعوة برامج الشركة التجريبية ، والمؤسسات التي تضم فرقًا كبيرة لضمان الجودة ، ومجموعات المطورين الذين يريدون تمكين العملاء الفرديين من التحكم في وصول المُختبرين.
نوصي بإنشاء ارتباط دعوة لمجموعة. تتم إضافة أي مختبِر يقوم بالتسجيل باستخدام رابط الدعوة تلقائيًا إلى الإصدارات اللاحقة.
لمعرفة المزيد ، راجع إنشاء ارتباطات الدعوة وإضافة المختبرين وإزالتهم من مجموعة .
تأكد من أن المختبرين يختبرون الإصدار الذي تهتم به
عندما يتم تحميل إصدار جديد ، يتم إخطار المختبرين عن طريق البريد الإلكتروني. لتكملة هذا الإشعار ، يمكنك استخدام الميزات التالية - روابط الإصدار والتنبيهات داخل التطبيق - للتأكد من أن المختبرين يختبرون إصدار التطبيق المحدد الذي تهتم به:
- إصدار الروابط: استخدم هذه الميزة عندما تريد مشاركة إصدار معين مع المختبرين. لمعرفة كيفية استخدام روابط الإصدار ، راجع توزيع تطبيقات Android على المختبرين باستخدام وحدة تحكم Firebase . تتوفر هذه الروابط أيضًا مع أدوات سطر أوامر Firebase و fastlane و Gradle (CLI) الخاصة بنا للاستخدام مع أدوات أتمتة الإنشاء.
- التنبيهات داخل التطبيق: استخدم هذه التنبيهات عندما تريد التأكد من أن المختبرين يختبرون أحدث إصدار من تطبيقك. من خلال دمج Firebase App Distribution Android SDK ، يمكنك عرض التنبيهات مباشرة داخل التطبيق للمختبرين عند توفر إصدارات جديدة من تطبيقك. لمعرفة كيفية إضافة التنبيهات داخل التطبيق ، راجع إعلام المختبرين حول الإنشاءات الجديدة .
إزالة الوصول تلقائيًا للمختبرين الذين يغادرون الشركة
عندما يكون تدفق الاختبار الداخلي CI / CD الخاص بك قيد التشغيل ، فأنت بحاجة إلى التأكد من أن الأشخاص الذين غادروا الشركة لم يعد بإمكانهم الوصول إلى البنيات الداخلية الخاصة بك. لمساعدتك في إدارة وصول المختبرين إلى الإصدارات ، يوفر توزيع التطبيقات الخيارات التالية:
- الخط السريع: استخدم ملف Fastfile الخاص بك أو قم بتشغيل إجراءات Fastlane مباشرةً. لمعرفة المزيد ، راجع توزيع تطبيقات Android على المختبرين باستخدام الخط السريع .
- Firebase CLI: استخدم
firebase appdistribution:testers:remove
. لمعرفة المزيد ، راجع توزيع تطبيقات Android على المختبرين باستخدام Firebase CLI . - Gradle: إذا كنت تستخدم Gradle لإزالة المختبرين ، فاجتاز
appDistributionRemoveTesters
مع الوسيطات
و-- PROJECT_NUMBER
في ملف-- EMAILSbuild.gradle
الخاص بك. لمعرفة المزيد ، راجع توزيع تطبيقات Android على المختبرين باستخدام Gradle . - واجهة برمجة تطبيقات توزيع تطبيقات Firebase العامة: استخدم نقطة نهاية
testers.batchRemove
.