يقدم هذا المستند أفضل الممارسات لاستخدام Firebase App Distribution و fastlane لجعل مهام سير عمل الاختبار المسبق لنظام Apple الأساسي مستدامة وقابلة للتكرار في بيئة CI / CD. بينما يركز هذا المستند على المسار السريع ، فإننا نصف أيضًا الحلول المتاحة من خلال وحدة تحكم Firebase و Firebase CLI وواجهة برمجة تطبيقات Firebase App Distribution العامة لمنحك المزيد من المرونة. نصف أيضًا حدود الإصدار والمختبِر حتى تتمكن من التخطيط مسبقًا للحصول على تجربة مثالية.
إذا كنت تستخدم Android أيضًا ، فراجع أفضل الممارسات لتوزيع تطبيقات Android على مختبري ضمان الجودة باستخدام CI / CD .
قبل ان تبدأ
قبل تنفيذ أفضل الممارسات في هذا المستند ، تأكد من تمكين توزيع التطبيقات في وحدة تحكم Firebase لكل تطبيق . إذا لم تقم بتمكين توزيع التطبيق ، فستتلقى خطأ 404.
لتمكين توزيع التطبيق ، اتبع الخطوات التالية:
افتح صفحة توزيع التطبيق في وحدة تحكم Firebase.
حدد تطبيق iOS الخاص بك.
انقر فوق البدء .
قم بأتمتة سير عمل اختبار ما قبل الإصدار باستخدام CI / CD
إذا كنت تريد أتمتة إنشاء التطبيقات وإصدارها للمختبرين لديك وكنت تستخدم CI / CD ، فنحن نوصيك باستخدام Fastlane . هناك خيار آخر وهو استخدام Firebase CLI ، والذي يتيح لك الوصول إلى مجموعة واسعة من منتجات Firebase.
استخدم الخط السريع
ادمج توزيع التطبيقات في خط أنابيب CI / CD باستخدام fastlane ، وهي أداة مفتوحة المصدر تعمل على إنشاء تطبيقات iOS و Android وإصدارها تلقائيًا. من خلال إنشاء أحدث إصداراتك وتوزيعها على المختبرين تلقائيًا ، فإنك تضمن دائمًا حصول المختبرين على أحدث إصدار تجريبي من تطبيقك.
لمعرفة كيفية تكامل توزيع التطبيقات مع المسار السريع ، راجع توزيع تطبيقات iOS على المختبرين باستخدام المسار السريع . راجع أيضًا مختبر الرموز الذي يرشدك خلال عملية التكامل السريع.
استخدم Firebase CLI
استخدم أدوات Firebase CLI التي يوفرها App Distribution لتوزيع الإصدارات على المختبرين برمجيًا. يمكنك تحديد المختبرين وملاحظات الإصدار للبنية.
قم بتوزيع أحدث إصدار من test.ipa لنظام iOS عن طريق تحديد معرف تطبيق 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 لتوزيع التطبيقات أو 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 .
لمعرفة كيفية إعداد إجراء المسار السريع الذي يقوم تلقائيًا بسحب معرفات UDID وإضافتها إلى وحدة تحكم مطوري Apple ، ثم إعادة إنشاء التطبيق وتوزيعه ، راجع توزيع نظام iOS الذي تم إصداره قبل الإصدار بشكل أسرع باستخدام توزيع التطبيقات والمسار السريع .
تمكين المختبرين المحتملين من التسجيل الذاتي للاختبار
لتسهيل توزيع تطبيقك على المزيد من المختبرين ، نوصي باستخدام روابط الدعوة. رابط الدعوة هو عنوان URL فريد يتيح للمختبرين إدخال عناوين بريدهم الإلكتروني للتسجيل لاختبار أحد التطبيقات. يُعد تمكين المستخدمين من إضافة أنفسهم إلى قائمة مختبري التطبيقات طريقة سلسة لزيادة قاعدة الاختبار الداخلية.
تتضمن حالات استخدام ارتباطات الدعوة برامج الشركة التجريبية ، والمؤسسات التي تضم فرقًا كبيرة لضمان الجودة ، ومجموعات المطورين الذين يريدون تمكين العملاء الفرديين من التحكم في وصول المُختبرين.
نوصي بإنشاء ارتباط دعوة لمجموعة. تتم إضافة أي مختبِر يقوم بالتسجيل باستخدام رابط الدعوة تلقائيًا إلى الإصدارات اللاحقة.
لمعرفة المزيد ، راجع إنشاء ارتباطات الدعوة وإضافة المختبرين وإزالتهم من مجموعة .
تأكد من أن المختبرين يختبرون الإصدار الذي تهتم به
عندما يتم تحميل إصدار جديد ، يتم إخطار المختبرين عن طريق البريد الإلكتروني. لتكملة هذا الإشعار ، يمكنك استخدام الميزات التالية - روابط الإصدار والتنبيهات داخل التطبيق - للتأكد من أن المختبرين يختبرون إصدار التطبيق المحدد الذي تهتم به:
إصدار الروابط: استخدم هذه الميزة عندما تريد مشاركة إصدار معين مع المختبرين. لمعرفة كيفية استخدام روابط الإصدار ، راجع توزيع تطبيقات iOS على المختبرين باستخدام وحدة تحكم Firebase . تتوفر هذه الروابط أيضًا مع أدوات سطر أوامر Firebase و fastlane (CLI) الخاصة بنا للاستخدام مع أدوات أتمتة الإنشاء.
التنبيهات داخل التطبيق: استخدم هذه التنبيهات عندما تريد التأكد من أن المختبرين يختبرون أحدث إصدار من تطبيقك. من خلال دمج Firebase App Distribution iOS SDK ، يمكنك عرض التنبيهات مباشرة داخل التطبيق للمختبرين عند توفر إصدارات جديدة من تطبيقك. لمعرفة كيفية إضافة التنبيهات داخل التطبيق ، راجع إعلام المختبرين حول الإنشاءات الجديدة .
إزالة الوصول تلقائيًا للمختبرين الذين يغادرون الشركة
بمجرد تشغيل تدفق الاختبار الداخلي CI / CD الخاص بك ، تحتاج إلى التأكد من أن الأشخاص الذين غادروا الشركة لم يعد بإمكانهم الوصول إلى البنيات الداخلية الخاصة بك. لمساعدتك في إدارة وصول المختبرين إلى الإصدارات ، يوفر توزيع التطبيقات الخيارات التالية:
الخط السريع: استخدم ملف Fastfile الخاص بك أو قم بتشغيل إجراءات Fastlane مباشرةً. لمعرفة المزيد حول استخدام Fastlane لإزالة المختبرين ، راجع توزيع تطبيقات iOS على المختبرين باستخدام المسار السريع .
واجهة برمجة تطبيقات توزيع تطبيقات Firebase العامة: استخدم نقطة نهاية
testers.batchRemove.