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

هناك خياران لإجراء الاختبارات المبرمَجة في مجموعة أدوات اختبار التوافق (CTS):

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

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

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

إجراء جميع الاختبارات المبرمَجة في مجموعة أدوات اختبار التوافق (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. بعد أن تصبح حالات فشل الاختبار متطابقة في عمليات إعادة المحاولة، ركِّز على تصحيح أخطاء الاختبارات المتبقية التي فشلت. للتعرّف على معلومات عن تحديد مشاكل نتائج الاختبار وحّلّها، يُرجى الاطّلاع على تحديد أسباب حالات فشل الاختبار و حلّ مشاكل اختبارات CTS.

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

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

run cts-foldable

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

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

نفِّذ الأمر التالي لإجراء خطة اختبار 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. يتخطّى هذا الأمر الشروط المسبقة وجمع معلومات الجهاز وجميع أدوات التحقّق من حالة النظام. كما أنّه يجري الاختبارات على واجهة ثنائية واحدة فقط.