يعد Trade Union بمثابة إطار اختبار مستمر لإجراء الاختبارات على أجهزة Android. لتشغيل مجموعة اختبار التوافق (CTS)، اقرأ أولاً نظرة عامة على الاتحاد التجاري للحصول على شرح لإطار اختبار Tradefed.
لتشغيل خطة الاختبار:
- قم بإعداد الأجهزة قيد الاختبار (DUTs) وفقًا لإعداد جهاز Android .
- تأكد من أنك قمت بتثبيت الإصدارات الحديثة من Android Debug Bridge (adb) وأداة Android Asset Packaging Tool (AAPT) وقمت بإضافة موقع هذه الأدوات إلى مسار النظام الخاص بجهازك. للحصول على معلومات حول تثبيت هذه الأدوات، راجع إعداد CTS: ADB وAAPT.
- قم بتنزيل إصدارات CTS التي تم إصدارها على جهاز Linux المضيف الخاص بك وقم بفك ضغط الإصدار لاستضافة الموقع.
- قم بتوصيل جهاز واحد على الأقل. لإعداد DUT:
- اضغط على زر الصفحة الرئيسية لضبط الجهاز على الشاشة الرئيسية.
- لا تستخدم DUT لأية مهام أخرى.
- احتفظ بـ DUT في وضع ثابت لتجنب إثارة نشاط المستشعر.
- قم بتوجيه كاميرا الجهاز نحو كائن يمكن التركيز عليه.
- لا تضغط على أي مفاتيح بالجهاز أثناء تشغيل CTS. يؤدي الضغط على المفاتيح أو لمس شاشة DUT إلى التداخل مع الاختبارات الجارية وقد يؤدي إلى فشل الاختبار.
قم بتشغيل البرنامج النصي لوحدة التحكم CTS cts-tradefed من المجلد الذي تم فيه فك ضغط حزمة CTS. في غلاف سطر الأوامر الخاص بالمضيف، قم بتشغيل:
./android-cts/tools/cts-tradefed
قم بتشغيل خطة الاختبار الافتراضية (تحتوي على جميع حزم الاختبار):
cts-tradefed > run cts
إذا كنت ترغب في تحسين وقت تنفيذ الاختبار، فيمكنك تقسيم الاختبارات عبر أجهزة متعددة. تتطلب المشاركة أن يقوم المضيف بتوصيل جهازين على الأقل، ولكن يوصى بستة أجهزة أو أكثر لتحقيق الكفاءة. عند مشاركة أكثر من جهاز:
بالنسبة لنظام التشغيل Android 9 والإصدارات الأحدث، استخدم خيار الأمر
--shard-count number_of_shards
بالنسبة لنظام التشغيل Android 8.1 والإصدارات الأقدم، استخدم خيار الأمر
--shards number_of_shards
إذا كنت لا ترغب في تشغيل مجموعة الاختبار بأكملها، فيمكنك تشغيل خطة CTS التي تختارها من سطر الأوامر:
run cts --plan test_plan_name
للعثور على اسم خطة الاختبار:
بالنسبة لنظام التشغيل Android 7.0 والإصدارات الأحدث، لرؤية قائمة بوحدات الاختبار، أدخل
list modules
بالنسبة لنظام التشغيل Android 6.0 والإصدارات الأقدم، لعرض قائمة بخطط الاختبار في المستودع، أدخل
list plans
بالنسبة لنظام التشغيل Android 6.0 والإصدارات الأقدم، لعرض قائمة بحزم الاختبار في المستودع، أدخل
list packages
للحصول على خيارات أوامر إضافية اعتمادًا على إصدارات CTS، راجع مرجع أمر وحدة التحكم ، أو تحت "مساعدة الكل" في وحدة تحكم Tradefed.
قم بتشغيل جلسات إعادة المحاولة المتعددة حتى تكتمل جميع وحدات الاختبار وتكون أرقام فشل الاختبار هي نفسها في جلستي إعادة المحاولة الأخيرتين.
لنظام 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 v2 .
لفهم تفاصيل التنفيذ لإعادة محاولة CTS، راجع إعادة محاولة مجموعة الاتحاد التجاري .
قم بتشغيل جلسة إعادة المحاولة فقط في الاختبارات ذات المعلمات الفاشلة. لا تتم إعادة محاولة الاختبارات ذات المعلمات التي تم اجتيازها.
بالنسبة لنظام التشغيل Android 11 والإصدارات الأحدث، يتم تمكين خيار أمر إعادة المحاولة التالي افتراضيًا في أمر
run cts
:run retry --retry
--new-parameterized-handling
عرض تقدم الاختبار والنتائج المبلغ عنها على وحدة التحكم.
قم بتشغيل 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
.