وزع تطبيقات iOS على المختبرين باستخدام Firebase CLI

يمكنك توزيع التصميمات على المختبرين باستخدام Firebase CLI. تتيح لك أداة CLI تحديد المختبرين وملاحظات الإصدار للبنية وتوزيع الإصدار وفقًا لذلك.

قبل ان تبدأ

إذا لم تكن قد قمت بذلك بالفعل ، فأضف Firebase إلى مشروع Apple الخاص بك .

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

الخطوة 1 . بناء التطبيق الخاص بك

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

  • لتوزيع تطبيقك خارج فريق التطوير لديك ، يجب عليك استخدام إما Ad Hoc أو ملف تعريف توزيع Enterprise.
  • إذا كان تطبيقك يستخدم Game Center أو APNs (بالإضافة إلى Cloud Messaging ) أو iCloud ، فتأكد من أن ملف تعريف التوفير الخاص بك يستخدم معرف تطبيق صريحًا وليس معرف بدل.
  • إذا كنت تستخدم ملف تعريف توزيع Ad Hoc ، فقم بتضمين معرفات الأجهزة الفريدة (UDIDs) الخاصة بأجهزة المختبرين. أثناء تسجيل مختبري iOS الجدد في برنامج الاختبار الخاص بك ، ستحتاج إلى تحديث ملف تعريف التوفير باستخدام معرفات UDID الخاصة بأجهزتهم. انظر تسجيل أجهزة اختبار إضافية .
  • لقد قمت بتحديث رقم الإصدار المرئي للمستخدم ( الإصدار ) ورقم البنية الفريد (الإصدار). إذا قمت بإجراء تغييرات على التعليمات البرمجية منذ الإصدار الأخير (أي أنك لا تقوم بإعادة البناء فقط لتحديث الأجهزة المسجلة) ، فلن تحتاج إلى تحديث الإصدار وأرقام البنية.

عند اكتمال البناء ، يحفظ ملف IPA وبعض ملفات السجل في المجلد الذي تحدده. تقوم بتوزيع ملف IPA على المختبرين في الخطوات التالية.

الخطوة الثانية . وزع تطبيقك على المختبرين

لتوزيع تطبيقك على المختبرين ، قم بتحميل ملف IPA باستخدام Firebase CLI:

  1. قم بتثبيت أو تحديث أحدث إصدار من Firebase CLI (نوصي بتنزيل الملف الثنائي المستقل لـ CLI الخاص بنظام التشغيل الخاص بك). تأكد من تسجيل الدخول واختبر أنه يمكنك الوصول إلى مشاريعك.
  2. في صفحة توزيع التطبيق بوحدة تحكم Firebase ، حدد التطبيق الذي تريد توزيعه ، ثم انقر على البدء .

  3. قم بتشغيل appdistribution:distribute الأمر لتحميل تطبيقك وتوزيعه على المختبرين. استخدم المعلمات التالية لتكوين التوزيع:

    appdistribution: توزيع الخيارات
    --app

    مطلوب : معرّف تطبيق Firebase لتطبيقك. يمكنك العثور على معرف التطبيق في وحدة تحكم Firebase ، في صفحة الإعدادات العامة .

    --app 1:1234567890:ios:0a1b2c3d4e5f67890
    --token

    رمز تحديث يُطبع عند مصادقة بيئة CI الخاصة بك باستخدام Firebase CLI (اقرأ استخدام CLI مع أنظمة CI لمزيد من المعلومات).

    --token "$FIREBASE_TOKEN"
    --release-notes
    --release-notes-file

    ملاحظات الإصدار لهذا البناء.

    يمكنك إما تحديد ملاحظات الإصدار مباشرة:

    --release-notes "Text of release notes"

    أو حدد المسار لملف نص عادي:

    --release-notes-file "/path/to/release-notes.txt"
    --testers
    --testers-file

    عناوين البريد الإلكتروني للمختبرين الذين تريد دعوتهم.

    يمكنك تحديد المختبرين كقائمة عناوين بريد إلكتروني مفصولة بفواصل:

    --testers "ali@example.com, bri@example.com, cal@example.com"

    أو يمكنك تحديد المسار إلى ملف نص عادي يحتوي على قائمة مفصولة بفواصل من عناوين البريد الإلكتروني:

    --testers-file "/path/to/testers.txt"
    --groups
    --groups-file

    مجموعات المختبرين التي تريد دعوتها (راجع إدارة المختبرين ). يتم تحديد المجموعات باستخدام مجموعة الأسماء المستعارة ، والتي يمكنك البحث عنها في وحدة تحكم Firebase.

    يمكنك تحديد المجموعات كقائمة مفصولة بفواصل:

    --groups "qa-team, trusted-testers"

    أو يمكنك تحديد المسار إلى ملف نص عادي يحتوي على قائمة مفصولة بفواصل لأسماء المجموعات:

    --groups-file "/path/to/groups.txt"
    --debug

    علامة يمكنك تضمينها لطباعة إخراج السجل المطول.

    فمثلا:

    firebase appdistribution:distribute test.ipa  \
    --app 1:1234567890:ios:0a1b2c3d4e5f67890  \
    --release-notes "Bug fixes and improvements" --testers-file testers.txt

    بالإضافة إلى توزيع الإصدارات ، يمكنك أيضًا استخدام appdistribution:testers:add and appdistribution:testers:remove لدعوة المختبرين الجدد أو إزالة المختبرين الحاليين من مشروع Firebase الخاص بك. بمجرد إضافة أحد المختبرين إلى مشروع Firebase ، يمكنك إضافته إلى الإصدارات الفردية. بمجرد إزالة أحد المختبرين ، لن يعود بإمكانه الوصول إلى الإصدارات في مشروعك. لاحظ أن المختبرين الذين تمت إزالتهم مؤخرًا لا يزالون قادرين على الاحتفاظ بإمكانية الوصول إلى إصداراتك لفترة زمنية.

    فمثلا:

    firebase appdistribution:testers:add anothertester@email.com moretesters@email.com

firebase appdistribution:testers:remove anothertester@email.com moretesters@email.com

    يجب فصل رسائل البريد الإلكتروني الخاصة بالاختبار بمسافة. يمكنك أيضًا تحديد المختبرين باستخدام --file /path/to/testers.txt .

بمجرد توزيع التصميم الخاص بك ، يصبح متاحًا في لوحة معلومات توزيع التطبيقات لوحدة تحكم Firebase لمدة 150 يومًا (خمسة أشهر). عند مرور 30 ​​يومًا على انتهاء صلاحية الإصدار ، يظهر إشعار انتهاء الصلاحية في كل من وحدة التحكم وقائمة البنيات الخاصة بالمختبرين على جهاز الاختبار الخاص بهم.

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

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

الخطوات التالية