أفضل الممارسات لتوزيع تطبيقات Android على مختبِري ضمان الجودة باستخدام CI/CD

يقدّم هذا المستند أفضل الممارسات لاستخدام ميزة "توزيع التطبيقات من Firebase" من أجل المحافظة على استدامة وتكرار خطوات عمل اختبار الإصدارات التجريبية من Android بيئة CI/CD. تتضمن الحلول Gradle وFastlane، ولكن لنمنحك لمزيد من المرونة، نضيف أيضًا الحلول المتاحة من خلال وحدة تحكُّم Firebase وواجهة سطر الأوامر في Firebase وFirebase واجهة برمجة التطبيقات App Distribution سنوضّح أيضًا حدود الإصدارات والمختبِرين لتتمكّن من التخطيط والتقدم للحصول على تجربة مثالية.

في حال استخدام أنظمة Apple الأساسية، يمكنك مراجعة أفضل الممارسات لتوزيع تطبيقات Apple على مختبِري تأكيد الجودة باستخدام CI/CD وFastlane

قبل البدء

قبل تنفيذ أفضل الممارسات في هذا المستند، تأكد من تمكين ميزة "توزيع التطبيقات" في وحدة تحكُّم Firebase لكل تطبيق. إذا لم تكن قد تم تفعيل ميزة App Distribution، وستظهر رسالة الخطأ 404.

لتفعيل ميزة "توزيع التطبيقات"، يُرجى اتّباع الخطوات التالية:

  1. افتح صفحة "توزيع التطبيقات" في وحدة تحكُّم Firebase.
  2. اختَر تطبيق Android.
  3. انقر على البدء.

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

برمجة سير عمل الاختبارات التجريبية من خلال مسار CI/CD

إذا أردت برمجة إنشاء التطبيقات وإصدارها للمختبِرين بشكل آلي باستخدام CI/CD، ننصحك باستخدام Fastlane أو أداة Gradle: يمكنك أيضًا استخدام واجهة سطر الأوامر في Firebase التي تتيح لك الوصول إلى مجموعة كبيرة من منتجات Firebase.

استخدام الخط السريع

دمج App Distribution في مسار CI/CD باستخدام Fastlane، وهو برنامج مفتوح المصدر تعمل على إنشاء تطبيقات iOS وAndroid وتشغيلها تلقائيًا. عن طريق البناء وتوزيع أحدث إصداراتك على المختبرين تلقائيًا، تضمن ويحصل المختبِرون دائمًا على أحدث إصدار تجريبي من تطبيقك.

لمعرفة كيفية دمج App Distribution مع Fastlane، اطّلِع على توزيع تطبيقات Android على المختبِرين باستخدام Fastlane.

استخدام Gradle

استخدم Gradle لدمج App Distribution في عملية إصدار Android باستخدام المكوّن الإضافي لنظام 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.

استخدام بيانات اعتماد الخدمة للمصادقة

استخدم المكوّن الإضافي Fastlane لتوزيع التطبيقات ومكوّن Gradle الإضافي، أو واجهة سطر الأوامر في Firebase من خلال حسابات الخدمة حساب خدمة هو نوع من حسابات Google يمثّل التطبيقات (على عكس المستخدمين). يمكن لنظام CI الخاص بك استخدام حسابات الخدمة لتشغيل أحمال عمل "توزيع التطبيقات". لمزيد من المعلومات، يُرجى الاطّلاع على المصادقة باستخدام حساب خدمة.

إذا كنت تستخدم ميزة توحيد أحمال العمل، يمكنك إنشاء واستخدام ملف إعداد بيانات الاعتماد بدلاً من مفتاح حساب الخدمة.

مراعاة حدود الإصدار

تتيح ميزة "توزيع التطبيقات" إتاحة 1,000 إصدار كحد أقصى لكل تطبيق. هذا يعني أنّ عند تجاوز حدّ الإصدار، تحذف ميزة App Distribution تلقائيًا الإصدارات الأقدم من الحد المسموح به. للتعرّف على كيفية إدارة الحدود القصوى للإصدار، يُرجى الاطّلاع على ما مدة توفُّر إصدارات التطبيق؟

إضافة المجموعة نفسها من المختبِرين إلى إصدارات متعددة

إذا أردت إضافة عدد كبير من المختبِرين إلى إصداراتك، استخدِم وظيفة إدارة المختبرين المجمّعين في App Distribution

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

إذا كان لديك عدد كبير من المختبِرين المطلوب إدارتهم، يمكنك إضافة المختبِرين وحذفهم بشكل مجمّع. باستخدام وحدة تحكُّم Firebase. لإضافة المختبِرين وإزالتهم بشكل مبرمَج، استخدِم واجهة سطر الأوامر في Firebase الخط السريع، Gradle، أو واجهة برمجة التطبيقات العامة لـ Firebase App Distribution.

ضَع في اعتبارك الحدود القصوى للمختبِرين

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

السماح للمختبِرين المحتملين بالتسجيل الذاتي للاختبار

لتسهيل توزيع تطبيقك على المزيد من المختبِرين، ننصحك بما يلي: استخدام روابط الدعوة رابط الدعوة هو عنوان URL فريد يتيح للمختبِرين إدخال عناوين بريدهم الإلكتروني للاشتراك لاختبار أحد التطبيقات. تمكين المستخدمين من الإضافة إلى قائمة مختبِري التطبيق طريقة سلسة لزيادة قاعدة اختبار داخلية.

تتضمن حالات استخدام روابط الدعوة برامج التطبيقات التجريبية للشركات والمؤسسات التي تضم وفرق ضمان الجودة الكبيرة ومجموعات المطورين التي تريد أن يتمكن العملاء الفرديين من والتحكم في وصول المختبِرين.

ننصحك بإنشاء رابط دعوة لمجموعة. أي مختبِر يوقّع على تتم إضافة رابط الدعوة تلقائيًا إلى الإصدارات اللاحقة.

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

تأكَّد من أنّ المختبِرين يختبرون الإصدار الذي يهمّك.

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

  • روابط الإصدارات: يمكنك استخدام هذه الميزة إذا أردت مشاركة إصدار محدّد مع مختبرين. لمعرفة كيفية استخدام روابط الإصدار، راجع توزيع تطبيقات Android على المختبِرين باستخدام وحدة تحكُّم Firebase. هذه الروابط أيضًا المتوفّرة مع Firebase الممر السريع أداة Gradle سطر الأوامر (CLI) للاستخدام مع أدوات إنشاء البرمجيات آليًا.
  • التنبيهات داخل التطبيق: استخدم هذه التنبيهات عندما تريد التأكد من أن يختبر المختبِرون أحدث إصدار من تطبيقك. من خلال دمج حزمة تطوير البرامج (SDK) الخاصة بـ Firebase App Distribution لنظام التشغيل Android، يمكنك عرض التنبيهات مباشرةً داخل التطبيق إلى المختبِرين عند توفر إصدارات جديدة من تطبيقك. للتعلّم طريقة إضافة التنبيهات داخل التطبيق، يُرجى الاطّلاع على إبلاغ المختبِرين بالإصدارات الجديدة

الإزالة التلقائية لإذن وصول المختبِرين الذين يغادرون الشركة

عند بدء مسار الاختبار الداخلي CI/CD، عليك التأكّد من بحيث لا يتمكن الأشخاص الذين يتركون الشركة من الوصول إلى حسابات الإصدارات. ولمساعدتك في إدارة إمكانية وصول المختبِرين إلى الإصدارات، توفِّر ميزة App Distribution الخيارات التالية: