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

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

إذا كنت تستخدم Android أيضًا، اطّلِع على أفضل الممارسات لتوزيع تطبيقات Android على مختبِري ضمان الجودة باستخدام عملية التكامل المستمر/التسليم المستمر.

قبل البدء

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

لتفعيل App Distribution، يُرجى اتّباع الخطوات التالية:

  1. افتح صفحة App Distribution في وحدة تحكّم Firebase.

  2. اختَر تطبيق iOS.

  3. انقر على البدء.

تنفيذ مهام سير عمل اختبار الإصدارات التجريبية تلقائيًا باستخدام CI/CD

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

استخدام fastlane

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

للتعرّف على كيفية دمج App Distribution مع fastlane، يمكنك الاطّلاع على مقالة توزيع تطبيقات iOS على المختبِرين باستخدام fastlane. يمكنك أيضًا الاطّلاع على درس تطبيقي حول الترميز يقدّم لك إرشادات حول عملية دمج fastlane.

استخدام واجهة سطر الأوامر (CLI) الخاصة بـ "Firebase"

استخدِم أدوات سطر الأوامر Firebase التي يوفّرها App Distribution لتوزيع الإصدارات على المختبِرين آليًا. يمكنك تحديد المختبِرين وملاحظات الإصدار لأحد الإصدارات.

وزِّع أحدث إصدار من تطبيق iOS test.ipa من خلال تحديد رقم تعريف التطبيق على Firebase، ويمكنك اختياريًا إضافة ملاحظات حول الإصدار وملف يحتوي على عناوين البريد الإلكتروني للمختبِرين:

firebase appdistribution:distribute test.ipa  \
    --app 1:1234567890:ios:0a1b2c3d4e5f67890  \
    --release-notes "Bug fixes and improvements" --testers-file testers.txt

لمزيد من المعلومات حول استخدام واجهة سطر الأوامر Firebase لأتمتة عمليات الإنشاء، يمكنك الاطّلاع على توزيع تطبيقات iOS على المختبِرين باستخدام واجهة سطر الأوامر Firebase.

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

استخدِم App Distribution إضافة fastlane أو واجهة سطر الأوامر Firebase مع حسابات الخدمة التي تستفيد من بيانات الاعتماد التلقائية للتطبيق وتساعدك في إدارة عملية الدمج المتواصل. حساب الخدمة هو نوع من حسابات Google يمثّل التطبيقات بدلاً من المستخدمين. يمكن لنظام التكامل المستمر استخدام حسابات الخدمة لتشغيل أحمال عمل App Distribution. لمزيد من المعلومات، يُرجى الاطّلاع على المصادقة باستخدام حساب خدمة.

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

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

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

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

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

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

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

مراعاة حدود المختبِرين

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

إدارة أجهزة اختبار iOS الجديدة وإضافتها تلقائيًا

لمساعدتك في تسجيل أجهزة iOS إضافية للاختبار، تساعدك App Distribution في إدارة أجهزة iOS للاختبار في "بوابة مطوّري Apple" من خلال إعلامك بأجهزة iOS الجديدة للاختبار باستخدام البريد الإلكتروني أو ملفات CSV. لمزيد من المعلومات، اطّلِع على استيراد المختبِرين من ملفات CSV. يمكنك أيضًا تصدير الأجهزة الجديدة آليًا باستخدام fastlane.

للتعرّف على كيفية إعداد إجراء fastlane الذي يجلب تلقائيًا أرقام تعريف الأجهزة الفريدة (UDID)، ويضيفها إلى "وحدة تحكّم مطوّري Apple"، ثم يعيد إنشاء التطبيق وتوزيعه، يُرجى الاطّلاع على توزيع إصدارات iOS التجريبية بشكل أسرع باستخدام App Distribution ومنصة fastlane.

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

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

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

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

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

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

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

  • روابط الإصدار: استخدِم هذه الميزة عندما تريد مشاركة إصدار محدّد مع المختبِرين. لمعرفة كيفية استخدام روابط الإصدار، يمكنك الاطّلاع على مقالة توزيع تطبيقات iOS على المختبِرين باستخدام وحدة تحكّم Firebase. تتوفّر هذه الروابط أيضًا مع أدوات سطر الأوامر (CLI) Firebase وfastlane لاستخدامها مع أدوات تشغيل الإصدارات بشكل آلي.

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

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

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