وحدة تحكّم الأوامر في الإصدار 2 من مجموعة أدوات اختبار التوافق (CTS)

استخدام وحدة تحكّم CTS v2

بالنسبة إلى الإصدار 7.0 من Android أو الإصدارات الأحدث، استخدِم الإصدار 2 من CTS.

اختيار الخطط

تشمل خطط الاختبار المتاحة ما يلي:

  • ‫cts: لتشغيل CTS من عملية تثبيت سابقة.
  • ‫cts-camera: لتشغيل CTS-camera من عملية تثبيت CTS حالية
  • cts-java: لتشغيل اختبارات Java الأساسية من عملية تثبيت سابقة لمجموعة أدوات اختبار التوافق (CTS)
  • cts-pdk: لتشغيل اختبارات مفيدة في التحقّق من إصدار PDK المُدمَج.
  • كل شيء: الإعدادات الشائعة لحِزم التوافق

تشمل الإعدادات الأخرى المتاحة ما يلي:

  • ‫basic-reporters: الإعداد باستخدام أدوات إعداد تقارير CTS الأساسية
  • collect-tests-only: لتشغيل CTS من عملية تثبيت حالية.
  • ‫common-compatibility-config: الإعدادات الشائعة لحِزم التوافق
  • ‫cts-filtered-sample: الإعدادات الشائعة لحِزم التوافق
  • ‫cts-known-failures: الإعدادات التي تتضمّن أخطاء معروفة في مجموعة أدوات اختبار التوافق (CTS)
  • ‫cts-preconditions: إعدادات الشروط المسبقة لمجموعة أدوات اختبار التوافق (CTS)
  • المضيف: لتشغيل اختبار واحد يستند إلى المضيف على جهاز حالي.
  • instrument: لتشغيل اختبار أداة قياس أداء Android واحد على جهاز حالي
  • ‫native-benchmark: لتشغيل اختبار ضغط أصلي على جهاز حالي
  • ‫native-stress: لتشغيل اختبار ضغط أصلي على جهاز حالي
  • إعادة الشحن: اختبار زائف ينتظر الأجهزة التي تكون طاقتها منخفضة تقريبًا ويوقفها للشحن.
  • testdef: لتشغيل الاختبارات الواردة في ملفات test_def.xml على جهاز حالي.
  • ‫util/wifi: إعدادات الأداة لضبط شبكة Wi-Fi على الجهاز
  • ‫util/wipe: لحذف بيانات المستخدم على الجهاز

يمكن تنفيذ كل هذه الخطط والإعدادات باستخدام الأمر run cts.

مرجع أوامر وحدة تحكّم الإصدار 2 من CTS

يلخِّص هذا الجدول أوامر وحدة تحكّم CTS v2 ل استخدامات مختلفة.

استضِف أصدقاءك وعائلتك الوصف
help عرض ملخّص للأوامر الأكثر استخدامًا
help all عرض القائمة الكاملة للأوامر المتاحة
version عرض الإصدار
exit اخرج من وحدة تحكّم CTS بدون أي مشاكل. يتم إغلاق وحدة التحكّم عند انتهاء جميع الاختبارات التي يتم إجراؤها حاليًا.
extdir

تم فك ضغط ملف التنزيلات المضغوط إلى extdir. إذا كنت تريد التخلص من الإخراج المتضخم، استخدِم الخيار -q:

unzip -q android-cts-9.0_r15-linux_x86-arm.zip -d extdir

إذا كنت تريد فك ضغط الملف في الدليل الحالي، لا تستخدِم الخيار -d، ما عليك سوى تنفيذ:

unzip -q android-cts-9.0_r15-linux_x86-arm.zip
تشغيل الوصف
run cts

في Android 10، يمكنك تنفيذ خطة CTS التلقائية وCTS-Instant معًا (أي طلب CTS الكامل). بالنسبة إلى الإصدار 9 من نظام التشغيل Android أو الإصدارات الأقدم، يمكنك تنفيذ خطة CTS التلقائية فقط. استخدِم هذا الخيار الشامل (بما في ذلك الشروط المسبقة) لإثبات ملكية الجهاز. اطّلِع على cts.xml لمعرفة العناصر المضمّنة.

يمكن لوحدة تحكّم CTS قبول أوامر أخرى أثناء إجراء الاختبارات.

