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

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

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

قبل البدء

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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