استكشاف الأخطاء وإصلاحها في Test Lab & الأسئلة الشائعة

تقدّم هذه الصفحة مساعدة في تحديد المشاكل وحلّها وإجابات عن الأسئلة الشائعة حول إجراء الاختبارات باستخدام Firebase Test Lab. يتم أيضًا توثيق المشاكل المعروفة. إذا لم تتمكّن من العثور على ما تبحث عنه أو كنت بحاجة إلى مساعدة إضافية، انضم إلى القناة ‎#test-lab على Firebase Slack أو تواصَل مع فريق دعم Firebase.

تحديد المشاكل وحلّها

لماذا يستغرق تنفيذ الاختبار وقتًا طويلاً؟

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

قد تستغرق الاختبارات التي يتم إجراؤها على أي مستوى من مستويات سعة الجهاز وقتًا أطول بسبب العوامل التالية:

• حجم الزيارات، ما يؤثر في مدى توفّر الأجهزة وسرعة الاختبار
• أعطال الأجهزة أو البنية الأساسية، والتي يمكن أن تحدث في أي وقت لمعرفة ما إذا كانت هناك بنية أساسية تم الإبلاغ عنها في Test Lab، يُرجى الاطّلاع على لوحة بيانات الحالة في Firebase.

لمزيد من المعلومات عن سعة الجهاز في Test Lab، راجِع معلومات سعة الجهاز لنظامَي التشغيل Android وiOS.

لماذا تظهر نتائج اختبار غير حاسمة؟

تحدث نتائج الاختبار غير الحاسمة عادةً بسبب إلغاء عمليات الاختبار أو حدوث أخطاء في البنية الأساسية.

تحدث أخطاء البنية الأساسية بسبب مشاكل داخلية في Test Lab، مثل أخطاء الشبكة أو السلوكيات غير المتوقعة للأجهزة. تتوقّف Test Lab داخليًا عن إعادة تشغيل الاختبارات التي تؤدي إلى حدوث أخطاء في البنية الأساسية عدة مرات قبل تسجيل نتيجة غير حاسمة، ولكن يمكنك إيقاف عمليات إعادة التشغيل هذه باستخدام failFast.

لتحديد سبب الخطأ، اتّبِع الخطوات التالية:

1. تحقَّق من حالات انقطاع الخدمة المعروفة في لوحة بيانات حالة Firebase.

2. أعِد إجراء الاختبار في Test Lab للتأكّد من إمكانية تكراره.

   ملاحظة: لا يفرض Test Lab رسومًا على أخطاء البنية الأساسية.

3. جرِّب إجراء الاختبار على جهاز آخر أو نوع جهاز آخر، إذا كان ذلك منطبقًا.

في حال استمرار المشكلة، يُرجى التواصل مع فريق Test Lab في القناة ‎#test-lab على Firebase Slack.

لماذا أدّى التقسيم إلى أجزاء إلى استغراق الاختبارات وقتًا أطول؟

يمكن أن يؤدي التقسيم إلى تشغيل اختباراتك لفترة أطول عندما يتجاوز عدد الأجزاء الذي حدّدته عدد الأجهزة المتاحة للاستخدام في Test Lab. لتجنُّب هذه الحالة، جرِّب التبديل إلى جهاز آخر. لمزيد من المعلومات حول اختيار جهاز مختلف، يُرجى الاطّلاع على سعة الجهاز.

لماذا يستغرق بدء الاختبار وقتًا طويلاً؟

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

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

ملاحظة: لا يُحتسب الوقت الذي يستغرقه الاختبار في انتظار توفّر جهاز ضمن وقت الفوترة.

لماذا يستغرق إكمال الاختبار وقتًا طويلاً؟

بعد انتهاء تنفيذ الاختبار، يتم تنزيل عناصر الاختبار من الجهاز ومعالجتها وتحميلها إلى Cloud Storage. يمكن أن تتأثر مدة هذه الخطوة بكمية وحجم العناصر.

تحديد المشاكل وحلّها في أجهزة Android

التطبيق لا يعرض البيانات ويتعذّر العثور على لقطات الشاشة

يتم تخزين عناصر تنفيذ الاختبار (مثل لقطات الشاشة وملفات السجلّ) في Google Cloud Storage وعرضها مباشرةً في وحدة تحكّم Firebase. إذا تم تنفيذ الاختبار خلال آخر 90 يومًا، تأكَّد من أنّك قد خصّصت أدوارًا على مستوى المشروع (مالك المشروع أو محرّر المشروع أو مطلع على المشروع). يُرجى أيضًا التأكّد من عدم تفعيل خدمة Cloud Audit Logging لمشروعك أو مؤسستك.

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

