تحديد المشاكل وحلّها في ميزة "توزيع التطبيقات" والأسئلة الشائعة

iOS Android

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

توزيع التطبيقات

اتّبِع النصائح التالية لتحديد وحلّ المشاكل التي قد تواجهها عند توزيع التطبيقات إلى المختبِرين.

يتعذّر توزيع التطبيق بسبب عدم توفّر عنوان البريد الإلكتروني لجهة الاتصال.

عند تحميل أحد التطبيقات، قد يظهر لك الخطأ التالي:

"لم نتمكن من العثور على البريد الإلكتروني لجهة الاتصال للتطبيق <app-id>. يُرجى الانتقال إلى App Distribution ضمن وحدة تحكّم Firebase لإعداد إحدى هذه النماذج".

حدِّد عنوان بريد إلكتروني مخصّصًا للتواصل في "وحدة تحكُّم Firebase"، إذا كان ذلك متاحًا. في حال استمرار المشكلة، يُرجى التواصل مع فريق دعم Firebase.

حدث خطأ أثناء توفير التطبيق (خطأ 400 أو 409 أو 500).

في حال ظهور الأخطاء 400 أو 409 أو 500 بشكل متكرر أثناء توفير المتطلبات اللازمة، يُرجى التواصل مع فريق دعم Firebase. يمكنك تقديم الدعم باستخدام رقم مشروع Firebase ومعرّف التطبيق.

يتعذر تحميل IPA

في ما يلي مثال على استجابة شبكة المتصفح:

{
"status": "IN_PROGRESS",
  "message": "There was an error processing your
distribution. Ensure you are uploading a valid IPA or APK and try again."
}

لحلّ هذه المشكلة، اتّبِع الخطوات التالية:

1. تحقَّق من حجم IPA. ويبلغ الحدّ الأقصى لحجم الملف لكل البرامج الثنائية 2048 مبيبايت، وهو ما يزيد بقليل عن 2 غيغابايت.

2. إذا كان حجم IPA ضمن الحد المسموح به لحجم الملف وكان قابلاً للتكرار، اتّبع الخطوات التالية:

   1. راجِع ملف Info.plist وتأكَّد مما إذا كان CFBundleDisplayName يحتوي على أي محدِّدات لـ <array>.

      ملاحظة: لا تقبل ميزة App Distribution قيم CFBundleDisplayName التي تكون مصفوفات.

   2. عليك إزالة محدِّدات <array> وإعادة إنشاء تطبيقك. من المفترض أن تتم عملية التحميل بنجاح.

   3. إذا كنت لا تزال تواجه مشاكل، يُرجى التواصل مع فريق دعم Firebase.

3. إذا تجاوز حجم IPA الحد المسموح به لحجم الملف، يمكنك إجراء أي تغييرات ضرورية لتقليل حجم الملف.

4. إذا لم يؤدِّ تقليل حجم ملف IPA إلى حلّ المشكلة، يُرجى التواصل مع فريق دعم Firebase والاستفسار عن كيفية استخدام TestFlight.

تثبيت التطبيقات واختبارها

اتّبِع النصائح التالية لتحديد وحلّ المشاكل التي قد يواجهها المختبِرون عند تثبيت تطبيقاتك واختبارها.

لا يملك المختبِر حسابًا على Google

عندما ينشئ المستخدم حساب Google، فإنه يتلقى عنوان Gmail تلقائيًا.

إذا لم يكن لدى أحد المختبرين عنوان على Google Workspace أو Gmail، أو إذا كان يفضّل استخدام عنوان بريد إلكتروني آخر لتسجيل الدخول، اطلب من المختبر ربط عنوان بريد إلكتروني غير تابع لـ Gmail بالحساب واستخدام هذا البريد الإلكتروني لتسجيل الدخول.

عند اختيار عنوان بريد إلكتروني بديل، على المختبِر اتباع الإرشادات التالية:

• لا تستخدم عنوان Gmail.
• لا تستخدم عنوان بريد إلكتروني مرتبط بحساب آخر على Google.
• احرص على استخدام كلمة مرور حسابك على Google عند تسجيل الدخول باستخدام عنوان البريد الإلكتروني هذا.

