اتحاد التجارة هو إطار عمل اختبار مستمر لإجراء الاختبارات على Android الأجهزة. لإجراء مجموعة أدوات اختبار التوافق (CTS)، يُرجى أولاً قراءة نظرة عامة على اتحاد التجارة للحصول على شرح لإطار عمل اختبار اتحاد التجارة.
لتنفيذ خطة اختبار، اتّبِع الخطوات التالية:
- إعداد الأجهزة التي يتم اختبارها (DUT) وفقًا لخطوات إعداد جهاز Android
- تأكَّد من تثبيت أحدث إصدارَين من كلّ من Android Debug Bridge (adb) و Android Asset Packaging Tool (AAPT) وإضافة موقع هذين الأداتَين إلى مسار النظام على جهازك. لمزيد من المعلومات عن تثبيت هذه الأدوات، راجع إعداد CTS: ADB وAAPT
- نزِّل إصدارات CTS التي تم طرحها على جهاز Linux المضيف وفك ضغط الإصدار في الموقع المستضيف.
- يجب توصيل جهاز واحد على الأقل. لإعداد DUT:
- اضغط على زر الشاشة الرئيسية لضبط الجهاز على الشاشة الرئيسية.
- ويُرجى عدم استخدام DUT في أي مهام أخرى.
- يجب إبقاء الجهاز قيد الاختبار في وضع ثابت لتجنُّب بدء قياس أنشطة المستشعر.
- وجِّه كاميرا الجهاز إلى عنصر يمكن التركيز عليه.
- لا تضغط على أي مفاتيح على الجهاز أثناء تشغيل CTS. يؤدي الضغط على مفاتيح أو لمس شاشة جهاز DUT إلى التأثير في الاختبارات الجارية وقد يؤدي ذلك إلى تعذُّر إكمال الاختبارات.
ابدأ تشغيل النص البرمجي لوحدة تحكم CTS cts-tradefed من المجلد حيث تظهر CTS تم فك ضغط الحزمة. في واجهة سطر الأوامر الخاصة بالمضيف، شغِّل:
./android-cts/tools/cts-tradefed
تنفيذ الخطة التجريبية التلقائية (التي تتضمّن جميع حِزم الاختبار):
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
بالنسبة إلى الإصدار 6.0 من Android والإصدارات الأقدم، لعرض قائمة بحِزم الاختبار في المستودع، أدخِل
list packages
للحصول على خيارات إضافية للأوامر بناءً على إصدارات CTS، يمكنك الرجوع إلى مقالة مرجع أمر وحدة التحكم، أو ضمن "مساعدة الكل" في وحدة التحكم Tradefed.
شغِّل جلسات "إعادة المحاولة" متعددة إلى أن تكتمل جميع وحدات الاختبار أرقام إخفاق الاختبار هي نفسها في آخر جلستين لإعادة المحاولة.
بالنسبة إلى الإصدار 9 من نظام التشغيل Android والإصدارات الأحدث، استخدِم
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، يُرجى مراجعة إعادة محاولة استخدام حزمة الاتحاد التجاري
يمكنك إجراء جلسة إعادة محاولة للاختبارات التي تتضمّن مَعلمات فقط. نجحت المراجعة لا تتم إعادة محاولة إجراء الاختبارات ذات المعلَمات.
بالنسبة إلى الإصدار 11 من نظام التشغيل Android والإصدارات الأحدث، يتم تفعيل خيار الأمر التالي لإعادة المحاولة تلقائيًا في الأمر
run cts:run retry --retry
--new-parameterized-handling
يمكنك الاطّلاع على مستوى تقدُّم الاختبار والنتائج التي تم الإبلاغ عنها على وحدة التحكّم.
تشغيل مجموعة أدوات اختبار التوافق (CTS) باستخدام "محطة اختبار Android"
تُعد Android Test Station أداة اختبار تشغيل تلقائي يختبرها مطورو Android يمكن للمهندسين استخدامها لاستخدام واجهة مستخدم لإجراء اختبار قياسي والأجنحة. وهو متوافق مع مجموعة أدوات اختبار التوافق (CTS) في Android.
تتوفّر الأداة للجميع من خلال قراءة
دليل مستخدم 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.