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

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 مُدار شخصية يعمل بنظام التشغيل iOS 16 أو إصدار أحدث بدون تفعيل "المطوِّر" أولاً الوضع.

لتمكين وضع مطور البرامج وحل هذا الخطأ، اتبع الخطوات التالية:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

   • في حال عدم إرجاع أي إصدار، قد لا يتم ربط المختبِر بعد بـ للإصدار الجديد. في لوحة بيانات App Distribution من وحدة التحكّم Firebase، احرص على تضمين المختبِر في إصدارك وأن تكون في حالة مقبولة.

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

     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 تطبيق، وكان إصدار التطبيق أقدم من أحدث 1000 إصدار للتطبيق.

لمزيد من المعلومات، يُرجى الاطّلاع على مقالة 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 التطبيق عنوان بريد إلكتروني يتضمن معرف الجهاز الفريد (UDID) لجهاز الاختبار، إلى جانب تعليمات حول كيفية تضمين الجهاز في إدارة حسابات التطبيق حتى يمكن اختبار الإصدار على جهازك.

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

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

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

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

إذا كنت تختبر لتوزيع المؤسسة، يمكنك تثبيت الملف التجاري يدويًا:

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

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

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

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

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

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

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

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

   حذف الحساب

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