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

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

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

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

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

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

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

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

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

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

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

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

  3. جرِّب إجراء الاختبار على جهاز أو نوع جهاز مختلفَين، إن أمكن.

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

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

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

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

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

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

إذا تم تنفيذ الإجراء قبل أكثر من 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.
تعطّل التطبيق قيد الاختبار. تصحيح أخطاء تطبيقك

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

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

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

    يتم تحديد حصص الاختبار حسب عدد الأجهزة المستخدَمة لإجراء الاختبارات. تتضمّن خطة Firebase Spark حصة ثابتة للاختبار بدون أي تكلفة للمستخدمين. بالنسبة إلى خطة 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.

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

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

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

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

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

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

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

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

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

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

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

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

أمّا الوضعيات، فهي تتألف من اتجاه جهاز معيّن وحالة folded (قابلة للطي). على سبيل المثال، وضع "على سطح الطاولة"، وهو حالة 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) ‫Samsung Galaxy Z Fold4 (رقم تعريف الطراز q4q)
$ 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},
]
$ 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},
]

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

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

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

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

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

  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

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

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

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