إجراء اختبارات CTS

اتحاد التجارة هو إطار عمل اختبار مستمر لإجراء الاختبارات على Android الأجهزة. لتشغيل مجموعة اختبار التوافق (CTS)، اقرأ أولاً نظرة عامة على الاتحاد التجاري لإطار عمل اختبار المقايضة.

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

1. إعداد الأجهزة قيد الاختبار (DUTs) وفقًا إعداد جهاز Android:
2. تأكَّد من تثبيت أحدث الإصدارات من كليهما. Android Debug Bridge (adb) أو أداة تجميع مواد العرض في Android (AAPT) وإضافة مكان تلك الأدوات إلى مسار النظام لجهازك. لمزيد من المعلومات عن تثبيت هذه الأدوات، راجع إعداد CTS: ADB وAAPT
3. نزِّل إصدارات CTS التي تم إصدارها على جهاز مضيف Linux وفك ضغط الإصدار إلى موقع المضيف.
4. يجب توصيل جهاز واحد على الأقل. لإعداد DUT:
   • اضغط على زر الشاشة الرئيسية لضبط الجهاز على الشاشة الرئيسية.
   • ويُرجى عدم استخدام DUT في أي مهام أخرى.
   • احتفظ بـ DUT في موضع ثابت لتجنب تشغيل أداة الاستشعار الأخرى.
   • وجِّه كاميرا الجهاز إلى عنصر يمكن التركيز عليه.
   • لا تضغط على أي مفاتيح على الجهاز أثناء تشغيل CTS. الضغط يتداخل عمل المفاتيح أو لمس شاشة DUT مع الاختبارات الجارية وقد تؤدي إلى إخفاقات الاختبار.

5. ابدأ تشغيل النص البرمجي لوحدة تحكم CTS cts-tradefed من المجلد حيث تظهر CTS تم فك ضغط الحزمة. في واجهة سطر الأوامر الخاصة بالمضيف، شغِّل:

   ./android-cts/tools/cts-tradefed

6. تنفيذ الخطة التجريبية التلقائية (التي تتضمّن جميع حِزم الاختبار):

   cts-tradefed > run cts

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

     • على الإصدار 9 من نظام Android والإصدارات الأحدث، استخدِم خيار الأمر.

       --shard-count number_of_shards

     • على Android 8.1 والإصدارات الأقدم، استخدِم خيار الأمر.

       --shards number_of_shards

   • إذا لم تكن تريد تشغيل مجموعة الاختبار بالكامل، يمكنك تشغيل خطة CTS من اختيارك من سطر الأوامر:

     run cts --plan test_plan_name

     للعثور على اسم خطة الاختبار:

     • بالنسبة إلى الإصدار 7.0 من نظام التشغيل Android والإصدارات الأحدث، للاطّلاع على قائمة بوحدات الاختبار، أدخِل

       list modules

     • بالنسبة إلى نظام التشغيل Android 6.0 والإصدارات الأقدم، يمكنك الاطّلاع على قائمة بخطط الاختبار في مستودع، أدخل

       list plans

     • في نظام Android 6.0 والإصدارات الأقدم، للاطّلاع على قائمة بحِزم الاختبار في مستودع، أدخل

       list packages

   • للحصول على خيارات إضافية للأوامر بناءً على إصدارات CTS، يمكنك الرجوع إلى مقالة مرجع أمر وحدة التحكم، أو ضمن "مساعدة الكل" في وحدة التحكم Tradefed.

7. شغِّل جلسات "إعادة المحاولة" متعددة إلى أن تكتمل جميع وحدات الاختبار أرقام إخفاق الاختبار هي نفسها في آخر جلستين لإعادة المحاولة.

   • على نظام Android 9 والإصدارات الأحدث، استخدِم

     run retry --retry session_number --shard-count number_of_shards

   • على Android 7.0–8.1، استخدم

     run cts --retry session_number --shards number_of_shards

   • لمعرفة المزيد من خيارات أمر "إعادة المحاولة" بناءً على إصدار CTS، يمكنك الاطّلاع على وحدة تحكم أوامر CTS الإصدار 2.

   • لفهم تفاصيل تنفيذ CTS، يُرجى مراجعة إعادة محاولة استخدام حزمة الاتحاد التجاري

8. لا يمكنك إجراء جلسة إعادة المحاولة إلا في الاختبارات التي تعذّر إجراؤها على معلَمات. نجحت المراجعة لا تتم إعادة محاولة إجراء الاختبارات ذات المعلَمات.

   • في نظام التشغيل Android 11 والإصدارات الأحدث، يتم تفعيل خيار إعادة المحاولة التالي: بشكل تلقائي في الأمر run cts:

     run retry --retry  --new-parameterized-handling

9. يمكنك الاطّلاع على مستوى تقدُّم الاختبار والنتائج التي تم الإبلاغ عنها على وحدة التحكّم.

تشغيل CTS باستخدام "محطة اختبار Android"

تُعد Android Test Station أداة اختبار تشغيل تلقائي يختبرها مطورو Android يمكن للمهندسين استخدامها لاستخدام واجهة مستخدم لإجراء اختبار قياسي والأجنحة. متوافقة مع مجموعة أدوات اختبار التوافق مع Android (CTS).

تتوفر الأداة بشكل عام من خلال دليل مستخدم ATS، ورمزه مفتوح المصدر في خوارزمية AOSP. (multitest_transport، tradefed_cluster).

تشغيل CTS للأوضاع البديلة

يضيف إصدار CTS 10 R4 خطة اختبار للأجهزة ذات الأوضاع البديلة، أو الأجهزة بأكثر من شاشة واحدة. تنفيذ خطة اختبار الأوضاع البديلة باستخدام run cts-foldable

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

في CTS 13، تسمح واجهة برمجة التطبيقات DeviceStateManager لوحدات الاختبار التي تتضمن ما يلي أن يتم تشغيله على حالات مختلفة للجهاز القابل للطي. يتم تنفيذ الاختبار تلقائيًا في CTS استنادًا إلى حالات طي الشاشة. محدد في الجهاز بدون الحاجة إلى تنفيذ خطة اختبار cts-foldable.

<option name="config-descriptor:metadata" key="parameter" value="all_foldable_states" />

اختبار أجهزة متعددة في CTS

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

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

لإجراء اختبار على أجهزة متعددة بشكل مستقل، يمكنك استخدام الرمز التالي:

  cts-tradefed > run cts-multidevice
  

وتتوفّر جميع الخيارات العادية. لاستهداف أجهزة معيّنة، أضف --serial <serial1> --serial <serial2> وما إلى ذلك بالنسبة إلى عدد الأجهزة المستهدف.

لإجراء اختبارات متعددة الأجهزة تلقائيًا، يمكنك استخدام التقسيم، كما في --shard-count 2.