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

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

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

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

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

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

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

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

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

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

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

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

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

الحصول على تنبيهات تلقائية

بشكل تلقائي، يمكن أن يرسل Firebase تنبيهات "توزيع التطبيقات" لعمليات تسجيل أجهزة iOS الجديدة عبر البريد الإلكتروني.

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

بشكل افتراضي، سيتلقى كل عضو في المشروع (لديه الأذونات المطلوبة لتلقي التنبيهات) رسالة إلكترونية عند تسجيل جهاز iOS جديد.

تفعيل/إيقاف التنبيهات لحسابك

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

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

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

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

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

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

لإعداد إمكانات التنبيه المتقدمة باستخدام وظائف السحابة الإلكترونية لبرنامج Firebase، اتّبِع الخطوات التالية:

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

    1. إعداد بيئة تطوير لـ Node.js أو Python.
    2. ثبِّت واجهة سطر الأوامر لمنصّة Firebase وسجِّل الدخول إليها.
    3. إعداد وظائف السحابة الإلكترونية لبرنامج Firebase باستخدام واجهة سطر الأوامر في Firebase

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

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

الخطوات اللاحقة