يقدّم هذا المستند أفضل الممارسات لاستخدام Firebase App Distribution من أجل المحافظة على استدامة وتكرار خطوات عمل اختبار الإصدارات التجريبية من Android بيئة CI/CD. تتضمن الحلول Gradle وFastlane، ولكن لنمنحك لمزيد من المرونة، نضيف أيضًا الحلول المتاحة من خلال وحدة تحكّم Firebase وواجهة سطر الأوامر Firebase وFirebase المتاحة للجميع واجهة برمجة التطبيقات App Distribution. سنوضّح أيضًا حدود الإصدارات والمختبِرين لتتمكّن من التخطيط والتقدم للحصول على تجربة مثالية.
في حال استخدام أنظمة Apple الأساسية، يمكنك مراجعة أفضل الممارسات لتوزيع تطبيقات Apple على مختبِري تأكيد الجودة باستخدام CI/CD وFastlane
قبل البدء
قبل تنفيذ أفضل الممارسات في هذا المستند، تأكد من تمكين App Distribution في وحدة تحكّم Firebase لكل تطبيق. إذا لم تكن قد تم تفعيل App Distribution، ستظهر لك رسالة الخطأ 404.
لتفعيل ميزة App Distribution، اتّبِع الخطوات التالية:
- افتح صفحة App Distribution في وحدة تحكّم Firebase.
- اختَر تطبيق Android.
- انقر على البدء.
وبما أنّ تنسيق "مجموعة حزمات تطبيق Android" (AAB) أصبح الأكثر شيوعًا ننصح بإعداد إمكانية توزيع AAB على للمختبِرين عبر الرابط إلى Google Play.
برمجة سير عمل الاختبارات التجريبية من خلال مسار CI/CD
إذا أردت برمجة إنشاء التطبيقات وإصدارها للمختبِرين بشكل آلي باستخدام CI/CD، ننصحك باستخدام Fastlane أو أداة Gradle: ويمكنك أيضًا استخدام Firebase CLI التي تتيح لك الوصول إلى مجموعة كبيرة من منتجات Firebase.
استخدام الخط السريع
دمج "App Distribution" في مسار CI/CD باستخدام Fastlane، وهو برنامج مفتوح المصدر تعمل على إنشاء تطبيقات iOS وAndroid وتشغيلها تلقائيًا. عن طريق البناء وتوزيع أحدث إصداراتك على المختبرين تلقائيًا، تضمن ويحصل المختبِرون دائمًا على أحدث إصدار تجريبي من تطبيقك.
للتعرّف على كيفية دمج App Distribution مع Fastlane، اطّلِع على توزيع تطبيقات Android على المختبِرين باستخدام Fastlane.
استخدام Gradle
استخدِم Gradle لدمج App Distribution في عملية تصميم Android باستخدام
App Distribution المكوّن الإضافي لنظام Gradle يتيح لك المكوّن الإضافي تحديد المختبِرين
ملاحظات الإصدار في ملف build.gradle
لتطبيقك، ما يتيح لك إعداد
للأنواع المختلفة من الإصدارات والصيغ الخاصة بتطبيقك.
للتعرّف على كيفية دمج App Distribution مع Gradle، يمكنك الاطّلاع على توزيع تطبيقات Android على المختبِرين باستخدام Gradle.
استخدام واجهة سطر الأوامر Firebase
استخدِم أدوات واجهة سطر الأوامر Firebase التي يوفّرها تطبيق 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 لبرمجة الإصدارات، يمكنك الاطّلاع على يمكنك الاطّلاع على توزيع تطبيقات Android على المختبِرين باستخدام واجهة سطر الأوامر Firebase.
استخدام بيانات اعتماد الخدمة للمصادقة
استخدم App Distribution المكوّن الإضافي الخط السريع، مكوّن Gradle الإضافي، أو واجهة سطر الأوامر Firebase مع حسابات الخدمة. حساب خدمة هو نوع من حسابات Google يمثّل التطبيقات (على عكس المستخدمين). يمكن لنظام CI الخاص بك استخدام حسابات الخدمة لتشغيل أحمال عمل "App Distribution". لمزيد من المعلومات، يُرجى الاطّلاع على المصادقة باستخدام حساب خدمة.
إذا كنت تستخدم ميزة توحيد أحمال العمل، يمكنك إنشاء واستخدام ملف إعداد بيانات الاعتماد بدلاً من مفتاح حساب الخدمة.
مراعاة حدود الإصدار
يتيح App Distribution إنشاء 1,000 إصدار كحد أقصى لكل تطبيق. هذا يعني أنّ عند تجاوز الحدّ الأقصى للإصدار، يحذف App Distribution تلقائيًا الإصدارات الأقدم من الحد المسموح به. للتعرّف على كيفية إدارة الحدود القصوى للإصدار، يُرجى الاطّلاع على ما مدة توفُّر إصدارات التطبيق؟
إضافة المجموعة نفسها من المختبِرين إلى إصدارات متعددة
إذا أردت إضافة عدد كبير من المختبِرين إلى إصداراتك، استخدِم وظيفة إدارة المختبِرين المجمَّعة في App Distribution.
وننصحك باستخدام المجموعات لإضافة المختبِرين أنفسهم إلى إصدارات متعددة. تعمل المجموعة كقائمة تحكُّم بالوصول. عند إزالة مختبِر من مجموعة، يفقدون إمكانية الوصول إلى جميع الإصدارات الموزَّعة على تلك المجموعة. للتعلّم المزيد، يُرجى الاطّلاع على إضافة المختبِرين وإزالتهم من مجموعة.
إذا كان لديك عدد كبير من المختبِرين المطلوب إدارتهم، يمكنك إضافة المختبِرين وحذفهم بشكل مجمّع. باستخدام وحدة تحكُّم Firebase. لإضافة المختبِرين وإزالتهم بشكل مبرمَج، استخدِم Firebase CLI، ممر سريع، Gradle، أو واجهة برمجة التطبيقات App Distribution العامة لمنصة Firebase.
ضَع في اعتبارك الحدود القصوى للمختبِرين
يضع App Distribution قيودًا على عدد المختبِرين الذين يمكنك إضافتهم إلى مشروع على Firebase. أو مجموعة App Distribution. عند تجاوز هذه الحدود، لن تتمكن من وتوزيع تطبيقك على مختبِرين إضافيين. لمزيد من المعلومات عن حدود المختبرين، راجِع هل هناك حدود لعدد مرات إضافة المختبِرين إلى تطبيقي؟
السماح للمختبِرين المحتملين بالتسجيل الذاتي للاختبار
لتسهيل توزيع تطبيقك على المزيد من المختبِرين، ننصحك بما يلي: استخدام روابط الدعوة رابط الدعوة هو عنوان URL فريد يتيح للمختبِرين إدخال عناوين بريدهم الإلكتروني للاشتراك لاختبار أحد التطبيقات. تمكين المستخدمين من الإضافة إلى قائمة مختبِري التطبيق طريقة سلسة لزيادة قاعدة اختبار داخلية.
تتضمن حالات استخدام روابط الدعوة برامج التطبيقات التجريبية للشركات والمؤسسات التي تضم وفرق ضمان الجودة الكبيرة ومجموعات المطورين التي تريد أن يتمكن العملاء الفرديين من والتحكم في وصول المختبِرين.
ننصحك بإنشاء رابط دعوة لمجموعة. أي مختبِر يوقّع عليه تتم إضافة رابط الدعوة تلقائيًا إلى الإصدارات اللاحقة.
لمزيد من المعلومات، يُرجى الاطّلاع على إنشاء روابط الدعوة. وإضافة المختبِرين وإزالتهم من مجموعة.
تأكَّد من أنّ المختبِرين يختبرون الإصدار الذي يهمّك.
عند تحميل إصدار جديد، يتم إشعار المختبِرين عبر البريد الإلكتروني. إلى إضافة إلى هذا الإشعار، يمكنك استخدام الميزات التالية: إصدار والتنبيهات داخل التطبيق، للتأكد من أن المختبِرين يختبرون إصدار تطبيق معين يهمّك:
- روابط الإصدارات: يمكنك استخدام هذه الميزة إذا أردت مشاركة إصدار محدّد مع مختبرين. لمعرفة كيفية استخدام روابط الإصدار، راجع توزيع تطبيقات Android على المختبِرين باستخدام وحدة تحكُّم Firebase. هذه الروابط أيضًا المتوفّرة مع Firebase الممر السريع أداة Gradle سطر الأوامر (CLI) للاستخدام مع أدوات إنشاء البرمجيات آليًا.
- التنبيهات داخل التطبيق: استخدم هذه التنبيهات عندما تريد التأكد من أن يختبر المختبِرون أحدث إصدار من تطبيقك. من خلال دمج حزمة تطوير البرامج (SDK) لنظام التشغيل Android App Distribution لمنصة Firebase، يمكنك عرض التنبيهات مباشرةً داخلها التطبيق إلى المختبِرين عند توفر إصدارات جديدة من تطبيقك. للتعلّم طريقة إضافة التنبيهات داخل التطبيق، يُرجى الاطّلاع على إبلاغ المختبِرين بالإصدارات الجديدة
الإزالة التلقائية لإذن وصول المختبِرين الذين يغادرون الشركة
عند بدء مسار الاختبار الداخلي CI/CD، عليك التأكّد من بحيث لا يتمكن الأشخاص الذين يتركون الشركة من الوصول إلى حسابات الإصدارات. ولمساعدتك في إدارة أذونات وصول المختبِرين إلى الإصدارات، يوفّر App Distribution الخيارات التالية:
- Fastlane: يمكنك استخدام ملف Fastfile أو تنفيذ إجراءات Fastlane مباشرةً. إلى لمزيد من المعلومات، يمكنك الاطّلاع على توزيع تطبيقات Android على المختبِرين باستخدام Fastlane.
- Firebase واجهة سطر الأوامر: استخدِم
firebase appdistribution:testers:remove
اتخاذ القرار. لمزيد من المعلومات، يمكنك الاطّلاع على توزيع تطبيقات Android على المختبِرين باستخدام واجهة سطر الأوامر Firebase. - Gradle: إذا كنت تستخدم Gradle لإزالة المختبِرين، فاجتياز
appDistributionRemoveTesters
مع الوسيطات
و--PROJECT_NUMBER
في ملف--EMAILS build.gradle
. لمزيد من المعلومات، يُرجى مراجعة توزيع تطبيقات Android على المختبِرين باستخدام Gradle. - واجهة برمجة التطبيقات App Distribution من Firebase المتاحة للجميع:
استخدِم نقطة نهاية
testers.batchRemove
.