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

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

قبل البدء

  1. أضِف Firebase إلى مشروع Apple الخاص بك، في حال لم يسبق لك إجراء ذلك.

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

  2. افتح صفحة App Distribution من Firebase وحدة تحكُّم. اختَر مشروعك على Firebase عندما يُطلب منك ذلك، واختَر تطبيقك باستخدام أداة تبديل التطبيقات، ثم انقر على البدء.

الخطوة 1: توزيع تطبيقك على المختبِرين

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

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

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

    appdistribution:distribute options
    --app

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

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

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

    --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 dashboard of the Firebase console لمدة 150 يومًا (خمسة أشهر). عندما يتبقى 30 يومًا على انتهاء صلاحية الإصدار، يظهر إشعار بانتهاء الصلاحية في كلّ من "وحدة التحكّم" وقائمة الإصدارات الخاصة بالمختبِر على جهازه الاختباري.

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

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

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