وحدة تحكم أوامر CTS v2

استخدام وحدة تحكّم الإصدار 2 من CTS

إذا كنت تستخدم الإصدار 7.0 من نظام Android أو إصدارًا أحدث، استخدِم الإصدار 2 من CTS.

اختيار الخطط

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

  • cts: تشغيل CTS من تثبيت CTS موجود مسبقًا.
  • cts-camera: لتشغيل كاميرا CTS من تثبيت CTS موجود مسبقًا.
  • cts-java: لتنفيذ اختبارات Core Java من تثبيت CTS موجود مسبقًا.
  • cts-pdk: إجراء اختبارات مفيدة للتحقّق من صحة إصدار دمج PDK.
  • كل شيء: الإعدادات الشائعة لمجموعات التوافق.

تشمل التكوينات الأخرى المتاحة ما يلي:

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

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

مرجع أوامر وحدة التحكم CTS v2

يلخص هذا الجدول أوامر وحدة التحكم 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 الكامل). على جهاز Android 9 أو الإصدارات الأقدم، استخدِم الإعداد التلقائي. فقط لخطة 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 المحدّدة. أو الوحدات.
run retry

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

run cts --retry ليس كذلك متاحة في نظام التشغيل Android 9 أو الإصدارات الأحدث.
run cts-sim

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

للإصدار 8.1 من نظام Android أو الإصدارات الأقدم تشير هذه القيمة إلى أنّ جهازًا معيّنًا يتضمّن البيانات المعيّنة الرمز المميز. مثلاً: --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 بالنسبة إلى الإصدار 8.1 من Android أو الإصدارات الأقدم مشاركة جزء 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 التلقائية إجراء اختبار مرة واحدة لكل واجهة تطبيق ثنائية (ABI) يتوافق معها الجهاز.
--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 إدراج أوامر تشغيل التي يتم تنفيذها حاليًا على الأجهزة.
list commands أدرج جميع أوامر تشغيل الموجودة حاليًا في قائمة الانتظار والتي تنتظر أن يتم تعيينها للأجهزة.
list results يمكنك سرد نتائج CTS المخزَّنة حاليًا في المستودع.
list devices إدراج الأجهزة المتصلة حاليًا وحالتها

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

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

الأجهزة المخصّصة هي أجهزة يتم إجراء الاختبارات عليها حاليًا.
نسخ الوصف
dump logs عليك تفريغ السجلّات التي تم تبادلها لجميع الاستدعاءات الجارية.
إضافة الوصف
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" صالح.