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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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