للاحتفاظ بعناصر الاختبار لفترة أطول، نفِّذ الأمر gcloud firebase test android run مع العلامة --results-bucket وأدخِل اسم مجموعة النتائج. لمزيد من المعلومات، يُرجى الاطّلاع على المستندات المرجعية الخاصة بـ gcloud firebase test android run.

لماذا أتلقّى نتائج جزئية أو غير متوفّرة لحالات اختبار الأدوات؟

عند تشغيل اختبارات الأجهزة، قد تظهر لك أخطاء في الاختبار تشير إلى نتائج جزئية تتضمّن رسائل مثل Test run failed to complete. Expected x tests, received y (حيث y أقل من x). يشير هذا الخطأ إلى أنّه تعذّر على Test Lab تحليل logcat بحثًا عن علامات بدء أو انتهاء حالة الاختبار التي يتم إنشاؤها عادةً بواسطة AndroidJUnitRunner.

في ما يلي الأسباب الشائعة لهذه المشكلة:

وصف المشكلة	الدقة المحتملة
لم يتم تنفيذ حالة الاختبار بسبب انتهاء المهلة. إذا كانت المدة الإجمالية للاختبارات أطول من المهلة التي حدّدتها أو أطول من المهلة القصوى، ستلغي Test Lab بقية حالات الاختبار.	يمكنك زيادة المهلة المحدّدة للمصفوفة للتأكّد من إمكانية إكمال جميع الاختبارات. قسِّم الاختبارات إذا لم يسبق لك إجراء ذلك، حتى يتمكّن كل قسم من تشغيل مجموعة فرعية من الاختبارات وإكمالها في فترة زمنية أقصر. إذا سبق لك تفعيل التقسيم، عليك زيادة عدد الأجزاء.
تعذّر إكمال حالة الاختبار بسبب الخروج منها قبل الأوان أو تعذّر إكمالها. قد تنتهي حالة الاختبار قبل الأوان بسبب استثناء لم يتم رصده أو خطأ في التأكيد. قد تتعطّل حالات الاختبار في حلقة لا نهائية أو قد يتعذّر مواصلتها، مثلاً إذا لم يعرض التطبيق طريقة العرض الصحيحة وتعذّر على حالة الاختبار تنفيذ الإجراء على واجهة المستخدم.	راجِع الفيديو وlogcat للتحقّق من النقطة التي توقّف عندها الاختبار.
تعطَّل برنامج تشغيل الاختبار المخصّص (بما في ذلك توسيع AndroidJUnitRunner) بشكل غير متوقّع أو كتب علامات بدء أو انتهاء لحالة الاختبار غير متوقّعة في logcat.	تحقَّق من رمز مشغّل الاختبار.
تمت كتابة سجلّات مفرطة في logcat، ما أدى إلى إرهاق المخزن المؤقت أو تعطُّل عملية logcat.	تقليل عمليات الكتابة إلى logcat
تعطّل التطبيق قيد الاختبار.	تصحيح أخطاء تطبيقك

---

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

ما هي الحصص النسبية بدون تكلفة لـ Test Lab؟ ماذا أفعل إذا نفدت المساحة؟

توفّر Firebase Test Lab حصصًا بدون تكلفة للاختبار على الأجهزة ولاستخدام واجهات برمجة التطبيقات على السحابة الإلكترونية. يُرجى العِلم أنّ حصة الاختبار تستخدم خطة الأسعار العادية في Firebase، بينما لا تستخدم حصص Cloud API خطة الأسعار العادية.

• حصة الاختبار

  يتم تحديد حصص الاختبارات حسب عدد الأجهزة المستخدَمة لتنفيذ الاختبارات. تتضمّن "خطة Spark" من Firebase حصة اختبار ثابتة بدون أي تكلفة على المستخدمين. بالنسبة إلى خطة Blaze، قد تزيد حصصك إذا زاد استخدامك لخدمة Google Cloud بمرور الوقت. إذا بلغت حصة الاختبار، عليك الانتظار حتى اليوم التالي أو الترقية إلى خطة Blaze إذا كنت تستخدم خطة Spark حاليًا. إذا كنت مشتركًا في خطة Blaze، يمكنك طلب زيادة الحصة. لمزيد من المعلومات، يُرجى الاطّلاع على حصة الاختبار.

  يمكنك تتبُّع استخدام حصة الاختبار في وحدة تحكّم Google Cloud.

