توفر هذه الصفحة تعليمات حول استكشاف الأخطاء وإصلاحها وإجابات للأسئلة المتداولة حول توزيع التطبيقات واختبارها باستخدام توزيع التطبيقات.
توزيع التطبيقات
استخدم النصائح التالية لاستكشاف المشكلات التي قد تواجهها عند توزيع التطبيقات على المختبرين وإصلاحها.
عند تحميل أحد التطبيقات ، قد تواجه هذا الخطأ:
"لم نتمكن من العثور على بريد إلكتروني لجهة اتصال للتطبيق <app-id> . يُرجى زيارة توزيع التطبيقات داخل وحدة تحكم Firebase لإعداد واحد."
عيّن بريدًا إلكترونيًا لجهة اتصال في وحدة تحكم Firebase ، إذا كان ذلك متاحًا. إذا استمرت المشكلة ، فاتصل بدعم Firebase .
إذا واجهت أخطاء 400 أو 409 أو 500 بشكل متكرر أثناء التوفير ، فاتصل بدعم Firebase . قدم الدعم برقم مشروع Firebase ومعرّف التطبيق.
فيما يلي مثال على استجابة شبكة المتصفح:
{
"status": "IN_PROGRESS",
"message": "There was an error processing your
distribution. Ensure you are uploading a valid IPA or APK and try again."
}
لحل هذه المشكلة ، اتبع الخطوات التالية:
تحقق من حجم IPA. الحد الأقصى لحجم الملف لجميع الثنائيات هو 2048 ميجابايت ، وهو ما يزيد قليلاً عن 2 جيجابايت.
إذا كان حجم IPA ضمن الحد الأقصى لحجم الملف وكان قابلاً للتكرار ، فاتبع الخطوات التالية:
تحقق من ملف
Info.plistوتأكد مما إذا كانCFBundleDisplayNameيحتوي على أي محددات<array>.أزل محددات
<array>وأعد إنشاء تطبيقك. يجب أن ينجح التحميل.إذا كنت لا تزال تواجه مشكلات ، فاتصل بدعم Firebase .
إذا تجاوز حجم IPA حد حجم الملف ، فقم بإجراء أي تغييرات ضرورية لتقليل حجم الملف.
إذا لم يؤد تقليل حجم ملف IPA إلى حل المشكلة ، فاتصل بدعم Firebase واسأل عن استخدام Testflight .
تثبيت واختبار التطبيقات
استخدم النصائح التالية لاستكشاف المشكلات التي قد يواجهها المختبِرون عند قيامهم بتثبيت واختبار تطبيقاتك.
عندما يقوم مستخدم بإنشاء حساب Google ، فإنه يتلقى تلقائيًا عنوان Gmail.
إذا لم يكن لدى المُختبِر مساحة Google Workspace أو عنوان Gmail ، أو إذا كان يفضل استخدام عنوان بريد إلكتروني آخر لتسجيل الدخول ، فاطلب من المُختبِر ربط عنوان بريد إلكتروني بخلاف Gmail بالحساب واستخدام هذا البريد الإلكتروني لتسجيل الدخول.
عند اختيار بريد إلكتروني بديل ، يجب على المختبر اتباع الإرشادات التالية:
- لا تستخدم عنوان Gmail.
- لا تستخدم عنوان بريد إلكتروني مرتبط بالفعل بحساب Google آخر.
- تذكر استخدام كلمة مرور حساب Google الخاص بك عند تسجيل الدخول باستخدام عنوان البريد الإلكتروني هذا.
لمزيد من المعلومات ، راجع تسجيل الدخول إلى حساب Google الخاص بك باستخدام عنوان بريد إلكتروني آخر .
إذا قبل المُختبِر الدعوة عبر البريد الإلكتروني باستخدام عنوان بريد إلكتروني مختلف عن الرسالة التي تم إرسال الدعوة إليها ، فقد لا يتمكن المُختبِر من رؤية التطبيقات أو الإصدارات الصحيحة.
يمكن أن يكون البريد الإلكتروني الذي يرسل المطور دعوات إليه ويضيفه إلى الإصدارات الجديدة (البريد الإلكتروني أ) مختلفًا عن البريد الإلكتروني الذي يستخدمه المُختبِر لقبول الدعوة (البريد الإلكتروني ب). هذا يخلق رابطًا وراء الكواليس. كلما تمت إضافة البريد الإلكتروني A إلى التصميمات الجديدة ، فإنه في الواقع يتم الوصول إلى البريد الإلكتروني B.
إذا قبل المُختبِر الدعوة عبر البريد الإلكتروني باستخدام عنوان بريد إلكتروني مختلف ، فاتبع هذه الخطوات لحل المشكلة:
احذف المختبر من قسم عرض جميع المختبرين في علامة التبويب المختبرون والمجموعات في صفحة توزيع التطبيق في وحدة تحكم Firebase. تتم إزالة الدعوات الموجودة.
أعد دعوة المختبر لاختبار تطبيقك. يجب أن يتلقى المختبر دعوة عبر البريد الإلكتروني.
تأكد من أن المختبر يقبل الدعوة بنفس عنوان البريد الإلكتروني.
قد لا يتلقى المختبِرون إشعارات بالبريد الإلكتروني في حالة حدوث أي مما يلي:
يتم إرسال إشعارات البريد الإلكتروني إلى مجلدات البريد العشوائي.
تم تعيين عوامل تصفية البريد الإلكتروني.
تم إرسال الدعوة إلى حساب بريد إلكتروني واحد ، لكن المُختبِر قبلها باستخدام حساب بريد إلكتروني مختلف. يتلقى المُختبِر رسائل البريد الإلكتروني للإصدار الجديد لحساب البريد الإلكتروني الذي تم إرسال الدعوة إليه في الأصل.
تمت دعوة المختبر مسبقًا ولكنه لم يقبل الدعوة الأولية. إذا تمت إضافة المُختبِر إلى الإصدارات اللاحقة ، فلن يرسل App Distribution إشعارات الإصدار تلقائيًا إلى هذا المُختبِر لأن المُختبِر لم يقبل الدعوة الأولية.
الحل 1
اطلب من المختبر التحقق من مجلد البريد العشوائي وأي عوامل تصفية للبريد الإلكتروني قاموا بتعيينها في خدمة البريد الإلكتروني الخاصة بهم.
إذا ألغى المختبر اشتراكه من رسائل البريد الإلكتروني ، اطلب من المختبر القيام بما يلي:
- ابحث عن رسالة بريد إلكتروني استلمها المُختبِر مسبقًا من التطبيق.
- انقر فوق إدارة إعدادات البريد الإلكتروني في الجزء السفلي وانقر فوق السماح لرسائل البريد الإلكتروني بإعادة الاشتراك.
الحل 2
احذف المختبر من قسم عرض جميع المختبرين في علامة التبويب المختبرون والمجموعات في صفحة توزيع التطبيق في وحدة تحكم Firebase. يزيل هذا الإجراء الدعوات الموجودة.
أعد دعوة المختبر لاختبار تطبيقك. يجب أن يتلقى المختبر دعوة عبر البريد الإلكتروني. تأكد من أن المختبر يقبل الدعوة بنفس عنوان البريد الإلكتروني الذي تم إرسال الدعوة إليه.
يظهر خطأ Un Trusted Enterprise Developer إذا لم تكن تثق في شهادة المطور على جهاز الاختبار قبل فتح التطبيق. في تطبيق الإعدادات > شاشة الملفات الشخصية وإدارة الجهاز ، حدد اسم مطور التطبيق وثق به.
يظهر خطأ Developer Mode Required عند محاولة تشغيل تطبيق iOS مخصص حسب الحاجة على iOS 16 أو إصدار أحدث دون تمكين وضع المطور أولاً.
لتمكين وضع المطور وحل هذا الخطأ ، اتبع الخطوات التالية:
- على جهاز iPhone الخاص بك ، افتح تطبيق الإعدادات ، ثم انقر فوق الخصوصية والأمان .
- قم بالتمرير لأسفل إلى الأمان وانقر فوق وضع المطور .
- اضغط على شريط تمرير وضع المطور .
- اضغط على إعادة التشغيل .
- بعد إعادة تشغيل الجهاز ، قم بإلغاء قفل الجهاز. تشغيل وضع المطور؟ يظهر مربع الحوار.
- اضغط على تشغيل . يمكنك الآن تشغيل تطبيقك والبدء في الاختبار.
إذا كنت تقوم بتثبيت توزيع Ad Hoc ، فستظهر هذه الرسالة عندما لا يقوم المطور بتكوين تطبيقه حتى الآن للتشغيل على جهاز الاختبار الخاص بك. لإتاحة التطبيق لك ، يجب على المطور إكمال التعليمات الموجودة في تسجيل أجهزة إضافية .
إذا لم يكن لدى حساب Google الخاص بك حق الوصول إلى تطبيق تجريبي قمت بتثبيته مسبقًا (أو قبلت دعوة) ، فمن المحتمل أنك سجلت الدخول إلى حساب Google غير صحيح. التطبيقات التي يمكنك الوصول إليها مرتبطة بحساب Google الذي استخدمته عندما قبلت الدعوة لأول مرة لاختبار التطبيق. حاول مرة أخرى عن طريق تسجيل الدخول باستخدام حساب Google الذي استخدمته مسبقًا لقبول الدعوة.
عندما تواجه خطأ 403 ، فهذا يعني أن الحساب الذي تستخدمه ليس لديه إذن لتثبيت التطبيقات واختبارها. يتم تحديد الوصول من قبل مسؤول مجال حسابك في Google Workspace.
إذا كنت تعتقد أنه يجب أن يكون لديك إذن لتثبيت التطبيقات واختبارها ، فاطلب من مسؤول حساب Google Workspace تغيير إعدادات حسابك. يجب أن يتبع المسؤول الإرشادات الواردة في إدارة الوصول إلى الخدمات التي لا يتم التحكم فيها بشكل فردي .
إذا كان لديك حسابات متعددة ، فحاول تسجيل الدخول بحساب مختلف غير مقيد بتثبيت التطبيقات واختبارها.
تمكين التنبيهات داخل التطبيق باستخدام App Distribution iOS SDK
استخدم النصائح التالية لاستكشاف المشكلات التي تتضمن تمكين تنبيهات الإنشاء الجديدة داخل التطبيق باستخدام App Distribution iOS SDK.
إذا كنت قد أعددت بالفعل App Distribution iOS SDK في تطبيقك ولا يتلقى المختبرين تنبيهات داخل التطبيق ، فتحقق للتأكد من أن تطبيقك يجلب الإصدارات الجديدة:
قم بتمكين وضع التصحيح في تطبيقك. لمعرفة الكيفية ، راجع وثائق Google Analytics .
شغّل تطبيقك في جهاز محاكاة وابحث عن السلسلة "[Firebase / AppDistribution]".
تحقق من أن المختبِر لديه حق الوصول إلى الإصدار الجديد:
إذا تم إرجاع كائن تحرير صالح ، فمن المحتمل أن هناك مشكلة في دورة حياة عرض وحدة التحكم حيث يتم تحميل مربع حوار التنبيه قبل ظهور العرض.
إذا لم يتم إرجاع أي إصدار ، فقد لا يكون المختبِر مرتبطًا بالإصدار الجديد بعد. في لوحة معلومات توزيع التطبيق لوحدة تحكم Firebase ، تأكد من أن المُختبِر مُدرج في توزيع الإصدار الخاص بك وأنه في حالة "مقبول" .
إذا كان المُختبِر لا يزال لا يتلقى التحديثات ، فاطلب منه اتباع النصائح أدناه للتأكد من قبوله للدعوة لاختبار تطبيقك ومن إعداد جهاز الاختبار الخاص به بشكل صحيح:
على جهاز الاختبار ، سجّل الدخول إلى مقطع الويب Firebase App Distribution. تذكر تحديد حساب Google الذي استخدمته لأول مرة عند قبولك للدعوة لاختبار التطبيق.
تأكد من توفر إصدار التطبيق الجديد في مقطع الويب.
بشكل افتراضي ، يحتاج المختبرين إلى تسجيل الدخول إلى حساب Google الخاص بهم مرة واحدة فقط لتمكين تنبيهات الإنشاءات الجديدة ولتثبيت إصدارات جديدة. إذا طُلب من المختبرين تسجيل الدخول مرة أخرى بعد إغلاق التطبيق وإعادة فتحه ، فاتبع هذه النصائح للتأكد من إعداد تكوين توزيع التطبيق بشكل صحيح:
تحقق للتأكد من تمكين Firebase App Testers API. لمزيد من المعلومات ، راجع تمكين App Distribution Tester API .
ضمن قيود المفتاح ، تأكد من تضمين Firebase App Testers API في قائمة واجهات برمجة التطبيقات المسموح بها.
إذا قمت عادةً بمسح UserDefaults عند تسجيل الخروج ، فقد تقوم بمسح حالة المختبر. يخزن App Distribution علامة تشير إلى ما إذا كان المُختبِر قد قام بالفعل بتسجيل الدخول إلى التطبيق. لمزيد من المعلومات ، راجع مستودع GitHub .
أسئلة مكررة
يحتوي توزيع تطبيقات Firebase على حدود المُختبِرين التالية:
أضف 500 مختبِر بحد أقصى إلى مشروع Firebase
أضف 200 مختبِر كحد أقصى إلى مجموعة توزيع التطبيقات
لإضافة المزيد من المختبرين ، اطلب زيادة حد التكلفة.
لدى المختبرين 30 يومًا لقبول دعوة لاختبار التطبيق قبل انتهاء صلاحيته. عندما تكون الدعوة بعد 5 أيام من انتهاء صلاحيتها ، يظهر إشعار انتهاء الصلاحية في وحدة تحكم Firebase بجوار المُختبِر في الإصدار. يمكن تجديد الدعوة عن طريق إعادة إرسالها عبر القائمة المنسدلة في صف المختبر.
انظر تسجيل أجهزة إضافية .
تتم إزالة إصدارات التطبيق من توزيع التطبيقات في حالة حدوث أحد الشروط التالية:
- إصدار التطبيق أقدم من 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 هو ملف تعريف تكوين يسمح لتوزيع التطبيقات بما يلي:
سجل جهاز الاختبار عن طريق جمع معرف الجهاز الفريد (UDID). إذا كنت تختبر توزيعًا Ad Hoc ، فإن Firebase يرسل لمطور التطبيق بريدًا إلكترونيًا يتضمن UDID لجهاز الاختبار ، جنبًا إلى جنب مع إرشادات حول كيفية تضمين الجهاز في ملف تعريف التوفير للتطبيق بحيث يمكن اختبار الإصدار على جهازك.
قم بتثبيت مقطع ويب Firebase App Distribution على الشاشة الرئيسية لجهازك. يتيح لك مقطع الويب تثبيت جميع تطبيقات الاختبار والوصول إليها في مكان واحد. تتم إضافة التصميمات الجديدة التي تمت دعوتك لاختبارها تلقائيًا إلى مقطع الويب.
للحصول على تعليمات حول تثبيت ملفات تعريف التكوين على جهاز iOS الخاص بك ، راجع وثائق Apple .
إذا كنت أحد المختبرين ، فيمكنك الوصول إلى جميع تطبيقات الاختبار الخاصة بك باستخدام مقطع الويب Firebase App Distribution ، والذي تتم إضافته تلقائيًا إلى الشاشة الرئيسية لجهاز الاختبار الخاص بك عند تثبيت ملف تعريف Firebase. إذا كنت تختبر توزيع Ad Hoc ، فيجب عليك أولاً تثبيت ملف التعريف قبل أن تتمكن من اختبار التطبيق.
إذا كنت تختبر إحدى توزيعات المؤسسة ، فيمكنك تثبيت ملف التعريف يدويًا:
إذا لم تكن قد قمت بذلك بالفعل ، فقم بتسجيل الدخول إلى Google واقبل الدعوة.
ضمن تطبيقات الاختبار ، حدد التطبيق الذي تريد اختباره.
في الجزء العلوي الأيسر من صفحة التطبيق ، انقر فوق mobile_screen_share .
اتبع التعليمات المعروضة لتثبيت ملف تعريف Firebase.
لحذف حساب اختبار توزيع التطبيقات والبيانات المرتبطة به ، اتبع هذه الخطوات بالترتيب:
قم بزيارة https://appdistribution.firebase.google.com وقم بتسجيل الدخول باستخدام حساب Google الخاص بك.
في الجزء العلوي الأيسر ، انقر فوق ( إدارة الحساب )
حذف الحساب .
اختياري: في أذونات حساب Google الخاص بك ، قم بإلغاء الوصول من Firebase App Distribution. لاحظ أن إبطال الوصول دون حذف حساب توزيع التطبيقات الخاص بك أولاً لا يؤدي إلى حذف حساب المُختبِر أو بياناتك.
توفر هذه الصفحة تعليمات حول استكشاف الأخطاء وإصلاحها وإجابات للأسئلة المتداولة حول توزيع التطبيقات واختبارها باستخدام توزيع التطبيقات.
توزيع التطبيقات
استخدم النصائح التالية لاستكشاف المشكلات التي قد تواجهها عند توزيع التطبيقات على المختبرين وإصلاحها.
عند تحميل أحد التطبيقات ، قد تواجه هذا الخطأ:
"لم نتمكن من العثور على بريد إلكتروني لجهة اتصال للتطبيق <app-id> . يُرجى زيارة توزيع التطبيقات داخل وحدة تحكم Firebase لإعداد واحد."
عيّن بريدًا إلكترونيًا لجهة اتصال في وحدة تحكم Firebase ، إذا كان ذلك متاحًا. إذا استمرت المشكلة ، فاتصل بدعم Firebase .
إذا واجهت أخطاء 400 أو 409 أو 500 بشكل متكرر أثناء التوفير ، فاتصل بدعم Firebase . قدم الدعم برقم مشروع Firebase ومعرّف التطبيق.
فيما يلي مثال على استجابة شبكة المتصفح:
{
"status": "IN_PROGRESS",
"message": "There was an error processing your
distribution. Ensure you are uploading a valid IPA or APK and try again."
}
لحل هذه المشكلة ، اتبع الخطوات التالية:
تحقق من حجم IPA. الحد الأقصى لحجم الملف لجميع الثنائيات هو 2048 ميجابايت ، وهو ما يزيد قليلاً عن 2 جيجابايت.
إذا كان حجم IPA ضمن الحد الأقصى لحجم الملف وكان قابلاً للتكرار ، فاتبع الخطوات التالية:
تحقق من ملف
Info.plistوتأكد مما إذا كانCFBundleDisplayNameيحتوي على أي محددات<array>.أزل محددات
<array>وأعد إنشاء تطبيقك. يجب أن ينجح التحميل.إذا كنت لا تزال تواجه مشكلات ، فاتصل بدعم Firebase .
إذا تجاوز حجم IPA حد حجم الملف ، فقم بإجراء أي تغييرات ضرورية لتقليل حجم الملف.
إذا لم يؤد تقليل حجم ملف IPA إلى حل المشكلة ، فاتصل بدعم Firebase واسأل عن استخدام Testflight .
تثبيت واختبار التطبيقات
استخدم النصائح التالية لاستكشاف المشكلات التي قد يواجهها المختبِرون عند قيامهم بتثبيت واختبار تطبيقاتك.
عندما يقوم مستخدم بإنشاء حساب Google ، فإنه يتلقى تلقائيًا عنوان Gmail.
إذا لم يكن لدى المُختبِر مساحة Google Workspace أو عنوان Gmail ، أو إذا كان يفضل استخدام عنوان بريد إلكتروني آخر لتسجيل الدخول ، فاطلب من المُختبِر ربط عنوان بريد إلكتروني بخلاف Gmail بالحساب واستخدام هذا البريد الإلكتروني لتسجيل الدخول.
عند اختيار بريد إلكتروني بديل ، يجب على المختبر اتباع الإرشادات التالية:
- لا تستخدم عنوان Gmail.
- لا تستخدم عنوان بريد إلكتروني مرتبط بالفعل بحساب Google آخر.
- تذكر استخدام كلمة مرور حساب Google الخاص بك عند تسجيل الدخول باستخدام عنوان البريد الإلكتروني هذا.
لمزيد من المعلومات ، راجع تسجيل الدخول إلى حساب Google الخاص بك باستخدام عنوان بريد إلكتروني آخر .
إذا قبل المُختبِر الدعوة عبر البريد الإلكتروني باستخدام عنوان بريد إلكتروني مختلف عن الرسالة التي تم إرسال الدعوة إليها ، فقد لا يتمكن المُختبِر من رؤية التطبيقات أو الإصدارات الصحيحة.
يمكن أن يكون البريد الإلكتروني الذي يرسل المطور دعوات إليه ويضيفه إلى الإصدارات الجديدة (البريد الإلكتروني أ) مختلفًا عن البريد الإلكتروني الذي يستخدمه المُختبِر لقبول الدعوة (البريد الإلكتروني ب). هذا يخلق رابطًا وراء الكواليس. كلما تمت إضافة البريد الإلكتروني A إلى التصميمات الجديدة ، فإنه في الواقع يتم الوصول إلى البريد الإلكتروني B.
إذا قبل المُختبِر الدعوة عبر البريد الإلكتروني باستخدام عنوان بريد إلكتروني مختلف ، فاتبع هذه الخطوات لحل المشكلة:
احذف المختبر من قسم عرض جميع المختبرين في علامة التبويب المختبرون والمجموعات في صفحة توزيع التطبيق في وحدة تحكم Firebase. تتم إزالة الدعوات الموجودة.
أعد دعوة المختبر لاختبار تطبيقك. يجب أن يتلقى المختبر دعوة عبر البريد الإلكتروني.
تأكد من أن المختبر يقبل الدعوة بنفس عنوان البريد الإلكتروني.
قد لا يتلقى المختبِرون إشعارات بالبريد الإلكتروني في حالة حدوث أي مما يلي:
يتم إرسال إشعارات البريد الإلكتروني إلى مجلدات البريد العشوائي.
تم تعيين عوامل تصفية البريد الإلكتروني.
تم إرسال الدعوة إلى حساب بريد إلكتروني واحد ، لكن المُختبِر قبلها باستخدام حساب بريد إلكتروني مختلف. The tester receives new release emails for the email account to which the invitation was originally sent.
The tester was previously invited but did not accept the initial invitation. If the tester is added to subsequent releases, App Distribution won't automatically send release notifications to that tester because the tester didn't accept the initial invitation.
Solution 1
Ask the tester to check their spam folder and any email filters they set in their email service.
If the tester unsubscribed from the emails, ask the tester to do the following:
- Find an email that the tester previously received from the app.
- Click Manage email settings at the bottom and click Allow emails to resubscribe.
Solution 2
Delete the tester from the View all testers section of the Testers & Groups tab in the App Distribution page in the Firebase console. This action removes existing invitations.
Re-invite the tester to test your app. The tester should receive an invitation email. Make sure that the tester accepts the invitation with the same email address that the invitation was sent to.
The Untrusted Enterprise Developer error appears if you did not trust the developer certificate on the test device before opening the app. In the Settings app > Profiles & Device Management screen, select the app's developer name and trust it.
The Developer Mode Required error appears when you try to launch an ad hoc-provisioned iOS app on iOS 16 or later without first enabling Developer Mode.
To enable Developer Mode and resolve this error, follow these steps:
- On your iPhone, open the Settings app and then tap Privacy & Security .
- Scroll down to Security and tap Developer Mode .
- Tap the Developer Mode slider.
- Tap Restart .
- After the device restarts, unlock the device. The Turn on Developer Mode? dialog appears.
- Tap Turn On . You can now launch your app and start testing.
If you're installing an Ad Hoc distribution, this message appears when the developer hasn't yet configured their app to run on your test device. To make the app available to you, the developer must complete the instructions in Register additional devices .
If your Google account does not have access to a test app you previously installed (or accepted an invitation for), it's likely that you signed in to the wrong Google account. The apps to which you have access are associated with the Google account you used when you first accepted the invitation to test the app. Try again by signing in with the Google account you previously used to accept the invitation.
When you encounter a 403 error, this means that the account you're using doesn't have permission to install and test apps. Access is determined by the administrator of your account's domain in Google Workspace.
If you believe you should have permission to install and test apps, ask your Google Workspace account admin to change your account settings. Your admin should follow the instructions in Manage access to services that aren't controlled individually .
If you have multiple accounts, try logging in with a different account that is not restricted from installing and testing apps.
Enabling in-app alerts with the App Distribution iOS SDK
Use the following tips to troubleshoot issues that involve enabling in-app new build alerts using the App Distribution iOS SDK.
If you have already set up the App Distribution iOS SDK in your app and your testers aren't receiving in-app alerts, check to make sure your app is fetching new releases:
Enable debug mode in your app. To learn how, see the Google Analytics documentation .
Run your app in a simulator and search for the string "[Firebase/AppDistribution]".
Check that the tester has access to the new release:
If a valid release object is returned, it's likely that there's an issue in the View Controller lifecycle where the alert dialog is loaded before the View appears.
If no release is returned, your tester may not yet be associated with the new release. In the App Distribution dashboard of the Firebase console, make sure your tester is included in your build distribution and is in the Accepted state.
If your tester still isn't receiving updates, ask them to follow the tips below to make sure they accepted the invitation to test your app and that they set up their testing device properly:
On the test device, sign into the Firebase App Distribution web clip. Remember to select the Google account you first used when you accepted the invitation to test the app.
Make sure that the new app release is available in the web clip.
By default, your testers only need to sign in to their Google account once to enable new build alerts and to install new builds. If your testers are being prompted to sign in again after closing and re-opening your app, follow these tips to make sure your App Distribution configuration is set up properly:
Check to make sure you've enabled the Firebase App Testers API. For more information, see Enable the App Distribution Tester API .
Under Key restrictions , make sure that the Firebase App Testers API is included in the list of allowed APIs.
If you typically clear UserDefaults on signing out, you may be clearing your tester's state. App Distribution stores a flag that indicates whether your tester has already signed into the app. For more information, see the GitHub repository .
Frequently asked questions
Firebase App Distribution has the following tester limits:
Add a maximum of 500 testers to a Firebase project
Add a maximum of 200 testers to an App Distribution group
To add more testers, request a no-cost limit increase .
Testers have 30 days to accept an invitation to test the app before it expires. When an invitation is 5 days from expiring, an expiration notice appears in the Firebase console next to the tester on a release. An invitation can be renewed by resending it via the drop-down menu on the tester row.
See Register additional devices .
App releases are removed from App Distribution if one of the following conditions occurs:
- The app release is older than 150 days.
- You exceed the 1,000 app release limit, and the app release is older than the 1,000 most recent app releases.
For more information, see App Distribution supports a maximum of 1,000 releases .
After the app reaches or exceeds the 150-day expiration limit or the 1,000 app release limit, the release is removed from the App Distribution dashboard and the App Distribution tester web app. If your tester has installed the release, the local version of the app continues to run.
To keep the app release available longer, use one of the following recommendations:
- Before the app release expires or exceeds the release limit, download the IPA and delete the release from the App Distribution dashboard. Then, re-upload the IPA as a new build to App Distribution.
- Download the release and upload it to Cloud Storage for long-term archiving.
App releases expire after 150 days
When you upload a release of your app to Firebase, the release appears in the App Distribution dashboard for 150 days, starting from the upload date. After you upload the release, you can distribute it to testers, who install the release from the App Distribution tester web app on their testing device.
When the release is 30 days from the expiration date, an app release expiration notification appears on your release in the App Distribution page of the Firebase console and in the App Distribution tester web app.
App Distribution supports a maximum of 1,000 releases
App Distribution allows a maximum of 1,000 releases per app. When your app reaches the 1,000 app release limit, App Distribution automatically deletes the oldest releases above the limit.
If you want to manually manage your app releases, use the App Distribution REST API to list and delete app releases in bulk.
If you have questions, contact Firebase Support .
The Firebase profile is a configuration profile that allows App Distribution to:
Register the test device by collecting the device's unique device ID (UDID). If you're testing an Ad Hoc distribution, Firebase sends the app developer an email that includes the test device's UDID, along with instructions on how to include the device in the app's provisioning profile so that the build can be tested on your device.
Install a Firebase App Distribution web clip to your device's home screen. The web clip allows you to install and access all your test apps in one place. New builds you're invited to test are automatically added to the web clip.
For help on installing configuration profiles on your iOS device, refer to Apple's documentation .
If you're a tester, you can access all of your test apps with the Firebase App Distribution web clip , which is automatically added to your test device's home screen when you install the Firebase profile. If you're testing an Ad Hoc distribution, you must first install the profile before you can test the app.
If you're testing an Enterprise distribution, you can manually install the profile:
If you haven't already, sign in to Google and accept the invitation.
Under Test apps , select the app you want to test.
In the top right of the app's page, tap mobile_screen_share .
Follow the instructions displayed to install the Firebase profile.
To delete your App Distribution tester account and its associated data, follow these steps in order:
Visit https://appdistribution.firebase.google.com and sign in with your Google account.
In the top-right, click ( Manage account )
Delete account .
Optional: In your Google account permissions , revoke access from Firebase App Distribution. Note that revoking access without first deleting your App Distribution account does not delete your tester account or data.