تحديد مشاكل توزيع التطبيقات وحلّها & الأسئلة الشائعة

iOS والإصدارات الأحدث Android

تقدّم هذه الصفحة مساعدة في تحديد المشاكل وحلّها وإجابات عن الأسئلة الشائعة حول توزيع التطبيقات واختبارها باستخدام 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."
}

لحلّ هذه المشكلة، اتّبِع الخطوات التالية:

1. تأكَّد من حجم ملف IPA. الحد الأقصى لحجم الملفات لجميع الملفات الثنائية هو 2048 ميغابايت، أي ما يزيد قليلاً عن 2 غيغابايت.

2. إذا كان حجم IPA ضمن الحد الأقصى لحجم الملف وكان قابلاً للتكرار، اتّبِع الخطوات التالية:

   1. تحقَّق من ملف Info.plist وتأكَّد مما إذا كان CFBundleDisplayName يحتوي على أيّ فواصل <array>.

      ملاحظة: لا يقبل "توزيع التطبيقات" قيم CFBundleDisplayName التي تكون مصفوفات.

   2. أزِل محدّدات <array> وأعِد إنشاء تطبيقك. من المفترض أن يتم تحميل التطبيق بنجاح.

   3. إذا كنت لا تزال تواجه مشاكل، يُرجى التواصل مع فريق دعم Firebase.

3. إذا كان حجم ملف IPA أكبر من الحد الأقصى المسموح به لحجم الملف، عليك إجراء أي تغييرات ضرورية ل تقليل حجم الملف.

4. إذا لم يؤدّ إلى حلّ المشكلة، يُرجى التواصل مع فريق دعم Firebase والاستفسار عن استخدام Testflight.

تثبيت التطبيقات واختبارها

اتّبِع النصائح التالية لتحديد المشاكل التي قد يواجهها المختبِرون عند تثبيت تطبيقاتك واختبارها وحلّها.

لا يملك المختبِر حسابًا على Google

عندما ينشئ مستخدم حسابًا على Google، يتلقّى تلقائيًا عنوان Gmail.

إذا لم يكن لدى المختبِر عنوان على Google Workspace أو Gmail، أو إذا كان يفضّل استخدام عنوان بريد إلكتروني آخر لتسجيل الدخول، اطلب منه ربط عنوان بريد إلكتروني غير Gmail بالحساب واستخدام هذا البريد الإلكتروني لتسجيل الدخول.

عند اختيار بريد إلكتروني بديل، يجب أن يتّبع المختبِر الإرشادات التالية:

• لا تستخدِم عنوان Gmail.
• لا تستخدِم عنوان بريد إلكتروني مرتبطًا فعليًا بحساب آخر على Google.
• تذكَّر استخدام كلمة مرور حسابك على Google عند تسجيل الدخول باستخدام عنوان البريد الإلكتروني هذا.

لمزيد من المعلومات، يُرجى الاطّلاع على مقالة تسجيل الدخول إلى حسابك على Google باستخدام عنوان بريد إلكتروني آخر.

لا يمكن للمختبِر الاطّلاع على التطبيقات أو النُسخ الصحيحة.

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

يمكن أن يختلف عنوان البريد الإلكتروني الذي يرسل إليه المطوِّر الدعوات ويضيفه إلى الإصدارات الجديدة (البريد الإلكتروني "أ") عن عنوان البريد الإلكتروني الذي يستخدمه المختبِر لقبول الدعوة (البريد الإلكتروني "ب"). يؤدّي ذلك إلى إنشاء رابط من وراء الكواليس. عند إضافة البريد الإلكتروني "أ" إلى الإصدارات الجديدة، يكون البريد الإلكتروني "ب" هو الذي يحصل على إذن الوصول.

إذا قبل المختبِر دعوة البريد الإلكتروني باستخدام عنوان بريد إلكتروني مختلف، اتّبِع الخطوات التالية لحلّ المشكلة:

1. حذف المختبِر من قسم عرض جميع المختبِرين في علامة التبويب المختبِرون والمجموعات في صفحة App Distribution وحدة تحكّم Firebase تتم إزالة الدعوات الحالية.

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

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

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

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

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

• تم ضبط فلاتر البريد الإلكتروني.

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

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

الحلّ 1

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

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

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

الحلّ 2

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

ملاحظة: للاطّلاع على دعوات التطبيقات في انتظار المراجعة، يجب أن يتطابق عنوان البريد الإلكتروني لحساب Google الذي يستخدمه المختبِر لتسجيل الدخول إلى المقتطف على الويب مع عنوان البريد الإلكتروني للمستلِم المُدرَج في الدعوة المُرسَلة من المطوّر.

الحلّ 3

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

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

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

يظهر الخطأ مطوّر مؤسسة غير موثوق به إذا لم تتم موثوقية شهادة المطوّر على الجهاز التجريبي قبل فتح التطبيق. في تطبيق الإعدادات > شاشة الملفات الشخصية وإدارة الأجهزة، اختَر اسم مطوّر التطبيق وثِق به.

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

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

لتفعيل "وضع المطوّر" وحلّ هذا الخطأ، اتّبِع الخطوات التالية:

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

"تم تسجيل الجهاز، اكتملت عملية الإعداد. ستصلك رسالة إلكترونية عندما يصبح التطبيق جاهزًا للاختبار".

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

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

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

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

يُرجى مراعاة ما يلي:

• قد لا يكون حساب Google الذي استخدمته لقبول الدعوة هو حساب Google نفسه الذي تم إرسال الدعوة إليه في الأصل.
• يمكن ربط حساب Google بأي عنوان بريد إلكتروني، وليس فقط العناوين التي تتضمن نطاقات Gmail أو G Suite. تعرَّف على كيفية تسجيل الدخول باستخدام عنوان بريد إلكتروني آخر.