إذا لم تكن هناك أي أجهزة متصلة، سينتظر جهاز الكمبيوتر المكتبي (أو المضيف) في CTS حتى يتم توصيل جهاز قبل بدء الاختبارات. إذا كان هناك أكثر من جهاز واحد متصل، سيختار مضيف CTS جهازًا تلقائيًا.

run cts-instant

بالنسبة إلى Android 9، شغِّل خطة CTS-Instant التلقائية.

run cts --module-parameter INSTANT_APP

في Android 10، شغِّل خطة CTS-Instant التلقائية.

run cts --module-parameter INSTANT_APP --module/-m test_module_name

في Android 10، شغِّل وحدة اختبار CTS-Instant المحدّدة أو الوحدات.
run retry

على نظام التشغيل Android 9 أو الإصدارات الأحدث فقط إعادة محاولة جميع الاختبارات التي تعذّر إجراؤها أو لم يتم إجراؤها من الجلسات السابقة على سبيل المثال، run retry --retry -s أو run retry --retry --shard-count مع تقسيم TF

run cts --retry ليس مسموحًا به على الإصدار 9 من Android أو الإصدارات الأحدث.
run cts-sim

لنظام التشغيل Android 11 أو الإصدارات الأحدث يُجري هذا الإجراء مجموعة فرعية من الاختبارات على جهاز مزوّد بشريحة SIM.
--device-token

لنظام التشغيل Android 8.1 أو الإصدارات الأقدم تشير إلى أنّ جهازًا معيّنًا لديه الرمز المميّز المحدّد. على سبيل المثال، --device-token 1a2b3c4d:sim-card.
--enable-token-sharding

لأجهزة Android التي تعمل بالإصدار 10 أو إصدار أحدث فقط تتم مطابقة الاختبار الذي يتطلب نوع شريحة SIM المعني تلقائيًا. ليست هناك حاجة إلى تقديم رقم تسلسلي للجهاز لتنفيذ حالات الاختبار المرتبطة بشريحة SIM. شرائح SIM المتوافقة: SIM_CARD وUICC_SIM_CARD وSECURE_ELEMENT_SIM_CARD

run cts-dev

يمكنك تنفيذ خطة CTS التلقائية (أي طلب CTS الكامل) ولكن يمكنك تخطّي الشروط المسبقة لتوفير وقت التشغيل لتطوير اختبار جديد بشكلٍ متكرّر. ويؤدي ذلك إلى تجاوز عملية إثبات الهوية وإعدادات الجهاز، مثل نقل ملفات الوسائط أو التحقّق من اتصال شبكة Wi-Fi، كما هو الحال عند استخدام الخيار --skip-preconditions. يتخطّى هذا الأمر أيضًا جمع معلومات الجهاز وجميع أدوات التحقّق من حالة النظام. وعلاوةً على ذلك، يُجري الاختبار على ملف ABI واحد فقط. بالنسبة إلى عملية التحقّق من الجهاز، تجنَّب هذا التحسين و أدرِج جميع الشروط المسبقة والفحوصات. اطّلِع علىملف cts-dev.xml للاطّلاع على الاستثناءات.

يمكن لوحدة تحكّم CTS قبول أوامر أخرى أثناء إجراء الاختبارات.

إذا لم تكن هناك أي أجهزة متصلة، سينتظر جهاز الكمبيوتر المكتبي (أو المضيف) في CTS حتى يتم توصيل جهاز قبل بدء الاختبارات. إذا كان هناك أكثر من جهاز واحد متصل، سيختار مضيف CTS جهازًا تلقائيًا.
--subplan subplan_name شغِّل الخطة الفرعية المحدّدة.
--module/-m test_module_name --test/-t test_name  شغِّل الوحدة والاختبار المحدّدَين. على سبيل المثال، يؤدي الإجراء run cts -m Gesture --test android.gesture.cts.GestureTest#testGetStrokes إلى تشغيل حزمة أو فئة أو اختبار محدّد.
--retry إعادة محاولة جميع الاختبارات التي تعذّر إجراؤها أو لم يتم إجراؤها من الجلسات السابقة استخدِم list results للحصول على معرّف الجلسة.
--retry-type NOT_EXECUTED إعادة محاولة الاختبارات التي لم يتم تنفيذها من الجلسات السابقة فقط استخدِم list results للحصول على معرّف الجلسة.
--shards number_of_shards على نظام التشغيل Android 8.1 أو الإصدارات الأقدم: تقسيم عملية تنفيذ CTS إلى عدد معيّن من الأجزاء المستقلة، لتشغيلها على أجهزة متعددة بالتوازي
--shard-count number_of_shards لنظام التشغيل Android 9: تقسيم عملية إجراء CTS إلى عدد معيّن من الأجزاء المستقلة، لتشغيلها على أجهزة متعددة بشكل متزامن
--serial/-s deviceID شغِّل CTS على الجهاز المحدّد.
--include-filter "test_module_name test_name" يمكنك تنفيذها باستخدام الوحدات المحدّدة أو حِزم الاختبار والفصول وحالات الاختبار. على سبيل المثال، يحتوي العنوان run cts --include-filter "CtsCalendarcommon2TestCases android.calendarcommon2.cts.Calendarcommon2Test#testStaticLinking" على الوحدة المحدّدة.

