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

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

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

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

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

  1. يمكنك إضافة الأجهزة إلى بوابة مطوّري برامج Apple.
    • الخيار 1: استيراد أرقام التعريف الفريد للجهاز كملف 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

  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 التنبيهات.

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