استكشاف الأخطاء وإصلاحها في توزيع التطبيق والأسئلة الشائعة

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

عند تحميل أحد التطبيقات ، قد تواجه هذا الخطأ:

"لم نتمكن من العثور على بريد إلكتروني لجهة اتصال للتطبيق <app-id> . يُرجى زيارة توزيع التطبيقات داخل وحدة تحكم 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. احذف المختبر من قسم عرض جميع المختبرين في علامة التبويب المختبرون والمجموعات في صفحة توزيع التطبيق في وحدة تحكم Firebase. تتم إزالة الدعوات الموجودة.

2. أعد دعوة المختبر لاختبار تطبيقك. يجب أن يتلقى المختبر دعوة عبر البريد الإلكتروني.

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

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

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

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

• تم تعيين عوامل تصفية البريد الإلكتروني.

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

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

الحل 1

1. اطلب من المختبر التحقق من مجلد البريد العشوائي وأي عوامل تصفية للبريد الإلكتروني قاموا بتعيينها في خدمة البريد الإلكتروني الخاصة بهم.

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

   1. ابحث عن رسالة بريد إلكتروني استلمها المُختبِر مسبقًا من التطبيق.
   2. انقر فوق إدارة إعدادات البريد الإلكتروني في الجزء السفلي وانقر فوق السماح لرسائل البريد الإلكتروني بإعادة الاشتراك.

الحل 2

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

الحل 3

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

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

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

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

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

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

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

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

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

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

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

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

خطأ 403: "اتصل بالمسؤول للوصول"

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

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

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

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

إذا كنت قد أعددت بالفعل App Distribution iOS SDK في تطبيقك ولا يتلقى المختبرين تنبيهات داخل التطبيق ، فتحقق للتأكد من أن تطبيقك يجلب الإصدارات الجديدة:

1. قم بتمكين وضع التصحيح في تطبيقك. لمعرفة الكيفية ، راجع وثائق Google Analytics .

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

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

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

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

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

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

لمزيد من المعلومات ، راجع توزيع التطبيقات يدعم 1000 إصدار كحد أقصى .

بعد أن يصل التطبيق إلى حد انتهاء الصلاحية البالغ 150 يومًا أو يتجاوز 1000 تطبيق ، تتم إزالة الإصدار من لوحة معلومات توزيع التطبيقات وتطبيق الويب لاختبار توزيع التطبيقات. إذا قام المُختبِر بتثبيت الإصدار ، فسيستمر تشغيل الإصدار المحلي من التطبيق.

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

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

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

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

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

يدعم توزيع التطبيق 1000 إصدار كحد أقصى

يسمح توزيع التطبيق بحد أقصى 1000 إصدار لكل تطبيق. عندما يصل تطبيقك إلى الحد الأقصى لإصدار تطبيق 1000 ، يحذف App Distribution تلقائيًا الإصدارات الأقدم فوق الحد.

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

إذا كانت لديك أسئلة ، فاتصل بدعم Firebase .

ما هو ملف تعريف Firebase؟

ملف تعريف Firebase هو ملف تعريف تكوين يسمح لتوزيع التطبيقات بما يلي:

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

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

للحصول على تعليمات حول تثبيت ملفات تعريف التكوين على جهاز iOS الخاص بك ، راجع وثائق Apple .

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

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

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

1. إذا لم تكن قد قمت بذلك بالفعل ، فقم بتسجيل الدخول إلى Google واقبل الدعوة.

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

3. في الجزء العلوي الأيسر من صفحة التطبيق ، انقر فوق mobile_screen_share .

4. اتبع التعليمات المعروضة لتثبيت ملف تعريف Firebase.

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

لحذف حساب اختبار توزيع التطبيقات والبيانات المرتبطة به ، اتبع هذه الخطوات بالترتيب:

1. قم بزيارة https://appdistribution.firebase.google.com وقم بتسجيل الدخول باستخدام حساب Google الخاص بك.

2. في الجزء العلوي الأيسر ، انقر فوق settings ( إدارة الحساب )

   حذف الحساب .

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