لا يتوفّر خيار الأمر هذا عند تنفيذ إعادة المحاولة.
--exclude-filter "test_module_name test_name" استبعاد الوحدات المحدّدة أو حِزم الاختبار والفصول والحالات من عملية التنفيذ على سبيل المثال، run cts --exclude-filter "CtsCalendarcommon2Test android.calendarcommon2.cts.Calendarcommon2Test#testStaticLinking" يستبعد الوحدة المحدّدة.
--log-level-display/-l log_level شغِّل التطبيق مع الحد الأدنى لمستوى السجلّ المحدّد المعروض على STDOUT. القيم الصالحة: [VERBOSE، DEBUG، INFO، WARN، ERROR، ASSERT].
--abi abi_name فرض تشغيل الاختبار على معرّف ABI المحدّد، 32 أو 64 يُجري CTS اختبارًا واحدًا تلقائيًا لكل واجهة برمجة تطبيقات يتوافق معها الجهاز.
--logcat-on-failure،
--bugreport-on-failure،
--screenshoot-on-failure		 يوفّر المزيد من المعلومات حول الأعطال ويمكن أن يساعد في بيانات التشخيص.
--device-token تشير إلى أنّ جهازًا معيّنًا يتضمّن الرمز المميّز المحدّد، مثل --device-token 1a2b3c4d:sim-card.
--skip-device-info تخطّي جمع معلومات عن الجهاز
--skip-preconditions يمكنك تخطّي الشروط المسبقة لتوفير وقت التشغيل لتطوير اختبار جديد بشكلٍ متكرّر. ويؤدي ذلك إلى تجاوز عملية التحقّق من إعدادات الجهاز وإعدادها، مثل نقل ملفات الوسائط أو التحقّق من اتصال شبكة Wi-Fi.
قائمة الوصف
list modules إدراج جميع وحدات الاختبار المتاحة في المستودع
‫list plans أو list configs إدراج جميع خطط الاختبار (الإعدادات) المتاحة في المستودع
list subplans إدراج جميع الخطط الفرعية المتاحة في المستودع
list invocations عرض أوامر run التي يتم تنفيذها حاليًا على الأجهزة
list commands عرض جميع أوامر التشغيل المتوفّرة حاليًا في قائمة الانتظار في انتظار إسنادها إلى الأجهزة
list results إدراج نتائج CTS المخزّنة حاليًا في المستودع
list devices عرض قائمة بالأجهزة المتصلة حاليًا وحالتها

الأجهزة المتوفّرة هي الأجهزة التي تعمل بشكل جيد، والأجهزة غير النشطة، والأجهزة المتاحة لإجراء الاختبارات.

الأجهزة غير المتوفّرة هي الأجهزة التي تظهر من خلال adb، ولكنها لا تستجيب لأوامر adb ، ولن يتم تخصيصها للاختبارات.

الأجهزة المخصّصة هي الأجهزة التي تُجري حاليًا اختبارات.
نسخ الوصف
dump logs تفريغ سجلات tradefed لجميع عمليات الاستدعاء الجارية
إضافة الوصف
add subplan --name/-n subplan_name
--result-type
[passed | failed | not_executed]
[--session session_id]		 إنشاء خطة فرعية مشتقة من الجلسة السابقة: يُنشئ هذا الخيار خطة فرعية يمكن استخدامها لإجراء مجموعة فرعية من الاختبارات.

الخيار الوحيد المطلوب هو --session. أما السمات الأخرى، فهي اختيارية، ولكن يجب أن تكون مصحوبة بقيمة عند تضمينها. يمكن تكرار الخيار --result-type، على سبيل المثال، add subplan --session 0 --result-type passed --result-type failed صالح.