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

هناك خياران لإجراء الاختبارات المبرمَجة في CTS:

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

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

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

تشغيل جميع اختبارات 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 المبرمَجة. ملاحظات:

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

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

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

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

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

   run retry --retry session_number`
   

   ملاحظة: للحصول على تفاصيل التنفيذ لإعادة المحاولة في CTS، يُرجى الاطّلاع على استخدام ميزة إعادة المحاولة في المجموعة.
   ملاحظة: للحصول على تعليمات حول كيفية تنفيذ جلسة إعادة محاولة على Android 10 أو إصدار أقل، يُرجى الاطّلاع على تشغيل الاختبارات المبرمَجة في CTS (AOSP 10 أو إصدار أقل).

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

ملاحظة: للحصول على قائمة بجميع أوامر وحدة تحكّم CTS، يُرجى الاطّلاع على وحدة تحكّم الأوامر في الإصدار 2 من CTS.

تشغيل CTS على الأجهزة المزوّدة بشاشات متعددة

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

run cts-foldable

تتم إضافة القيمة من display_mode إلى حالات الاختبار التي اجتازت الاختبار أو تعذّر إجراؤها لميزة "وضع الشاشة البديل"، على سبيل المثال testcase1[display_mode=0].

ملاحظة: للحصول على تعليمات حول كيفية تنفيذ خطة اختبار cts-foldable لنظام التشغيل Android 10 أو الإصدارات الأقدم، يُرجى الاطّلاع على مقالة تنفيذ الاختبارات المبرمَجة لمجموعة أدوات اختبار التوافق (CTS) (نظام التشغيل Android 10 أو الإصدارات الأقدم).

إجراء اختبارات على أجهزة متعددة

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

run cts-multidevice

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

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

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

   ملاحظة: للحصول على تعليمات حول كيفية تحديد الوحدة على نظام التشغيل Android 10 أو الإصدارات الأقدم، اطّلِع على مقالة تشغيل الاختبارات المبرمَجة لبرنامج CTS (نظام التشغيل Android 10 أو الإصدارات الأقدم).

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

   run cts --plan test_module_or_plan_name
   

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

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

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

run cts --shard-count number_of_shards

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