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

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

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

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

تعذُّر ظهور التطبيقات أو الإصدارات الصحيحة للمختبِر

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

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

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

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 Console. يؤدي هذا الإجراء إلى إزالة الدعوات الحالية.

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

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

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

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

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

لتفعيل "وضع المطوّر" وحلّ هذا الخطأ، اتّبِع الخطوات التالية:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

• إذا كنت تمحو عادةً بيانات 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 الخاص بالمختبِرين. وإذا كان المختبِر قد ثبّت الإصدار، سيستمر تشغيل النسخة المحلية من التطبيق.

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

• قبل انتهاء صلاحية إصدار التطبيق أو تجاوزه الحد المسموح به، نزِّل ملف IPA واحذف الإصدار من لوحة بيانات 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 إلى مطوّر التطبيق رسالة إلكترونية تتضمّن المعرّف الفريد للجهاز (UDID) الخاص بالجهاز الاختباري، بالإضافة إلى تعليمات حول كيفية تضمين الجهاز في ملف الإعداد الخاص بالتطبيق حتى يمكن اختبار الإصدار على جهازك.

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

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

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

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

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

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 أولاً لا يؤدي إلى حذف حسابك أو بياناتك التجريبية.