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

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

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

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

    توزيع التطبيق: خيارات التوزيع
    --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

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

    --test-devices
    --test-devices-file

    تعد أنواع التوزيع التالية جزءًا من ميزة الإصدار التجريبي للاختبار الآلي .

    أجهزة الاختبار التي تريد توزيع الإصدارات عليها (راجع الاختبارات التلقائية ).

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

    --test-devices: "model=shiba,version=34,locale=en,orientation=portrait;model=b0q,version=33,locale=en,orientation=portrait"

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

    --test-devices-file: "/path/to/test-devices.txt"
    --test-username

    اسم المستخدم لتسجيل الدخول التلقائي الذي سيتم استخدامه أثناء الاختبارات الآلية .

    --test-password
    --test-password-file

    كلمة المرور لتسجيل الدخول التلقائي لاستخدامها أثناء الاختبارات الآلية .

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

    --test-password-file: "/path/to/test-password.txt"
    --test-username-resource

    اسم المورد لحقل اسم المستخدم لتسجيل الدخول التلقائي الذي سيتم استخدامه أثناء الاختبارات الآلية .

    --test-password-resource

    اسم المصدر لحقل كلمة المرور لتسجيل الدخول التلقائي الذي سيتم استخدامه أثناء الاختبارات الآلية .

    --test-non-blocking

    تشغيل الاختبارات الآلية بشكل غير متزامن. تفضل بزيارة وحدة تحكم Firebase للحصول على نتائج الاختبار التلقائي.

    على سبيل المثال:

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

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

    • firebase_console_uri - رابط لوحدة تحكم Firebase يعرض إصدارًا واحدًا. يمكنك مشاركة هذا الرابط مع المطورين الآخرين في مؤسستك.
    • testing_uri - رابط للإصدار في تجربة المختبر (مقطع ويب iOS) يتيح للمختبرين عرض ملاحظات الإصدار وتثبيت التطبيق على أجهزتهم. يحتاج المُختبر إلى الوصول إلى الإصدار حتى يتمكن من استخدام الرابط.
    • binary_download_uri - رابط موقّع يقوم بتنزيل التطبيق الثنائي وتثبيته مباشرة (ملف IPA). تنتهي صلاحية الرابط بعد ساعة واحدة.

    إدارة المختبرين والمجموعات

    بالإضافة إلى توزيع الإصدارات، يمكنك أيضًا استخدام 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 .

    إذا كان لديك عدد كبير من المختبرين، فيجب عليك التفكير في استخدام المجموعات: يمكنك استخدام appdistribution:group:create و appdistribution:group:delete لإنشاء مجموعات أو حذفها في مشروع Firebase الخاص بك.

    استخدم --group-alias لتحديد مجموعة لأوامر appdistribution:testers:add و appdistribution:testers:remove .

    على سبيل المثال:

    firebase appdistribution:group:create "QA team" qa-team
    
    firebase appdistribution:testers:add --group-alias=qa-team anothertester@email.com moretesters@email.com
    
    firebase appdistribution:testers:remove --group-alias=qa-team anothertester@email.com moretesters@email.com
    
    firebase appdistribution:group:delete qa-team
    

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

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

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

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