توزيع تطبيقات iOS على المختبِرين باستخدام واجهة سطر الأوامر في Firebase

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

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

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

  2. نفِّذ الأمر appdistribution:distribute لتحميل تطبيقك و توزيعه على المختبِرين. استخدِم المَعلمات التالية لضبط عملية التوزيع:

    appdistribution:distribute options
    --app

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

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

    رمز مميّز لإعادة التحميل يتم طباعته عند مصادقة بيئة التكامل المستمر باستخدام Firebase CLI (اطّلِع على مقالة استخدام سطر الأوامر مع أنظمة التكامل المستمر لمزيد من المعلومات). 

    --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"

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

    --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 CLI الروابط التالية بعد تحميل الإصدار. تساعدك هذه الروابط في إدارة الملفات الثنائية والتأكّد من حصول المختبِرين والمطوّرين الآخرين على الإصدار المناسب:

    • 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

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

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

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

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