تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

وحدة تحكم قيادة CTS v2 ، وحدة تحكم قيادة CTS v2

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

لنظام Android 7.0 أو أعلى، استخدم CTS v2.

حدد الخطط

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

cts - يقوم بتشغيل CTS من تثبيت CTS موجود مسبقًا.
cts-camera - يقوم بتشغيل كاميرا CTS من تثبيت CTS موجود مسبقًا.
cts-java — يقوم بتشغيل اختبارات Java الأساسية من تثبيت CTS موجود مسبقًا.
cts-pdk — تشغيل اختبارات مفيدة للتحقق من صحة بنية دمج PDK.
كل شيء - التكوين المشترك لمجموعات التوافق.

تتضمن التكوينات الأخرى المتوفرة ما يلي:

المراسلون الأساسيون - التكوين مع مراسلي CTS الأساسيين.
اختبارات التجميع فقط - تشغيل CTS من تثبيت CTS موجود مسبقًا.
common-compatibility-config — التكوين العام لمجموعات التوافق.
cts-filtered-sample — تكوين شائع لمجموعات التوافق.
cts-known-failures — التكوين مع حالات فشل CTS المعروفة.
الشروط المسبقة لـ CTS - تكوينات الشروط المسبقة لـ CTS.
المضيف - يقوم بتشغيل اختبار واحد يعتمد على المضيف على جهاز موجود.
الصك - يقوم بإجراء اختبار واحد لأجهزة Android على جهاز موجود.
Native-benchmark — يقوم بإجراء اختبار التحمل الأصلي على جهاز موجود.
Native-stress — يقوم بإجراء اختبار إجهاد أصلي على جهاز موجود.
إعادة الشحن - اختبار مزيف ينتظر الأجهزة التي شارفت على تفريغها ويحتفظ بها للشحن.
testdef — يقوم بتشغيل الاختبارات الموجودة في ملفات test_def.xml على جهاز موجود.
util/wifi — تكوين الأداة المساعدة لتكوين Wi-Fi على الجهاز.
util/wipe - يمسح بيانات المستخدم الموجودة على الجهاز.

يمكن تنفيذ كل هذه الخطط والتكوينات باستخدام الأمر 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-Instant المحددة.
`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`	لنظام التشغيل 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` لتشغيل الحزمة أو الفئة أو الاختبار المحدد. تحذير : لا تستخدم هذا الخيار عند استخدام خيار `--include-filter` .
`--retry`	أعد محاولة كافة الاختبارات التي فشلت أو لم يتم تنفيذها من الجلسات السابقة. استخدم `list results` للحصول على معرف الجلسة.
`--retry-type NOT_EXECUTED`	قم بإعادة المحاولة فقط للاختبارات التي لم يتم تنفيذها من الجلسات السابقة. استخدم `list results` للحصول على معرف الجلسة.
`--shards number_of_shards`	لنظام التشغيل Android 8.1 أو الإصدارات الأقدم . قم بتقسيم CTS إلى عدد معين من القطع المستقلة، ليتم تشغيلها على أجهزة متعددة بالتوازي.
`--shard-count number_of_shards`	لنظام أندرويد 9 . قم بتقسيم CTS إلى عدد معين من القطع المستقلة، ليتم تشغيلها على أجهزة متعددة بالتوازي.
`--serial/-s deviceID`	قم بتشغيل CTS على الجهاز المحدد.
`--include-filter "test_module_name test_name"`	قم بالتشغيل باستخدام الوحدات النمطية المحددة، أو حزم الاختبار، والفئات، والحالات. على سبيل المثال، `run cts --include-filter "CtsCalendarcommon2TestCases android.calendarcommon2.cts.Calendarcommon2Test#testStaticLinking"` يتضمن الوحدة النمطية المحددة. خيار الأمر هذا غير مدعوم عند تشغيل إعادة المحاولة. تنبيه : لا تستخدم هذا الخيار عند استخدام خيار `--module/-m` .
`--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`	يتخطى جمع المعلومات حول الجهاز. تحذير : لا تستخدم هذا الخيار عند تشغيل CTS للموافقة.
`--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 [pass \| fail \| timeout \| notExecuted] [--session session_id ]`	إنشاء خطة فرعية مستمدة من الجلسة السابقة؛ يقوم هذا الخيار بإنشاء خطة فرعية يمكن استخدامها لتشغيل مجموعة فرعية من الاختبارات. الخيار الوحيد المطلوب هو `--session` . البعض الآخر اختياري، ولكن عند تضمينه، يجب أن يتبعه قيمة. خيار `--result-type` قابل للتكرار؛ على سبيل المثال `add subplan --session 0 --result-type passed --result-type failed` صالح.