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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

     1. على الجهاز الاختباري، سجِّل الدخول إلى تطبيق الويب Firebase App Distribution. يُرجى تذكُّر اختيار حساب 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. إذا ثبَّت المختبِر الإصدار، سيستمر تشغيل النسخة المحلية من التطبيق.

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

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