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

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>.

      ملاحظة: لا تقبل App Distribution قيم CFBundleDisplayName التي هي الصفائف.

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

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

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

4. إذا لم يؤد تقليل حجم ملف IPA إلى حل المشكلة، اتصل بـ دعم Firebase والسؤال عن استخدام اختبار الطيران:

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

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

لا يملك المختبِر حسابًا على 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.

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

الحلّ 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 حزمة تطوير البرامج (SDK) لنظام التشغيل iOS

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

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

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

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

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

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

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

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

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

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

     1. على الجهاز الاختباري، سجِّل الدخول إلى تطبيق 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. وإذا ثبَّت المختبِر الإصدار، سيستمر تشغيل الإصدار على الجهاز.

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

• عليك تنزيل عنوان IPA وحذف الإصدار من لوحة بيانات 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. إذا كنت تختبر توزيع مخصص، يجب أولاً تثبيت الملف الشخصي قبل اختبار التطبيق.

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

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

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

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

4. اتّبِع التعليمات المعروضة لتثبيت الملف الشخصي على Firebase.

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

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

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

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

   حذف الحساب

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