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

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

قبل ان تبدأ

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

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

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

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

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

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

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

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

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

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

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

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

    A تحديث رمز هذا ما المطبوعة عند مصادقة البيئة 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 و 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 بجوار المُختبِر في الإصدار. يمكن تجديد الدعوة عن طريق إعادة إرسالها باستخدام القائمة المنسدلة في صف المختبر.

الخطوة 3. تسجيل أجهزة إضافية

عندما يقبل المختبرين دعوة لاختبار إصدار غير موقّع باستخدام ملف تعريف Enterprise ، يُطلب منهم إذنًا لمشاركة معرّف أجهزتهم معك. في حالة موافقتهم ، يجمع App Distribution UDID من الجهاز ويعلمك بـ UDID عبر البريد الإلكتروني.

عندما تتلقى إحدى رسائل البريد الإلكتروني هذه ، قم بتحديث ملف التوفير الخاص بك باستخدام UDID وتوزيع تصميم جديد على المختبرين لديك باتباع الخطوات التالية:

  1. أضف الأجهزة إلى بوابة مطوري Apple الخاصة بك.
    • الخيار 1: استيراد UDIDs الجهاز كملف CSV.

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

      لاحظ أن حساب مطور Apple الخاص بك قد يسمح لك فقط باستيراد عدد محدود من الأجهزة سنويًا.

    • الخيار 2: اجمع وأدخل UDIDs عن طريق البريد الإلكتروني.

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

  2. إضافة الأجهزة المسجلة لديك الشخصية المخصصات .
  3. قم بتنزيل ملف التوفير واستخدمه لإعادة إنشاء تطبيقك. إذا كنت تقوم بإعادة البناء فقط لتحديث الأجهزة المسجلة ، فلا تقم بتحديث رقم الإصدار أو الإصدار.
  4. إعادة توزيع التطبيق الخاص بك من وحدة التحكم Firebase أو CLI. إذا كنت قد وزعت بالفعل بنية بنفس رقم الإصدار والإصدار ، فإن مستخدمي الأجهزة المسجلة حديثًا فقط هم الذين يتلقون رسائل إعلام بالبريد الإلكتروني.