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

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

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

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

تصدير معرّفات UDID يدويًا

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

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

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

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

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

2. أضِف الأجهزة المسجَّلة إلى ملف إدارة المتطلبات اللازمة.
3. نزِّل ملف الإعداد واستخدِمه لإعادة إنشاء تطبيقك. إذا كنت تعيد إنشاء التطبيق لتحديث الأجهزة المسجّلة فقط، لا تعدّل رقم الإصدار أو الإصدار.
4. أعِد توزيع تطبيقك من خلال وحدة تحكّم Firebase أو واجهة سطر الأوامر. إذا لم تغيّر الإصدار أو رقم الإصدار أو رمز تطبيقك، لن تنشئ أداة 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
   

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

3. أضِف الأجهزة المسجَّلة إلى ملف إدارة المتطلبات اللازمة {: .external}.

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

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

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

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

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

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

By default, every project member (who has the required permissions to receive alerts) will get an email when a new iOS device is registered.

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

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

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

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

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

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

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

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

1. إعداد وظائف Firebase السحابية، والتي تتضمّن المهام التالية:

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

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

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

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

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

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