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

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

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

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

تصدير أرقام تعريف الأجهزة الفريدة (UDID) يدويًا

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

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

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

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

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

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

تصدير أرقام تعريف الأجهزة الفريدة (UDID) آليًا باستخدام fastlane

  1. صدِّر جميع أرقام التعريف الفريدة للأجهزة التجريبية كملف 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 باستخدام الخيار تسجيل أجهزة متعددة. لمزيد من المعلومات، يُرجى الاطّلاع على مستندات 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 الجديد إلى ملف توفير تطبيقك، ثم إعادة إنشاء التطبيق، وإعادة توزيعه باستخدام ملف التوفير المعدَّل.

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

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

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

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

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

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