لمزيد من المعلومات، يمكنك الاطّلاع على تسجيل الدخول إلى حسابك على Google باستخدام عنوان بريد إلكتروني آخر.

عدم تمكّن المختبِر من الاطّلاع على التطبيقات أو الإصدارات الصحيحة

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

البريد الإلكتروني الذي يرسل إليه المطوّر دعوات ويضيفه إلى الإصدارات الجديدة (البريد الإلكتروني أ) يمكن أن يكون مختلفًا عن عنوان البريد الإلكتروني الذي يستخدمه المختبِر لقبول الدعوة (الرسالة الإلكترونية ب). يؤدي هذا إلى إنشاء رابط وراء الكواليس. كلما تمت إضافة البريد الإلكتروني أ إلى إصدارات جديدة، يكون في الواقع البريد الإلكتروني ب هو الذي يمكنه الوصول.

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

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

2. يُرجى دعوة المختبِر مرة أخرى لاختبار تطبيقك. ومن المفترض أن يتلقّى المختبِر دعوة عبر رسالة إلكترونية.

3. تأكَّد من قبول المختبِر للدعوة باستخدام عنوان البريد الإلكتروني نفسه.

لا يتلقّى المختبِر إشعارات عبر البريد الإلكتروني

قد لا يتلقّى المختبِرون إشعارات عبر البريد الإلكتروني في حال حدوث أي مما يلي:

• يتم إرسال الإشعارات عبر البريد الإلكتروني إلى مجلدات الرسائل غير المرغوب فيها.

• تم ضبط فلاتر البريد الإلكتروني.

• تم إرسال الدعوة إلى أحد حسابات البريد الإلكتروني، ولكن المختبِر قبوله باستخدام حساب بريد إلكتروني مختلف. يتلقى المختبِر رسائل بريد إلكتروني للإصدار الجديد لحساب البريد الإلكتروني الذي تم إرسال الدعوة إليه في الأصل.

• وقد تمت دعوة المختبِر في وقت سابق، لكنه لم يقبل الدعوة الأولية. إذا تمت إضافة المختبِر إلى إصدارات لاحقة، لن يرسل تطبيق App Distribution تلقائيًا إشعارات الإصدار إلى هذا المختبِر بسبب عدم قبوله الدعوة الأولية.

الحل 1

1. اطلب من المختبِر التحقق من مجلد الرسائل غير المرغوب فيها وأي فلاتر للبريد الإلكتروني تم ضبطها في خدمة البريد الإلكتروني.

2. إذا ألغى المختبِر الاشتراك في الرسائل الإلكترونية، اطلب منه إجراء ما يلي:

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

الحل 2

إذا كان المختبِر لا يهتم بتلقّي إشعارات عبر البريد الإلكتروني وكان يريد فقط قبول دعوات التطبيقات، يمكنه الاطّلاع على دعوات التطبيقات في انتظار المراجعة مباشرةً من مقطع الويب لميزة "توزيع تطبيقات Firebase": appdistribution.firebase.google.com.

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

الحل 3

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

2. يُرجى دعوة المختبِر مرة أخرى لاختبار تطبيقك. ومن المفترض أن يتلقّى المختبِر دعوة عبر رسالة إلكترونية. تأكد من قبول المختبِر للدعوة باستخدام عنوان البريد الإلكتروني نفسه الذي تم إرسال الدعوة إليه.

ظهور رسالة الخطأ "مطوّر مؤسسة غير موثوق به" عند محاولة تشغيل تطبيق تجريبي

يظهر الخطأ مطوّر برامج مؤسسة غير موثوق به إذا لم تثق بشهادة المطوّر على جهاز الاختبار قبل فتح التطبيق. من تطبيق الإعدادات > شاشة الملفات الشخصية وإدارة الجهاز، اختَر اسم مطوِّر التطبيق والوثوق به.

ظهور رسالة الخطأ "وضع مطور البرامج مطلوب" عند محاولة تشغيل تطبيق تجريبي

يظهر الخطأ "مطلوب وضع مطور البرامج" عند محاولة تشغيل تطبيق iOS مُدار بشكل مخصّص على نظام التشغيل iOS 16 أو إصدار أحدث بدون تفعيل "وضع مطور البرامج" أولاً.