• حصة Cloud Testing API

  تتضمّن Cloud Testing API حدّين للحصة: عدد الطلبات في اليوم لكل مشروع، وعدد الطلبات كل 100 ثانية لكل مشروع. يمكنك مراقبة استخدامك في وحدة تحكّم Google Cloud.

• حصة Cloud Tool Results API

  تتضمّن واجهة برمجة التطبيقات Cloud Tool Results API حدّين للحصة: عدد طلبات البحث في اليوم لكل مشروع، وعدد طلبات البحث كل 100 ثانية لكل مشروع. يمكنك مراقبة استخدامك في وحدة تحكّم Google Cloud.

  يُرجى الاطّلاع على حصص Cloud API في Test Lab للحصول على مزيد من المعلومات حول حدود واجهة برمجة التطبيقات. في حال بلوغ حصة واجهة برمجة التطبيقات:

  • يمكنك إرسال طلب للحصول على حصص أعلى من خلال تعديل حصصك مباشرةً في وحدة تحكّم Google Cloud (يُرجى العِلم أنّ معظم الحدود يتم ضبطها على الحدّ الأقصى تلقائيًا)، أو

  • يمكنك طلب حصص أعلى لواجهة برمجة التطبيقات من خلال ملء نموذج طلب في Google Cloud وحدة التحكّم أو من خلال التواصل مع فريق دعم Firebase.

كيف يمكنني معرفة ما إذا كانت الزيارات التي تصل إلى الخلفية تأتي من Test Lab؟

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

هل تعمل Test Lab مع VPC-SC؟

لا يتوافق Test Lab مع خدمة VPC-SC التي تحظر نسخ التطبيقات وغيرها من عناصر الاختبار بين مساحة التخزين الداخلية في Test Lab وحِزم نتائج المستخدمين.

كيف يمكنني رصد الاختبارات غير الموثوقة في Test Lab؟

لرصد السلوك غير الثابت في اختباراتك، ننصحك باستخدام الخيار --num-flaky-test-attempts . تتم محاسبة عمليات إعادة تشغيل الاختبارات غير المستقرة أو يتم احتسابها ضمن حصتك اليومية مثل عمليات تنفيذ الاختبارات العادية.

يرجى الإحاطة علمًا بالتالي:

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

ملاحظة: أخطاء البنية الأساسية مستقلة عن ميزة إزالة التشويش ولا تؤدي إلى إعادة تشغيل الاختبارات.

الأسئلة الشائعة المتعلّقة بنظام التشغيل iOS

هل تتوافق Test Lab مع Appium أو Flutter/FlutterDriver أو ReactNative/Jest أو Cucumber؟

على الرغم من أنّ بعض هذه العناصر مدرَج في خطة العمل، لا يمكننا حاليًا تقديم تعهّد بتوفير الدعم لمنصات الاختبار وتطوير التطبيقات هذه.

أين يمكنني العثور على تفاصيل الجهاز، مثل الدقة وما إلى ذلك؟

تتوفّر معلومات تفصيلية عن الجهاز من خلال واجهة برمجة التطبيقات ويمكن الوصول إليها من عميل gcloud باستخدام الأمر describe:

gcloud firebase test ios models describe MODEL

هل يمكنني استخدام التقسيم مع اختبارات iOS؟

لا تتوفّر ميزة التقسيم بشكلٍ أصلي في Test Lab على أجهزة iOS. ومع ذلك، يمكنك استخدام برنامج Flank لتقسيم حالات الاختبار على أجهزة iOS.

ملاحظة: يؤدي استخدام تقسيم Flank على أجهزة iOS إلى إنشاء مصفوفات اختبار منفصلة لكل جزء.

يتم ذلك من خلال ضبط OnlyTestIdentifiers المفتاح والقيم في ملف .xctestrun. يُرجى الانتقال إلى صفحة man للاطّلاع على xcodebuild.xctestrun لمزيد من التفاصيل.

لماذا لا تظهر فيديوهات في نتائج اختبار iOS؟

بالنسبة إلى الإصدار 18 من نظام التشغيل iOS أو الإصدارات الأحدث، لا يمكننا عرض فيديوهات في النتائج.

الأسئلة الشائعة حول Android

هل يتوافق تطبيق Test Lab مع الأجهزة القابلة للارتداء؟

