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