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

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

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

قبل البدء

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

لتفعيل "App Distribution"، اتّبِع الخطوات التالية:

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

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

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

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

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

استخدام fastlane

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

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

استخدام واجهة سطر الأوامر (CLI) في Firebase

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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