نعم. تتوافق شبكة Test Lab مع ساعة Google Pixel Watch. يمكنك الآن إجراء اختبارات على تطبيق Wear OS المستقل على ساعات Google Pixel Watch. لمزيد من المعلومات حول Test Lab الأجهزة، راجِع الاختبار على الأجهزة المتاحة.

هل يتوافق Test Lab مع أحدث أجهزة Google؟

نعم. يتوافق تطبيق Test Lab مع Google Pixel Tablet وGoogle Pixel Fold. يمكنك إجراء الاختبارات على أجهزتك الفعلية المستقلة. لمزيد من المعلومات حول Test Lab الأجهزة، راجِع الاختبار على الأجهزة المتاحة.

كيف يمكنني رصد اختبار قيد التنفيذ في Test Lab؟

إذا كنت تختبر تطبيقك في Firebase أو تجري اختبارات لتقرير الإطلاق التجريبي في Play Console، يمكنك رصد ما إذا كان يتم إجراء اختبار على جهاز مستضاف على Firebase من خلال البحث عن سمة النظام firebase.test.lab في ملف MainActivity. يمكنك بعد ذلك تنفيذ عبارات إضافية استنادًا إلى القيمة المنطقية لـ testLabSetting. لمزيد من المعلومات، يُرجى الاطّلاع على سلوكيات الاختبار المعدَّلة.

هل تتوافق Test Lab مع Appium أو Flutter/FlutterDriver أو ReactNative/Jest أو Cucumber؟

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

هل تتيح Test Lab اختبار التطبيقات التي تم تشويشها، مثلاً باستخدام ProGuard أو R8؟

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

هل يمكنني استخدام جهازي القابل للطي في أوضاع مختلفة أثناء الاختبار على Test Lab؟

نعم. يمكنك اختبار جهازك القابل للطي في حالاته وأوضاعه القابلة للطي.

يمكن أن تكون الأجهزة القابلة للطي في حالات طي مختلفة، مثل FLAT (مفتوح بالكامل) أو HALF_OPENED (بين الفتح الكامل والإغلاق التام).

أما أوضاع الجهاز، فتتألف من اتجاه الجهاز وحالته القابلة للطي. على سبيل المثال، وضعية سطح الطاولة، وهي حالة HALF_OPENED في الاتجاه الأفقي، أو وضعية الكتاب، وهي حالة HALF_OPENED في الاتجاه العمودي.

إذا كنت تجري اختبارات الأجهزة، يمكنك استخدام مكتبة Jetpack WindowManager واتّباع مستندات اختبار تطبيقك على الأجهزة القابلة للطي لإجراء الاختبار على حالات وأوضاع مختلفة.

بدلاً من ذلك، تكون الحالات المتاحة خاصة بالجهاز ويمكن التفاعل معها باستخدام adb shell command cmd device_state.

• لعرض الحالة الحالية، شغِّل الأمر adb shell cmd device_state state.
• لضبط الحالة الحالية أو تجاوزها، نفِّذ الأمر adb shell cmd device_state state <IDENTIFIER>.
• لإعادة ضبط الحالة، نفِّذ الأمر adb shell cmd device_state state reset.
• للاطّلاع على الحالات المتاحة، شغِّل الأمر adb shell cmd device_state print-states على الجهاز القابل للطي.

‫Google Pixel Fold (معرّف الطراز felix)

$ adb shell cmd device_state print-states
Supported states: [
    DeviceState{identifier=0, name='CLOSED', app_accessible=true},
    DeviceState{identifier=1, name='HALF_OPENED', app_accessible=true},
    DeviceState{identifier=2, name='OPENED', app_accessible=true},
    DeviceState{identifier=3, name='REAR_DISPLAY_STATE', app_accessible=true},
]

‫Samsung Galaxy Z Fold4 (معرّف الطراز q4q)

$ adb shell cmd device_state print-states
Supported states: [
    DeviceState{identifier=0, name='CLOSE', app_accessible=true},
    DeviceState{identifier=1, name='TENT', app_accessible=true},
    DeviceState{identifier=2, name='HALF_FOLDED', app_accessible=true},
    DeviceState{identifier=3, name='OPEN', app_accessible=true},
]

هل يمكنني تجربة Test Lab إذا لم يكن لديّ تطبيق؟

