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

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

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

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

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

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

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

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

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

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

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
   

   ملاحظة: لتفعيل الإصدار التلقائي لإصدار جديد باستخدام أرقام تعريف UDID جديدة، يُرجى الاطّلاع على مقالة توزيع إصدارات iOS التجريبية بشكل أسرع باستخدام App Distribution و fastlane.

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

ملاحظة: لاستخدام إمكانات التنبيه المتقدّمة، يجب أن يستخدم مشروع Firebase الخاص بك خطة أسعار Blaze

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

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

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

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

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

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

• استيراد المختبِرين من ملفات CSV

• لمعرفة كيفية زيادة قاعدة الاختبارات الداخلية، يُرجى الاطّلاع على مقالة إنشاء دعوة. .