تحديد المشاكل وحلّها في ميزة "توزيع التطبيقات" والأسئلة الشائعة
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تقدم هذه الصفحة مساعدة في تحديد المشاكل وحلّها وإجابات عن الأسئلة الشائعة حول توزيع التطبيقات واختبارها باستخدام ميزة App Distribution.
توزيع التطبيقات
اتّبِع النصائح التالية لتحديد وحلّ المشاكل التي قد تواجهها عند توزيع التطبيقات إلى المختبِرين.
يتعذّر توزيع التطبيق بسبب عدم توفّر عنوان البريد الإلكتروني لجهة الاتصال.
عند تحميل أحد التطبيقات، قد يظهر لك الخطأ التالي:
"لم نتمكن من العثور على البريد الإلكتروني لجهة الاتصال للتطبيق <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."
}
لحلّ هذه المشكلة، اتّبِع الخطوات التالية:
تحقَّق من حجم IPA. ويبلغ الحدّ الأقصى لحجم الملف لكل البرامج الثنائية
2048 مبيبايت، وهو ما يزيد بقليل عن 2 غيغابايت.
إذا كان حجم IPA ضمن الحد المسموح به لحجم الملف وكان قابلاً للتكرار، اتّبع الخطوات التالية:
راجِع ملف Info.plist وتأكَّد مما إذا كان CFBundleDisplayName
يحتوي على أي محدِّدات لـ <array>.
عليك إزالة محدِّدات <array> وإعادة إنشاء تطبيقك. من المفترض أن تتم عملية التحميل بنجاح.
إذا تجاوز حجم IPA الحد المسموح به لحجم الملف، يمكنك إجراء أي تغييرات ضرورية لتقليل حجم الملف.
إذا لم يؤدِّ تقليل حجم ملف IPA إلى حلّ المشكلة، يُرجى التواصل مع
فريق دعم Firebase والاستفسار عن كيفية استخدام
TestFlight.
تثبيت التطبيقات واختبارها
اتّبِع النصائح التالية لتحديد وحلّ المشاكل التي قد يواجهها المختبِرون عند تثبيت تطبيقاتك واختبارها.
لا يملك المختبِر حسابًا على Google
عندما ينشئ المستخدم حساب Google، فإنه يتلقى عنوان Gmail تلقائيًا.
إذا لم يكن لدى أحد المختبرين عنوان على Google Workspace أو Gmail، أو إذا كان يفضّل استخدام عنوان بريد إلكتروني آخر لتسجيل الدخول، اطلب من المختبر ربط عنوان بريد إلكتروني غير تابع لـ Gmail بالحساب واستخدام هذا البريد الإلكتروني لتسجيل الدخول.
عند اختيار عنوان بريد إلكتروني بديل، على المختبِر اتباع الإرشادات التالية:
لا تستخدم عنوان Gmail.
لا تستخدم عنوان بريد إلكتروني مرتبط بحساب آخر على Google.
احرص على استخدام كلمة مرور حسابك على Google عند تسجيل الدخول باستخدام عنوان البريد الإلكتروني هذا.
عدم تمكّن المختبِر من الاطّلاع على التطبيقات أو الإصدارات الصحيحة
إذا قبِل المختبِر الدعوة عبر البريد الإلكتروني باستخدام عنوان بريد إلكتروني مختلف عن العنوان الذي تم إرسال الدعوة إليه، قد لا يتمكن المختبِر من الاطّلاع على التطبيقات أو الإصدارات المناسبة.
البريد الإلكتروني الذي يرسل إليه المطوّر دعوات ويضيفه إلى الإصدارات الجديدة (البريد الإلكتروني أ) يمكن أن يكون مختلفًا عن عنوان البريد الإلكتروني الذي يستخدمه المختبِر لقبول الدعوة (الرسالة الإلكترونية ب). يؤدي هذا إلى إنشاء رابط وراء الكواليس. كلما تمت إضافة البريد الإلكتروني أ إلى إصدارات جديدة، يكون في الواقع البريد الإلكتروني ب هو الذي يمكنه الوصول.
إذا قبِل المختبِر الدعوة عبر البريد الإلكتروني باستخدام عنوان بريد إلكتروني مختلف،
اتّبِع هذه الخطوات لحل المشكلة:
احذف تطبيق المختبِر من القسم عرض كل المختبِرين ضمن علامة التبويب المختبِرون والمجموعات في صفحة "توزيع التطبيقات" على "وحدة تحكُّم Firebase". تتم إزالة الدعوات الحالية.
يُرجى دعوة المختبِر مرة أخرى لاختبار تطبيقك. ومن المفترض أن يتلقّى المختبِر
دعوة عبر رسالة إلكترونية.
تأكَّد من قبول المختبِر للدعوة باستخدام عنوان البريد الإلكتروني نفسه.
لا يتلقّى المختبِر إشعارات عبر البريد الإلكتروني
قد لا يتلقّى المختبِرون إشعارات عبر البريد الإلكتروني في حال حدوث أي مما يلي:
يتم إرسال الإشعارات عبر البريد الإلكتروني إلى مجلدات الرسائل غير المرغوب فيها.
تم ضبط فلاتر البريد الإلكتروني.
تم إرسال الدعوة إلى أحد حسابات البريد الإلكتروني، ولكن المختبِر قبوله باستخدام حساب بريد إلكتروني مختلف. يتلقى المختبِر رسائل بريد إلكتروني للإصدار الجديد
لحساب البريد الإلكتروني الذي تم إرسال الدعوة إليه في الأصل.
وقد تمت دعوة المختبِر في وقت سابق، لكنه لم يقبل الدعوة الأولية.
إذا تمت إضافة المختبِر إلى إصدارات لاحقة، لن يرسل تطبيق App Distribution تلقائيًا إشعارات الإصدار إلى هذا المختبِر بسبب عدم قبوله الدعوة الأولية.
الحل 1
اطلب من المختبِر التحقق من مجلد الرسائل غير المرغوب فيها وأي فلاتر للبريد الإلكتروني تم ضبطها في خدمة البريد الإلكتروني.
إذا ألغى المختبِر الاشتراك في الرسائل الإلكترونية، اطلب منه إجراء ما يلي:
ابحث عن رسالة إلكترونية تلقّاها المختبِر في السابق من التطبيق.
انقر على إدارة إعدادات البريد الإلكتروني في أسفل الصفحة، وانقر على السماح بالرسائل الإلكترونية
لإعادة الاشتراك.
الحل 2
إذا كان المختبِر لا يهتم بتلقّي إشعارات عبر البريد الإلكتروني وكان يريد فقط قبول دعوات التطبيقات، يمكنه الاطّلاع على دعوات التطبيقات في انتظار المراجعة مباشرةً من مقطع الويب لميزة "توزيع تطبيقات Firebase":
appdistribution.firebase.google.com.
الحل 3
احذف تطبيق المختبِر من قسم عرض كل المختبِرين ضمن علامة التبويب المختبِرون والمجموعات في صفحة "توزيع التطبيقات" ضمن "وحدة تحكُّم Firebase". يؤدي هذا الإجراء إلى إزالة الدعوات الحالية.
يُرجى دعوة المختبِر مرة أخرى لاختبار تطبيقك. ومن المفترض أن يتلقّى المختبِر
دعوة عبر رسالة إلكترونية. تأكد من قبول المختبِر للدعوة باستخدام
عنوان البريد الإلكتروني نفسه الذي تم إرسال الدعوة إليه.
ظهور رسالة الخطأ "مطوّر مؤسسة غير موثوق به" عند محاولة تشغيل تطبيق تجريبي
يظهر الخطأ مطوّر برامج مؤسسة غير موثوق به إذا لم تثق بشهادة المطوّر على جهاز الاختبار قبل فتح التطبيق.
من تطبيق الإعدادات > شاشة الملفات الشخصية وإدارة الجهاز، اختَر اسم مطوِّر التطبيق والوثوق به.
ظهور رسالة الخطأ "وضع مطور البرامج مطلوب" عند محاولة تشغيل تطبيق تجريبي
يظهر الخطأ "مطلوب وضع مطور البرامج" عند محاولة تشغيل تطبيق iOS مُدار بشكل مخصّص على نظام التشغيل iOS 16 أو إصدار أحدث بدون تفعيل "وضع مطور البرامج" أولاً.
لتمكين وضع مطور البرامج وحل هذا الخطأ، اتبع الخطوات التالية:
على جهاز iPhone، افتح تطبيق "الإعدادات" ثم انقر على الخصوصية والأمان.
انتقِل للأسفل وصولاً إلى الأمان وانقر على وضع المطوِّر.
انقر على شريط التمرير وضع مطور البرامج.
انقر على إعادة التشغيل.
بعد إعادة تشغيل الجهاز، افتح قفل الجهاز. سيظهر مربع الحوار "هل تريد تشغيل وضع المطور؟"
انقر على تفعيل. يمكنك الآن إطلاق تطبيقك وبدء الاختبار.
"تم تسجيل الجهاز، وأنت جاهز الآن". ستتلقّى رسالة إلكترونية عندما يكون التطبيق جاهزًا للاختبار.
في حال تثبيت توزيع مخصّص، ستظهر هذه الرسالة إذا لم يضبط المطوّر تطبيقه للعمل على جهاز الاختبار بعد.
لإتاحة التطبيق لك، على المطوِّر إكمال التعليمات الواردة في تسجيل أجهزة إضافية.
لا يمكن لحساب Google الوصول إلى التطبيق التجريبي.
إذا كان حسابك على Google لا يمكنه الوصول إلى تطبيق تجريبي سبق لك تثبيته (أو قبل دعوة إليه)، فمن المحتمل أنك سجّلت الدخول إلى حساب Google غير صحيح. يتم ربط التطبيقات التي يمكنك الوصول إليها
بحساب Google الذي استخدمته عند قبول
الدعوة لاختبار التطبيق لأول مرة. يُرجى إعادة المحاولة عن طريق تسجيل الدخول باستخدام حساب Google
الذي استخدمته في السابق لقبول الدعوة.
الخطأ 403: "يُرجى التواصل مع المشرف للحصول على إذن الوصول"
عندما يظهر لك الخطأ 403، يعني هذا أنّ الحساب الذي تستخدمه لا يملك إذن تثبيت التطبيقات واختبارها. يحدّد مشرف نطاق حسابك في Google Workspace إمكانية الوصول.
إذا كانت لديك حسابات متعددة، جرِّب تسجيل الدخول باستخدام حساب مختلف لا يُحظر تثبيت التطبيقات واختبارها.
تفعيل التنبيهات داخل التطبيق باستخدام حزمة تطوير البرامج لنظام التشغيل iOS لتوزيع التطبيقات
اتّبِع النصائح التالية لتحديد وحلّ المشاكل التي تتضمّن
تفعيل تنبيهات الإصدارات الجديدة داخل التطبيق باستخدام حزمة تطوير البرامج (SDK) لنظام التشغيل iOS لتوزيع التطبيقات.
لا يتلقّى المختبِر تنبيهات داخل التطبيق
إذا سبق لك إعداد حزمة تطوير البرامج (SDK) لنظام التشغيل iOS لميزة "توزيع التطبيقات" في تطبيقك ولم يتلق المختبِرون تنبيهات داخل التطبيق، تحقَّق مما إذا كان التطبيق يجلب إصدارات جديدة:
فعِّل وضع تصحيح الأخطاء في تطبيقك. ولمعرفة كيفية إجراء ذلك، اطّلِع على
مستندات "إحصاءات Google".
شغِّل تطبيقك في محاكي وابحث عن السلسلة "[Firebase/AppDistributeion]".
تحقَّق من إمكانية وصول المختبِر إلى الإصدار الجديد:
في حالة إرجاع عنصر إصدار صالح، من المرجح أن تكون هناك مشكلة في دورة حياة وحدة التحكم في العرض، حيث يتم تحميل مربع حوار التنبيه قبل ظهور العرض.
في حال عدم عرض أي إصدار، قد لا يتم ربط المختبِر بعد بالإصدار الجديد. من خلال لوحة بيانات "توزيع التطبيقات" ضمن
وحدة تحكُّم Firebase، تأكَّد من أنّ المختبِر مشمول في توزيع الإصدار وأنّه في الحالة مقبول.
إذا كان المختبِر لا يتلقى تحديثات، فاطلب منه اتباع النصائح أدناه للتأكد من قبوله للدعوة لاختبار تطبيقك وأنه أعدّ جهاز الاختبار بشكل صحيح:
على الجهاز الاختباري، سجِّل الدخول إلى مقطع الويب لميزة "توزيع التطبيقات على Firebase". تذكر تحديد حساب Google الذي استخدمته لأول مرة
عند قبولك الدعوة لاختبار التطبيق.
تأكَّد من أنّ إصدار التطبيق الجديد متوفّر في مقطع الويب.
طلب المختبِر تسجيل الدخول مرة أخرى بعد إغلاق التطبيق
يحتاج المختبِرون تلقائيًا إلى تسجيل الدخول إلى حساباتهم على Google مرة واحدة فقط
لتفعيل تنبيهات الإصدارات الجديدة وتثبيت الإصدارات الجديدة. إذا طُلب من المُختبِرين تسجيل الدخول مرة أخرى بعد إغلاق التطبيق وإعادة فتحه، يُرجى اتّباع هذه النصائح للتأكّد من إعداد ضبط ميزة "توزيع التطبيقات" بشكلٍ صحيح:
ضمن القيود الرئيسية، تأكَّد من أنّ واجهة Firebase App Testers API مُدرَجة في قائمة واجهات برمجة التطبيقات المسموح بها.
إذا كنت تمحو UserDefaults عند تسجيل الخروج، قد يتم محو
حالة المختبِر. تخزِّن ميزة App Distribution علامة تشير إلى ما إذا كان المختبِر قد سجّل الدخول إلى التطبيق من قبل. لمزيد من المعلومات، يُرجى الاطّلاع على مستودع GitHub.
الأسئلة الشائعة
هل هناك حدود لإضافة المختبِرين إلى تطبيقي؟
تلتزم ميزة "توزيع التطبيقات من Firebase" بحدود المختبِرين التالية:
إضافة 500 مختبِر كحد أقصى إلى مشروع على Firebase
يمكنك إضافة 200 مختبِر كحد أقصى إلى مجموعة "توزيع التطبيقات"
لإضافة المزيد من المختبِرين، يمكنك طلب
زيادة الحد بدون تكلفة.
هل تنتهي صلاحية دعوات المختبِرين؟
ويكون لدى المختبِرين 30 يومًا لقبول الدعوة لاختبار التطبيق قبل انتهاء صلاحيته.
عندما تنتهي صلاحية الدعوة بعد 5 أيام من انتهاء صلاحيتها، يظهر إشعار انتهاء صلاحية في
وحدة تحكُّم Firebase بجانب المختبِر في أحد الإصدارات. يمكن تجديد الدعوة عن طريق إعادة إرسالها عبر القائمة المنسدلة في صف المختبر.
متى يتمّ إنشاء إصدار جديد لتحميله إلى نظام التشغيل iOS؟
بعد بلوغ التطبيق أو تجاوزه الحدّ الأقصى المسموح به وهو 150 يومًا أو 1,000 إصدار،
تتم إزالة الإصدار من لوحة بيانات App Distribution ومن تطبيق الويب
لاختبار ميزة App Distribution. وإذا ثبّت المختبِرون الإصدار، سيستمر تشغيل الإصدار المحلي
من التطبيق.
ولإبقاء إصدار التطبيق متاحًا لفترة أطول، استخدِم أحد الاقتراحات التالية:
قبل انتهاء صلاحية إصدار التطبيق أو تجاوزه، يمكنك تنزيل
بروتوكول IPA وحذف الإصدار من لوحة بيانات توزيع التطبيقات. بعد ذلك، أعِد تحميل IPA كإصدار جديد لميزة App Distribution.
نزِّل الإصدار وحمِّله على Cloud Storage للأرشفة على المدى الطويل.
تنتهي صلاحية إصدارات التطبيق بعد 150 يومًا.
عند تحميل إصدار من تطبيقك إلى Firebase، يظهر الإصدار في
لوحة بيانات توزيع التطبيقات
لمدة 150 يومًا، بدءًا من تاريخ التحميل. بعد تحميل الإصدار، يمكنك توزيعه على المختبِرين الذين يثبِّتون الإصدار من تطبيق الويب لاختبار ميزة App Distribution على جهاز الاختبار.
عندما يكون الإصدار بعد 30 يومًا من تاريخ انتهاء الصلاحية، يظهر إشعار
بانتهاء صلاحية إصدار التطبيق في صفحة "توزيع التطبيقات"
في وحدة تحكُّم Firebase وفي تطبيق الويب لأداة اختبار "توزيع التطبيقات".
تتوافق ميزة "توزيع التطبيقات" مع 1,000 إصدار كحد أقصى.
تسمح ميزة "توزيع التطبيقات" بتثبيت
1,000 إصدار كحد أقصى لكل تطبيق. وعندما يصل تطبيقك إلى 1,000 إصدار كحد أقصى،
تحذف ميزة "توزيع التطبيقات" تلقائيًا الإصدارات الأقدم
التي تجاوزت هذا الحد.
إذا كنت تريد إدارة إصدارات تطبيقك يدويًا، استخدِم واجهة برمجة التطبيقات App Distribution REST API
من أجل إدراج
إصدارات التطبيق وحذفها
بشكلٍ مجمّع.
الملف الشخصي في Firebase هو ملف شخصي للإعدادات يسمح لميزة App Distribution بما يلي:
يمكنك تسجيل جهاز الاختبار من خلال جمع رقم التعريف الفريد للجهاز (UDID). إذا كنت تختبر توزيعة مخصّصة، يرسِل Firebase رسالة إلكترونية إلى مطوِّر التطبيق تتضمّن المعرّف الفريد للجهاز الاختباري مع تعليمات حول كيفية تضمين الجهاز في الملف الشخصي لتوفير المتطلبات اللازمة للتطبيق كي يمكن اختبار الإصدار على جهازك.
ثبِّت مقطع ويب لميزة Firebase App Distribution على الشاشة الرئيسية لجهازك. يسمح لك مقطع الويب بتثبيت جميع التطبيقات التجريبية والوصول إليها من مكان واحد. إن التصميمات الجديدة التي تمت دعوتك لاختبارها تتم
إضافتها تلقائيًا إلى مقطع الويب.
للحصول على مساعدة بشأن تثبيت الملفات الشخصية للإعدادات على جهاز iOS، راجِع مستندات Apple.
كيف يمكنني الوصول إلى التطبيقات الاختبارية التي ثبَّتها على جهازي؟
إذا كنت مختبِرًا، يمكنك الوصول إلى جميع تطبيقاتك الاختبارية من خلال
مقطع الويب لميزة Firebase App Distribution، والذي تتمّ إضافته تلقائيًا إلى
الشاشة الرئيسية لجهاز الاختبار عند تثبيت الملف الشخصي في Firebase. إذا كنت تختبر توزيعًا مخصّصًا، يجب أولاً تثبيت الملف الشخصي قبل أن تتمكّن من اختبار التطبيق.
إذا كنت تختبر توزيعًا للمؤسسات،
يمكنك تثبيت الملف الشخصي يدويًا:
سجِّل الدخول إلى Google واقبل الدعوة، إذا لم يسبق لك إجراء ذلك.
ضمن التطبيقات التجريبية، اختَر التطبيق الذي تريد اختباره.
في أعلى يسار صفحة التطبيق، انقر على mobile_screen_share.
اتّبِع التعليمات المعروضة لتثبيت الملف الشخصي على Firebase.
كيف يمكنني حذف حساب الاختبار الخاص بي؟
لحذف حساب مختبِر App Distribution والبيانات المرتبطة به،
اتّبِع الخطوات التالية بالترتيب:
في أعلى يسار الصفحة، انقر على settings (إدارة الحساب).
حذف الحساب
اختياري: في أذونات حساب Google،
أبطل إمكانية الوصول من Firebase App Distribution. يُرجى ملاحظة أنّ إلغاء إمكانية الوصول بدون
حذف حساب App Distribution أولاً لا يؤدّي إلى حذف حساب المختبر أو بياناته.