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

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

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

قبل البدء

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

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

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

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

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

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

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

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

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

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

استخدام واجهة سطر الأوامر في 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.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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