لتمكين وضع مطور البرامج وحل هذا الخطأ، اتبع الخطوات التالية:

1. على جهاز iPhone، افتح تطبيق "الإعدادات" ثم انقر على الخصوصية والأمان.
2. انتقِل للأسفل وصولاً إلى الأمان وانقر على وضع المطوِّر.
3. انقر على شريط التمرير وضع مطور البرامج.
4. انقر على إعادة التشغيل.
5. بعد إعادة تشغيل الجهاز، افتح قفل الجهاز. سيظهر مربع الحوار "هل تريد تشغيل وضع المطور؟"
6. انقر على تفعيل. يمكنك الآن إطلاق تطبيقك وبدء الاختبار.

"تم تسجيل الجهاز، وأنت جاهز الآن". ستتلقّى رسالة إلكترونية عندما يكون التطبيق جاهزًا للاختبار.

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

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

لا يمكن لحساب Google الوصول إلى التطبيق التجريبي.

إذا كان حسابك على Google لا يمكنه الوصول إلى تطبيق تجريبي سبق لك تثبيته (أو قبل دعوة إليه)، فمن المحتمل أنك سجّلت الدخول إلى حساب Google غير صحيح. يتم ربط التطبيقات التي يمكنك الوصول إليها بحساب Google الذي استخدمته عند قبول الدعوة لاختبار التطبيق لأول مرة. يُرجى إعادة المحاولة عن طريق تسجيل الدخول باستخدام حساب Google الذي استخدمته في السابق لقبول الدعوة.

يُرجى أخذ ما يلي في الاعتبار:

• يجب ألّا يكون حساب Google الذي استخدمته لقبول الدعوة مطابقًا لحساب Google الذي تم إرسال الدعوة إليه في الأصل.
• يمكن ربط حساب Google بأي عنوان بريد إلكتروني، وليس فقط بعناوين نطاقات Gmail أو G Suite. تعرَّف على كيفية تسجيل الدخول باستخدام عنوان بريد إلكتروني آخر.

الخطأ 403: "يُرجى التواصل مع المشرف للحصول على إذن الوصول"

عندما يظهر لك الخطأ 403، يعني هذا أنّ الحساب الذي تستخدمه لا يملك إذن تثبيت التطبيقات واختبارها. يحدّد مشرف نطاق حسابك في Google Workspace إمكانية الوصول.

إذا كنت ترى أنّه يجب الحصول على إذن لتثبيت التطبيقات واختبارها، اطلب من مشرف حسابك على Google Workspace تغيير إعدادات حسابك. ويجب أن يتّبع المشرف التعليمات الواردة في مقالة إدارة الوصول إلى الخدمات التي لا يتم التحكّم فيها بشكلٍ فردي.

إذا كانت لديك حسابات متعددة، جرِّب تسجيل الدخول باستخدام حساب مختلف لا يُحظر تثبيت التطبيقات واختبارها.

تفعيل التنبيهات داخل التطبيق باستخدام حزمة تطوير البرامج لنظام التشغيل iOS لتوزيع التطبيقات

اتّبِع النصائح التالية لتحديد وحلّ المشاكل التي تتضمّن تفعيل تنبيهات الإصدارات الجديدة داخل التطبيق باستخدام حزمة تطوير البرامج (SDK) لنظام التشغيل iOS لتوزيع التطبيقات.

لا يتلقّى المختبِر تنبيهات داخل التطبيق

إذا سبق لك إعداد حزمة تطوير البرامج (SDK) لنظام التشغيل iOS لميزة "توزيع التطبيقات" في تطبيقك ولم يتلق المختبِرون تنبيهات داخل التطبيق، تحقَّق مما إذا كان التطبيق يجلب إصدارات جديدة:

1. فعِّل وضع تصحيح الأخطاء في تطبيقك. ولمعرفة كيفية إجراء ذلك، اطّلِع على مستندات "إحصاءات Google".

2. شغِّل تطبيقك في محاكي وابحث عن السلسلة "[Firebase/AppDistributeion]".