خطأ 403: "يُرجى التواصل مع المشرف للحصول على إذن بالوصول"

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

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

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

تفعيل التنبيهات داخل التطبيق باستخدام حزمة تطوير البرامج App Distribution لنظام التشغيل iOS

اتّبِع النصائح التالية لتحديد المشاكل المتعلّقة بمحاولة تفعيل تنبيهات الإصدارات الجديدة داخل التطبيق باستخدام حزمة App Distribution SDK لنظام التشغيل iOS وحلّها.

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

إذا سبق لك إعداد حزمة تطوير البرامج (SDK) App Distribution لنظام التشغيل iOS في تطبيقك ولم يكن متعامِلو الاختبار يتلقّون تنبيهات داخل التطبيق، تأكَّد من أنّ تطبيقك يحصل على الإصدارات الجديدة:

1. فعِّل وضع تصحيح الأخطاء في تطبيقك. للتعرّف على كيفية إجراء ذلك، اطّلِع على مستندات "إحصاءات Google".

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

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

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

     ملاحظة: لا تعرِض حزمة تطوير البرامج (SDK) لنظام التشغيل iOS من App Distribution مربّع حوار تنبيه تلقائيًا. يجب تحديد كيفية عرض مربّع الحوار ومكانه في تطبيقك. لمزيد من المعلومات، اطّلِع على الإعدادات الأساسية للتنبيهات.

   • إذا لم يتم عرض أي إصدار، قد يعني ذلك أنّ المختبِر لم يتم ربطه بعد بالإصدار الجديد. في لوحة بيانات App Distribution فيconsole Firebase، تأكَّد من تضمين المختبِر في عملية distribution (توزيع) الإصدار وأنّ حالته هي Accepted (مقبول).

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

     1. على الجهاز الاختباري، سجِّل الدخول إلى webclip Firebase App Distribution. تذكَّر اختيار حساب Google الذي استخدمته لأول مرة عند قبول دعوة اختبار التطبيق.

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

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

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

• تأكَّد من تفعيل واجهة برمجة التطبيقات Firebase App Testers API. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة تفعيل واجهة برمجة التطبيقات App Distribution Tester API.

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

• إذا كنت عادةً ما تمحو UserDefaults عند تسجيل الخروج، قد يتم محو حالة المختبِر. يخزِّن App Distribution علامة تشير إلى ما إذا كان المختبِر قد سجّل الدخول إلى التطبيق من قبل. لمزيد من المعلومات، يُرجى الاطّلاع على مستودع GitHub.

الأسئلة الشائعة

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

تفرض Firebase App Distribution الحدود التالية على المختبِرين:

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

• إضافة 200 مختبِر كحدّ أقصى إلى مجموعة App Distribution

لإضافة المزيد من المختبِرين، يمكنك طلب زيادة الحدّ الأقصى بدون أي تكلفة.

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

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

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

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

ما هي مدة توفّر إصدارات التطبيق؟

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

• مرّ أكثر من 150 يومًا على إصدار التطبيق.
• إذا تجاوزت الحد الأقصى المسموح به وهو 1,000 إصدار تطبيق، وكان إصدار التطبيق أقدم من أقدم 1,000 إصدار من إصدارات التطبيق

لمزيد من المعلومات، يُرجى الاطّلاع على مقالة App Distribution يتيح 1,000 إصدار كحد أقصى.

بعد أن يصل التطبيق إلى الحد الأقصى لمدة انتهاء الصلاحية البالغ 150 يومًا أو يتجاوزه أو يصل إلى الحد الأقصى لعدد إصدارات التطبيق الذي يبلغ 1,000 إصدار، تتم إزالة الإصدار من لوحة بيانات App Distribution وتطبيق الويب الخاص بالمختبِر على App Distribution. وإذا ثبَّت المختبِر الإصدار، سيستمر تشغيل الإصدار على الجهاز.

لإبقاء إصدار التطبيق متاحًا لفترة أطول، يمكنك اتّباع أحد الاقتراحات التالية:

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

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

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

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

‫App Distribution تتيح 1,000 إصدار كحد أقصى

تسمح منصة App Distribution بحد أقصى 1,000 إصدار لكل تطبيق. وعندما يصل تطبيقك إلى الحد الأقصى البالغ 1,000 إصدار، تتم تلقائيًا إزالة App Distribution للإصدارات الأقدم التي تتجاوز الحدّ الأقصى.

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

إذا كانت لديك أي أسئلة، يُرجى التواصل مع فريق دعم Firebase.

ما هو الملف الشخصي على Firebase؟

الملف الشخصي على Firebase هو ملفّ إعدادات يسمح App Distribution بما يلي:

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

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

للحصول على مساعدة بشأن تثبيت ملفات الضبط على جهاز iOS، يُرجى الرجوع إلى مستندات Apple.

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

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

إذا كنت تختبِر إصدارًا من Enterprise، يمكنك تثبيت الملف الشخصي يدويًا:

1. سجِّل الدخول إلى Google واقبل الدعوة إذا لم يسبق لك إجراء ذلك.

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

3. في أعلى يسار صفحة التطبيق، انقر على .

4. اتّبِع التعليمات التي تظهر لتثبيت الملف الشخصي على Firebase.

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

لحذف حسابك كمختبِر على App Distribution والبيانات المرتبطة به، اتّبِع الخطوات التالية بالترتيب:

1. انتقِل إلى https://appdistribution.firebase.google.com وسجِّل الدخول باستخدام حسابك على Google.

2. في أعلى يسار الصفحة، انقر على (إدارة الحساب).

   حذف الحساب

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