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

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

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

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

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

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

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

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

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

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

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

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

الحل 1

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

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

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

الحل 2

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

الحل 3

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

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

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

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

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

يظهر الخطأ "مطلوب وضع المطور" عند محاولة تشغيل تطبيق 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. تذكر تحديد حساب Google الذي استخدمته لأول مرة عندما قبلت الدعوة لاختبار التطبيق.

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

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

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

• تحقق للتأكد من تمكين Firebase App Testers API. لمزيد من المعلومات، راجع تمكين واجهة برمجة التطبيقات لاختبار توزيع التطبيقات .

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

• إذا قمت عادةً بمسح UserDefaults عند تسجيل الخروج، فربما تقوم بمسح حالة المختبر الخاص بك. يقوم "توزيع التطبيقات" بتخزين علامة تشير إلى ما إذا كان المختبر الخاص بك قد قام بالفعل بتسجيل الدخول إلى التطبيق. لمزيد من المعلومات، راجع مستودع GitHub .

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

يحتوي Firebase App Distribution على حدود الاختبار التالية:

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

• أضف 200 مختبر كحد أقصى إلى مجموعة توزيع التطبيقات

لإضافة المزيد من المختبرين، اطلب زيادة الحد بدون تكلفة.

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

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

متى يتم إنشاء إصدار جديد لتحميلات iOS؟

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

ما مدة إتاحة إصدارات التطبيقات؟

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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