3. تحقَّق من إمكانية وصول المختبِر إلى الإصدار الجديد:

   • في حالة إرجاع عنصر إصدار صالح، من المرجح أن تكون هناك مشكلة في دورة حياة وحدة التحكم في العرض، حيث يتم تحميل مربع حوار التنبيه قبل ظهور العرض.

     ملاحظة: لا تعرِض حزمة تطوير البرامج (SDK) لنظام التشغيل iOS لميزة "توزيع التطبيقات" مربّع حوار للتنبيه بشكل تلقائي. يجب تحديد طريقة عرض مربّع الحوار في تطبيقك ومكان عرضه. لمزيد من المعلومات، اطّلِع على إعدادات التنبيه الأساسية.

   • في حال عدم عرض أي إصدار، قد لا يتم ربط المختبِر بعد بالإصدار الجديد. من خلال لوحة بيانات "توزيع التطبيقات" ضمن وحدة تحكُّم Firebase، تأكَّد من أنّ المختبِر مشمول في توزيع الإصدار وأنّه في الحالة مقبول.

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

     1. على الجهاز الاختباري، سجِّل الدخول إلى مقطع الويب لميزة "توزيع التطبيقات على Firebase". تذكر تحديد حساب Google الذي استخدمته لأول مرة عند قبولك الدعوة لاختبار التطبيق.

     2. تأكَّد من أنّ إصدار التطبيق الجديد متوفّر في مقطع الويب.

طلب المختبِر تسجيل الدخول مرة أخرى بعد إغلاق التطبيق

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

• تأكّد من تفعيل واجهة Firebase App Testers API. للحصول على مزيد من المعلومات، يُرجى الاطّلاع على تفعيل واجهة برمجة التطبيقات App Distribution Tester API.

• ضمن القيود الرئيسية، تأكَّد من أنّ واجهة Firebase App Testers API مُدرَجة في قائمة واجهات برمجة التطبيقات المسموح بها.

• إذا كنت تمحو UserDefaults عند تسجيل الخروج، قد يتم محو حالة المختبِر. تخزِّن ميزة App Distribution علامة تشير إلى ما إذا كان المختبِر قد سجّل الدخول إلى التطبيق من قبل. لمزيد من المعلومات، يُرجى الاطّلاع على مستودع GitHub.

الأسئلة الشائعة

هل هناك حدود لإضافة المختبِرين إلى تطبيقي؟

تلتزم ميزة "توزيع التطبيقات من Firebase" بحدود المختبِرين التالية:

• إضافة 500 مختبِر كحد أقصى إلى مشروع على Firebase

• يمكنك إضافة 200 مختبِر كحد أقصى إلى مجموعة "توزيع التطبيقات"

لإضافة المزيد من المختبِرين، يمكنك طلب زيادة الحد بدون تكلفة.

هل تنتهي صلاحية دعوات المختبِرين؟

ويكون لدى المختبِرين 30 يومًا لقبول الدعوة لاختبار التطبيق قبل انتهاء صلاحيته. عندما تنتهي صلاحية الدعوة بعد 5 أيام من انتهاء صلاحيتها، يظهر إشعار انتهاء صلاحية في وحدة تحكُّم Firebase بجانب المختبِر في أحد الإصدارات. يمكن تجديد الدعوة عن طريق إعادة إرسالها عبر القائمة المنسدلة في صف المختبر.

متى يتمّ إنشاء إصدار جديد لتحميله إلى نظام التشغيل iOS؟

راجِع تسجيل أجهزة إضافية.

ما مدة توفّر إصدارات التطبيق؟

تتم إزالة إصدارات التطبيق من ميزة "توزيع التطبيقات" في حال حدوث أحد الشروط التالية:

• تم إصدار التطبيق قبل أكثر من 150 يومًا.
• إذا تجاوزت الحدّ الأقصى لعدد إصدارات التطبيق البالغ 1,000، وكان إصدار التطبيق أقدم من أحدث 1,000 إصدار للتطبيق.

لمزيد من المعلومات، يُرجى الاطِّلاع على تتوافق ميزة "توزيع التطبيقات" مع 1,000 إصدار كحد أقصى.

