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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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