إجراء اختبارات مبرمَجة (الإصدار 11 من نظام التشغيل Android أو الإصدارات الأحدث)

هناك خياران لتشغيل الاختبارات الآلية في مجموعة اختبارات التوافق:

• Trade Federation هو تطبيق وإطار عمل للاختبار يتيح لك إجراء الاختبارات من سطر الأوامر. يسمح لك إطار العمل بشكل أساسي بإضافة تعليقات توضيحية إلى الاختبارات باستخدام التعليق التوضيحي @Test، ويجد التطبيق هذه الاختبارات ويُشغّلها.

• ‫OmniLab Android Test Station هو تطبيق يتيح لك إجراء الاختبارات في واجهة مستخدم رسومية.

توضّح هذه الصفحة كيفية إجراء اختبارات مبرمَجة باستخدام Trade Federation. للحصول على تعليمات حول إجراء الاختبارات باستخدام OmniLab Android Test Harness، يُرجى الاطّلاع على محطة اختبار OmniLab Android.

تشغيل جميع اختبارات CTS المبرمَجة

يحتوي Trade Federation على وحدة تحكّم CTS، وهي واجهة سطر أوامر لتنفيذ الاختبارات. لتشغيل مجموعة أدوات اختبار التوافق (CTS) المبرمَجة بالكامل، اتّبِع الخطوات التالية:

1. تأكَّد من اتّباع التعليمات الواردة في إعداد الاختبار الآلي المتوافق مع CTS.

2. على محطة عمل الاختبار، شغِّل وحدة تحكّم CTS عن طريق تنفيذ النص البرمجي cts-tradefed من المجلد الذي تم فك ضغط حزمة CTS فيه:

   ./android-cts/tools/cts-tradefed
   

   تعرض وحدة تحكّم CTS مؤشرًا لتتمكّن من كتابة أوامر CTS (cts-tradefed >).

3. تحتوي cts خطة الاختبار على جميع اختبارات CTS الآلية. نفِّذ الأمر التالي لتشغيل خطة الاختبار cts:

   run cts
   

   يتم تنفيذ اختبارات CTS المبرمَجة. ملاحظات:

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

   • عند تشغيل CTS، اضغط على ctrl+c لإيقاف وحدة تحكّم CTS الحالية ثم أعِد تشغيل وحدة تحكّم CTS.

   • لا يمكنك تشغيل إصدارات متعددة من CTS على مضيف واحد لأنّ كل إصدار يفتح باستخدام خادم رمز موقع جغرافي مفتوح (OLC) حالي.

4. عرض نتائج الاختبار لمزيد من المعلومات، اطّلِع على تفسير نتائج CTS.

5. إذا كانت هذه هي المرة الأولى التي تجري فيها اختبارًا، قد يتعذّر إجراء بعض الاختبارات بسبب مشاكل خارجة عن سيطرتك. على سبيل المثال، قد يكون الاتصال بالشبكة بطيئًا أو قد تكون إشارة نظام تحديد المواقع العالمي (GPS) ضعيفة. أعِد تنفيذ (محاولة) الاختبارات إلى أن يتم إكمال جميع وحدات الاختبار وتتطابق أعداد حالات تعذُّر الاختبار بين آخر جلستَي إعادة محاولة:

   run retry --retry session_number`
   

6. بعد أن تصبح حالات تعذُّر الاختبار متسقة في جميع المحاولات، ركِّز على تصحيح الأخطاء في الاختبارات المتبقية التي تعذّر إجراؤها. للحصول على معلومات حول تحديد المشاكل وحلّها في نتائج الاختبار، يُرجى الاطّلاع على تحديد المشاكل وحلّها في اختبارات Triage وتحديد المشاكل وحلّها في اختبارات CTS.

تشغيل مجموعة اختبار التوافق (CTS) للأجهزة المتعددة الشاشات

إذا كان جهازك يعمل بالإصدار 11 أو 12 من نظام التشغيل Android ويتضمّن شاشات متعدّدة، عليك تنفيذ خطة الاختبار cts-foldable بشكل منفصل:

run cts-foldable

تتم إضافة حالات الاختبار الناجحة أو غير الناجحة لوضع الشاشة البديل مع القيمة من display_mode، مثل testcase1[display_mode=0].

إجراء اختبارات على أجهزة متعددة (الإصدار 15 من نظام التشغيل Android أو الإصدارات الأقدم)

نفِّذ الأمر التالي لتشغيل خطة اختبار cts-multidevice:

run cts-multidevice

تنفيذ خطط اختبار فردية

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

1. حدِّد اسم خطة الاختبار التي تريد تنفيذها من خلال تنفيذ الأمر list modules.

2. نفِّذ خطة الاختبار:

   run cts --plan test_module_or_plan_name
   

تحسين وقت تنفيذ الاختبار

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

لتقسيم الاختبارات على Android 11 أو إصدار أحدث، نفِّذ ما يلي:

run cts --shard-count number_of_shards

بالإضافة إلى ذلك، قبل إجراء اختبارات التحقّق، يمكنك تحسين وقت تنفيذ الاختبار من خلال استخدام الأمر run cts-dev في مجموعة اختبار التوافق (CTS). يتخطّى هذا الأمر الشروط المسبقة وجمع معلومات الجهاز وجميع أدوات التحقّق من حالة النظام. ويتم أيضًا تنفيذ الاختبارات على واجهة ABI واحدة فقط.