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

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

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

قبل ان تبدأ

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

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

  1. افتح صفحة توزيع التطبيقات في وحدة تحكم Firebase.

  2. حدد تطبيق iOS الخاص بك.

  3. انقر فوق البدء .

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

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

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

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

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

استخدم Firebase CLI

استخدم أدوات Firebase CLI التي توفرها 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 CLI لأتمتة إصداراتك، راجع توزيع تطبيقات iOS على المختبرين باستخدام Firebase CLI .

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

استخدم المكون الإضافي Fastlane App Distribution أو Firebase CLI مع حسابات الخدمة، والتي تستفيد من بيانات اعتماد التطبيق الافتراضية وتساعدك على إدارة CI الخاص بك. حساب الخدمة هو نوع من حسابات Google الذي يمثل التطبيقات وليس المستخدمين. يمكن لنظام CI الخاص بك استخدام حسابات الخدمة لتشغيل أحمال عمل توزيع التطبيقات لديك. لمعرفة المزيد، راجع المصادقة باستخدام حساب الخدمة .

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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