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

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

إذا كنت تستخدم أنظمة Apple الأساسية أيضًا، فراجع أفضل الممارسات لتوزيع تطبيقات Apple على مختبري ضمان الجودة باستخدام CI/CD وfastlane .

قبل ان تبدأ

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

لتمكين توزيع التطبيقات، اتبع الخطوات التالية:

  1. افتح صفحة توزيع التطبيقات في وحدة تحكم Firebase.
  2. حدد تطبيق أندرويد الخاص بك.
  3. انقر فوق البدء .

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

قم بأتمتة سير عمل اختبار ما قبل الإصدار باستخدام مسار CI/CD

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

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

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

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

استخدم غرادل

استخدم Gradle لدمج توزيع التطبيقات في عملية بناء Android لديك باستخدام المكوّن الإضافي App Distribution 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 App Distribution أو البرنامج الإضافي Gradle أو Firebase CLI مع حسابات الخدمة. حساب الخدمة هو نوع من حسابات Google الذي يمثل التطبيقات (بدلاً من المستخدمين). يمكن لنظام CI الخاص بك استخدام حسابات الخدمة لتشغيل أحمال عمل توزيع التطبيقات لديك. لمعرفة المزيد، راجع المصادقة باستخدام حساب الخدمة .

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

ضع في اعتبارك حدود الإصدار

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

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

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

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

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

ضع في اعتبارك حدود الاختبار

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

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

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

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

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

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

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

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

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

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

عندما يتم تشغيل تدفق الاختبار الداخلي لـ CI/CD، فإنك تحتاج إلى التأكد من أن الأشخاص الذين يغادرون الشركة لم يعد بإمكانهم الوصول إلى إصداراتك الداخلية. لمساعدتك في إدارة وصول المختبرين إلى الإصدارات، توفر App Distribution الخيارات التالية: