استخدم وحدة التحكم 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
يستضيف | وصف |
---|---|
help | عرض ملخص للأوامر الأكثر استخدامًا |
help all | عرض القائمة الكاملة للأوامر المتاحة |
version | إظهار الإصدار. |
exit | اخرج برشاقة من وحدة التحكم CTS. يتم إغلاق وحدة التحكم عند انتهاء كافة الاختبارات الجارية حاليًا. |
extdir | يتم فك ضغط ملف التنزيلات المضغوط إلى إذا كنت تريد فك الضغط إلى الدليل الحالي، فلا تستخدم الخيار |
يجري | وصف |
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 cts-sim | لنظام التشغيل Android 11 أو الإصدارات الأحدث. يقوم بتشغيل مجموعة فرعية من الاختبارات على جهاز مزود ببطاقة SIM. |
--device-token | لنظام التشغيل Android 8.1 أو الإصدارات الأقدم. يحدد أن جهازًا معينًا لديه الرمز المميز المحدد. على سبيل المثال، |
--enable-token-sharding | لنظام Android 10 أو أعلى فقط . يطابق تلقائيًا الاختبار الذي يتطلب نوع بطاقة SIM المعنية. ليست هناك حاجة لتوفير رقم تسلسلي للجهاز لتنفيذ حالات الاختبار المتعلقة ببطاقة SIM. شرائح SIM المدعومة: |
run cts-dev | قم بتشغيل خطة CTS الافتراضية (أي استدعاء CTS الكامل) ولكن تخطي الشروط المسبقة لتوفير وقت التشغيل للتطوير التكراري لاختبار جديد. يؤدي هذا إلى تجاوز التحقق من تكوين الجهاز وإعداده، مثل دفع ملفات الوسائط أو التحقق من اتصال Wi-Fi، كما يحدث عند استخدام خيار يمكن لوحدة تحكم 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 | لنظام أندرويد 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 | إنشاء خطة فرعية مستمدة من الجلسة السابقة؛ يقوم هذا الخيار بإنشاء خطة فرعية يمكن استخدامها لتشغيل مجموعة فرعية من الاختبارات. الخيار الوحيد المطلوب هو --session . البعض الآخر اختياري، ولكن عند تضمينه، يجب أن يتبعه قيمة. خيار --result-type قابل للتكرار؛ على سبيل المثال add subplan --session 0 --result-type passed --result-type failed صالح. |