تسجيل أجهزة iOS إضافية

إذا كنت تريد توزيع إصدارات iOS مؤقتة باستخدام App Distribution، عليك اتّباع هذا الدليل لتسجيل أجهزة المختبِرين. الإصدار العرضي هو إصدار لم يتم توقيعه باستخدام ملف شخصي على Enterprise. لا يمكن للجهاز تثبيت ملف APK أحادي الاستخدام إلا إذا كان معرّف الجهاز الفريد (UDID) مضمّنًا في ملف APK ملف الإعداد.

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

عند تلقّي رسالة إلكترونية تتضمّن رقم تعريف جهاز (UDID)، عدِّل ملف الإعداد باستخدام رقم التعريف هذا ووزِّع إصدارًا جديدًا على المختبِرين. يمكنك يدوياً تصدير أرقام UDID باستخدام وحدة تحكُّم Firebase أو CLI في Firebase، أو يمكنك تصدير أرقام UDID آليًا باستخدام fastlane.

تصدير أرقام UDID يدويًا

1. أضِف الأجهزة إلى بوابة المطوّرين في Apple.
   • الخيار 1: استيراد أرقام تعريف UDID للأجهزة كملف CSV

     في علامة التبويب المختبِرون والمجموعات ضمن لوحة بيانات App Distribution، اختَر كل المختبِرين، ثم انقر على تصدير أرقام Apple UDID لتنزيل ملف CSV. بعد ذلك، استورِد الملف إلى حساب المطوِّر الخاص بك على Apple باستخدام الخيار تسجيل أجهزة متعددة. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة توزيع تطبيقك على الأجهزة المسجّلة.

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

   • الخيار 2: جمع معرّفات UDID وإدخالها عبر البريد الإلكتروني

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

2. أضِف الأجهزة المسجَّلة إلى ملف الإعداد.
3. نزِّل ملف الإعداد واستخدمه لإعادة إنشاء تطبيقك. إذا كنت تريد إعادة الإنشاء فقط لتعديل الأجهزة المسجّلة، لا تعدِّل رقم الإصدار أو الإصدار.
4. أعِد توزيع تطبيقك من خلال وحدة تحكّم Firebase أو واجهة سطر أوامر Google Cloud ‏(CLI). إذا لم تغيِّر الإصدار أو رقم الإصدار أو رمز تطبيقك، لن تنشئ أداة App Distribution إصدارًا جديدًا ولن تُرسِل إشعارًا للمختبِرين. إذا سبق أن وزّعت إصدارًا يحمل رقم الإصدار وإصدار الإصدار نفسه، لن يتلقّى سوى مستخدمي الأجهزة المسجَّلة حديثًا رسائل إلكترونية تتضمن إشعارًا.

تصدير أرقام UDID آليًا باستخدام fastlane

1. تصدير جميع أرقام تعريف UDID لأجهزة المختبِرين كملف CSV من fastlane على سبيل المثال، يمكنك إنشاء مسار download_udids جديد وتشغيله باتّباع الخطوات التالية:

   lane :download_udids do
       firebase_app_distribution_get_udids(
           app: "<your Firebase app ID>",
           output_file: "<path to output file>",
       )
   end
   

   ملاحظة: لتفعيل الإصدار التلقائي لإصدار جديد باستخدام أرقام تعريف UDID جديدة، يُرجى الاطّلاع على مقالة توزيع إصدارات iOS التجريبية بشكل أسرع باستخدام App Distribution و fastlane.

2. استورِد أرقام تعريف UDID إلى حساب المطوِّر الخاص بك على Apple باستخدام خيار تسجيل أجهزة متعددة. لمزيد من المعلومات، يُرجى الاطّلاع على مستندات Apple. يُرجى العِلم أنّ حساب المطوِّر الخاص بك على Apple قد لا يسمح لك باستيراد سوى عدد محدود من الأجهزة سنويًا.

3. أضِف الأجهزة المسجّلة إلى ملف الإعداد.

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

5. إعادة توزيع تطبيقك: إذا لم تغيِّر الإصدار أو رقم الإصدار أو رمز تطبيقك، لن تنشئApp Distribution إصدارًا جديدًا ولن تُعلم المختبِرين. إذا سبق أن وزّعت إصدارًا يحمل رقم الإصدار والإصدار نفسهما، لن يتلقّى سوى مستخدمي الأجهزة المسجّلة حديثًا إشعارات عبر البريد الإلكتروني.

تلقّي تنبيهات

تلقّي التنبيهات التلقائية

يمكن أن ترسل Firebase تلقائيًا App Distribution تنبيهات بشأن عمليات تسجيل جديدة على أجهزة iOS عبر البريد الإلكتروني.

لتلقّي تنبيهات App Distribution من خلال هذه الآلية التلقائية، يجب أن يكون لديك إذن firebase.projects.update. تتضمّن الأدوار التالية هذا الإذن المطلوب تلقائيًا: مدير Firebase أو مالك أو محرِّر المشروع.

تلقائيًا، سيتلقّى كل عضو في المشروع (الذي لديه الأذونات المطلوبة لتلقّي التنبيهات) رسالة إلكترونية عند تسجيل جهاز iOS جديد.

تفعيل التنبيهات أو إيقافها لحسابك

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

لتفعيل تنبيهات App Distribution أو إيقافها، اتّبِع الخطوات التالية:

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

إعداد تنبيهات متقدّمة للخدمات التابعة لجهات خارجية

يمكنك أيضًا إرسال تنبيهات App Distribution إلى قناة الإشعارات المفضّلة لفريقك باستخدام Cloud Functions for Firebase. على سبيل المثال، يمكنك كتابة دالة تُسجِّل حدث تنبيه لتسجيل جهاز iOS جديد وتنشر معلومات التنبيه على خدمة تابعة لجهة خارجية، مثل Discord أو Slack أو Jira.

لتفعيل ميزة إعداد مختبِري تطبيق iOS الجدد بشكل آلي بالكامل، يمكنك كتابة دالة تضيف ملف تعريف UDID لجهاز iOS جديد إلى ملف الإعداد الخاص بتطبيقك، وتعيد إنشاء التطبيق، وتعيد توزيعه باستخدام ملف الإعداد المعدَّل.

ملاحظة: لاستخدام إمكانات التنبيهات المتقدّمة، يجب أن يستخدم مشروعك على Firebase خطة أسعار Blaze.

لإعداد إمكانات التنبيهات المتقدّمة باستخدام Cloud Functions for Firebase، اتّبِع الخطوات التالية:

1. إعداد وظائف السحابة الإلكترونية لبرنامج Firebase، وتشمل المهام التالية:

   1. إعداد بيئة تطوير لـ Node.js أو Python
   2. ثبِّت واجهة سطر أوامر Firebase وسجِّل الدخول إليها.
   3. ابدأ استخدام Cloud Functions for Firebase باستخدام واجهة سطر أوامر Firebase.

2. كتابة دالة ونشرها التي تلتقط حدث تنبيه من App Distribution وتعالج الحمولة للحدث (على سبيل المثال، نشر معلومات التنبيه في رسالة على Discord)

للاطّلاع على جميع أحداث التنبيهات التي يمكنك تسجيلها، انتقِل إلى مستندات مرجعي App Distribution التنبيهات.

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

• استيراد المختبِرين من ملفات CSV

• للتعرّف على كيفية زيادة قاعدة الاختبار الداخلي، اطّلِع على مقالة إنشاء روابط دعوة.