على عكس منتجات Firebase الأخرى، لا تحتاج إلى إضافة حزمة تطوير برامج (SDK) من Firebase لاستخدام Test Lab. إذا لم يكن لديك تطبيق، يمكنك تنزيل حزمة APK على الإنترنت أو إنشاء تطبيق وحزمة APK تجريبية من أحد النماذج في مستودع AndroidX GitHub. يُرجى العِلم أنّه لا تحتاج إلا إلى ملف APK الخاص بتطبيقك لتشغيل اختبار Robo، بينما يتطلّب اختبار الأجهزة كلاً من التطبيق وحزمة APK للاختبار يتم إنشاؤهما من رمز المصدر. لمزيد من المعلومات، اطّلِع على الاختبارات المزوّدة بأدوات.

لمزيد من المعلومات عن ميزات Test Lab، يُرجى الاطّلاع على مقالة بدء اختبار Android باستخدام Firebase Test Lab.

ما هي أفضل الأجهزة لإجراء اختبارات مقارنة لقطات الشاشة؟

اختبار مقارنة لقطات الشاشة هو اختبار تستند فيه تأكيدات الاختبار إلى مقارنة صور الشاشة التي تم الحصول عليها أثناء تنفيذ الاختبار بالصور الأساسية التي تمثّل السلوك المتوقّع. وقد تكون هذه الاختبارات أكثر هشاشة على بعض أنواع الأجهزة مقارنةً بأنواع أخرى. ننصح باستهداف أجهزة المحاكي التي تعمل بنظام التشغيل Arm (*.arm) لإجراء هذه الأنواع من الاختبارات. تستخدم أجهزة محاكي ARM صورًا مشابهة جدًا أو مطابقة لمحاكيات Android Studio "العامة".

ننصحك أيضًا بالبحث عن مكتبات اختبار يمكن أن تساعد في جعل اختبارات لقطات الشاشة أكثر فعالية في حال حدوث تغييرات متوقّعة.

هل يحدّث Test Lab الأجهزة الافتراضية؟

نعم. يتم تحديث الأجهزة الافتراضية عند إجراء التغييرات التالية:

1. تعديلات على الصور الحالية
2. إيقاف مستويات واجهة برمجة التطبيقات السابقة نهائيًا
3. تمت إضافة مستويات جديدة لواجهة برمجة التطبيقات في Android

كيف يمكنني تفعيل تقارير التغطية؟

لتفعيل تقارير التغطية، أضِف coverage=true إلى حقل environmentVariables. إذا كنت تستخدم "منسّق الاختبارات من Android"، عليك توفير دليل لتخزين نتائج التغطية:

--environment-variables coverage=true,coverageFilePath=/sdcard/Download/

إذا كنت لا تستخدم Orchestrator، يمكنك تحديد مسار ملف:

--environment-variables coverage=true,coverageFile=/sdcard/Download/coverage.ec

أين يمكنني العثور على تفاصيل الجهاز، مثل الدقة وواجهات التطبيق الثنائية المتوافقة وما إلى ذلك؟

تتوفّر معلومات تفصيلية عن الجهاز من خلال واجهة برمجة التطبيقات ويمكن الوصول إليها من عميل gcloud باستخدام الأمر describe:

gcloud firebase test android models describe MODEL

---

المشكلات المعروفة

اختبارات CAPTCHA لتسجيل الدخول

لا يمكن لاختبار Robo تجاوز شاشات تسجيل الدخول التي تتطلّب إجراءً إضافيًا من المستخدمين بخلاف إدخال بيانات الاعتماد لتسجيل الدخول، مثل إكمال اختبار CAPTCHA.

المشاكل المعروفة الخاصة بأجهزة iOS

تسجيل الدخول تلقائيًا

لا تتوفّر ميزة تسجيل الدخول تلقائيًا باستخدام حساب Google في اختبارات Robo على نظام التشغيل iOS+ (إصدار تجريبي).

المشاكل المعروفة الخاصة بنظام التشغيل Android

التوافق مع إطار عمل واجهة المستخدم

يعمل اختبار Robo بشكل أفضل مع التطبيقات التي تستخدم عناصر واجهة المستخدم من إطار عمل واجهة مستخدم Android (بما في ذلك الكائنات View وViewGroup وWebView). إذا كنت تستخدم اختبار Robo لتشغيل تطبيقات تستخدم أُطر عمل أخرى لواجهة المستخدم، بما في ذلك التطبيقات التي تستخدم محرك ألعاب Unity، قد يتوقف الاختبار بدون استكشاف ما بعد الشاشة الأولى.