تسجيل أجهزة 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 أو 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

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

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

  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. ثبِّت واجهة سطر الأوامر (CLI) في "Firebase" وسجِّل الدخول إليها.
    3. ابدأ إعداد Cloud Functions for Firebase باستخدام واجهة سطر الأوامر (CLI) في Firebase.

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

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

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