بعد بلوغ التطبيق أو تجاوزه الحدّ الأقصى المسموح به وهو 150 يومًا أو 1,000 إصدار، تتم إزالة الإصدار من لوحة بيانات App Distribution ومن تطبيق الويب لاختبار ميزة App Distribution. وإذا ثبّت المختبِرون الإصدار، سيستمر تشغيل الإصدار المحلي من التطبيق.

ولإبقاء إصدار التطبيق متاحًا لفترة أطول، استخدِم أحد الاقتراحات التالية:

• قبل انتهاء صلاحية إصدار التطبيق أو تجاوزه، يمكنك تنزيل بروتوكول IPA وحذف الإصدار من لوحة بيانات توزيع التطبيقات. بعد ذلك، أعِد تحميل IPA كإصدار جديد لميزة App Distribution.
• نزِّل الإصدار وحمِّله على Cloud Storage للأرشفة على المدى الطويل.

تنتهي صلاحية إصدارات التطبيق بعد 150 يومًا.

عند تحميل إصدار من تطبيقك إلى Firebase، يظهر الإصدار في لوحة بيانات توزيع التطبيقات لمدة 150 يومًا، بدءًا من تاريخ التحميل. بعد تحميل الإصدار، يمكنك توزيعه على المختبِرين الذين يثبِّتون الإصدار من تطبيق الويب لاختبار ميزة App Distribution على جهاز الاختبار.

عندما يكون الإصدار بعد 30 يومًا من تاريخ انتهاء الصلاحية، يظهر إشعار بانتهاء صلاحية إصدار التطبيق في صفحة "توزيع التطبيقات" في وحدة تحكُّم Firebase وفي تطبيق الويب لأداة اختبار "توزيع التطبيقات".

تتوافق ميزة "توزيع التطبيقات" مع 1,000 إصدار كحد أقصى.

تسمح ميزة "توزيع التطبيقات" بتثبيت 1,000 إصدار كحد أقصى لكل تطبيق. وعندما يصل تطبيقك إلى 1,000 إصدار كحد أقصى، تحذف ميزة "توزيع التطبيقات" تلقائيًا الإصدارات الأقدم التي تجاوزت هذا الحد.

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

إذا كانت لديك أسئلة، يُرجى التواصل مع فريق دعم Firebase.

ما هو الملف الشخصي على Firebase؟

الملف الشخصي في Firebase هو ملف شخصي للإعدادات يسمح لميزة App Distribution بما يلي:

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

• ثبِّت مقطع ويب لميزة Firebase App Distribution على الشاشة الرئيسية لجهازك. يسمح لك مقطع الويب بتثبيت جميع التطبيقات التجريبية والوصول إليها من مكان واحد. إن التصميمات الجديدة التي تمت دعوتك لاختبارها تتم إضافتها تلقائيًا إلى مقطع الويب.

للحصول على مساعدة بشأن تثبيت الملفات الشخصية للإعدادات على جهاز iOS، راجِع مستندات Apple.

كيف يمكنني الوصول إلى التطبيقات الاختبارية التي ثبَّتها على جهازي؟

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

إذا كنت تختبر توزيعًا للمؤسسات، يمكنك تثبيت الملف الشخصي يدويًا:

1. سجِّل الدخول إلى Google واقبل الدعوة، إذا لم يسبق لك إجراء ذلك.

2. ضمن التطبيقات التجريبية، اختَر التطبيق الذي تريد اختباره.

3. في أعلى يسار صفحة التطبيق، انقر على .

4. اتّبِع التعليمات المعروضة لتثبيت الملف الشخصي على Firebase.

كيف يمكنني حذف حساب الاختبار الخاص بي؟

لحذف حساب مختبِر App Distribution والبيانات المرتبطة به، اتّبِع الخطوات التالية بالترتيب:

1. انتقِل إلى https://appdistribution.firebase.google.com وسجِّل الدخول باستخدام حسابك على Google.

2. في أعلى يسار الصفحة، انقر على (إدارة الحساب).

   حذف الحساب

3. اختياري: في أذونات حساب Google، أبطل إمكانية الوصول من Firebase App Distribution. يُرجى ملاحظة أنّ إلغاء إمكانية الوصول بدون حذف حساب App Distribution أولاً لا يؤدّي إلى حذف حساب المختبر أو بياناته.