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

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

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

"تعذّر علينا العثور على عنوان بريد إلكتروني للتواصل بشأن التطبيق <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>.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

الحل 1

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

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

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

الحلّ 2

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

الحلّ 3

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

   • إذا لم يتم عرض أي إصدار، قد يعني ذلك أنّ المختبِر لم يتم ربطه بعد بالإصدار الجديد. في لوحة بيانات App Distribution فيconsole Firebase، تأكَّد من تضمين المختبِر في عملية distribution (توزيع) الإصدار وأنّ حالته هي Accepted (مقبول).

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

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

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

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

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

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

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

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

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

تفرض Firebase App Distribution الحدود التالية على المختبِرين:

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

• إضافة 200 مختبِر كحدّ أقصى إلى مجموعة App Distribution

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

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

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

متى يتم إنشاء إصدار جديد لعمليات تحميل التطبيقات على أجهزة iOS؟

يُرجى الاطّلاع على تسجيل أجهزة إضافية.

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

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

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

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

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

لإبقاء إصدار التطبيق متاحًا لفترة أطول، يمكنك اتّباع أحد الاقتراحات التالية:

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

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

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

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

‫App Distribution تتيح 1,000 إصدار كحد أقصى

تسمح منصة App Distribution بحد أقصى 1,000 إصدار لكل تطبيق. وعندما يصل تطبيقك إلى الحد الأقصى البالغ 1,000 إصدار، تتم تلقائيًا عند استخدام منصة App Distribution إزالة الإصدارات الأقدم التي تتجاوز الحد الأقصى.

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

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

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

الملف الشخصي على Firebase هو ملف شخصي للإعدادات يتيح لـ App Distribution ما يلي:

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

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

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

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

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

إذا كنت تختبِر إصدارًا من Enterprise، يمكنك تثبيت الملف الشخصي يدويًا:

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

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

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

4. اتّبِع التعليمات التي تظهر لتثبيت الملف الشخصي على Firebase.

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

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

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

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

   حذف الحساب

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