คอนโซลคำสั่ง CTS v2

ใช้คอนโซล CTS v2

สำหรับ Android 7.0 ขึ้นไป ให้ใช้ CTS v2

เลือกแพ็กเกจ

แผนการทดสอบที่ใช้ได้มีดังนี้

  • cts - เรียกใช้ CTS จากการติดตั้ง CTS ที่มีอยู่ก่อนแล้ว
  • cts-camera เรียกใช้กล้อง CTS จากการติดตั้ง CTS ที่มีอยู่
  • cts-java - เรียกใช้การทดสอบ Core Java จากการติดตั้ง CTS ที่มีอยู่แล้ว
  • cts-pdk - เรียกใช้การทดสอบที่เป็นประโยชน์ในการตรวจสอบเวอร์ชันฟิวชัน PDK
  • ทุกอย่าง การกำหนดค่าทั่วไปสำหรับชุดโปรแกรมความเข้ากันได้

การกำหนดค่าอื่นๆ ที่ใช้ได้มีดังนี้

  • ผู้รายงานขั้นพื้นฐาน - การกำหนดค่าด้วยผู้รายงาน CTS พื้นฐาน
  • collect-tests-only - เรียกใช้ CTS จากการติดตั้ง CTS ที่มีอยู่แล้ว
  • common-compatibility-config - การกำหนดค่าทั่วไปสำหรับชุดความเข้ากันได้
  • cts-filtered-sample - การกำหนดค่าทั่วไปสำหรับชุดโปรแกรมความเข้ากันได้
  • cts-known-failures - การกำหนดค่าที่มีความล้มเหลวที่ทราบของ CTS
  • cts-preconditions - การกำหนดค่าเงื่อนไขล่วงหน้าของ CTS
  • โฮสต์ - เรียกใช้การทดสอบที่ใช้โฮสต์รายการเดียวในอุปกรณ์ที่มีอยู่
  • instrument - เรียกใช้การทดสอบการใช้เครื่องมือ Android ครั้งเดียวในอุปกรณ์ที่มีอยู่
  • เนทีฟ-มาตรฐาน - ทำการทดสอบความเครียดของระบบในอุปกรณ์ที่มีอยู่
  • native-stress - ทำการทดสอบความเครียดดั้งเดิมในอุปกรณ์ที่มีอยู่
  • เติมเงิน - การทดสอบปลอมซึ่งรออุปกรณ์ที่แทบไม่ได้ชาร์จแล้วเก็บอุปกรณ์นั้นไว้ชาร์จ
  • 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

หากต้องการแตกไฟล์ ZIP ไปยังไดเรกทอรีปัจจุบัน โปรดอย่าใช้ตัวเลือก -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 (หรือโฮสต์) จะรอ อุปกรณ์ต้องเชื่อมต่อก่อนเริ่มการทดสอบ หากมีมากกว่า 1 รายการ เชื่อมต่ออุปกรณ์แล้ว โฮสต์ 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 Test ที่ระบุ หรือโมดูล

run retry

สำหรับ Android 9 ขึ้นไปเท่านั้น ลองทำการทดสอบทั้งหมดที่ไม่สำเร็จหรือไม่ได้ดำเนินการอีกครั้ง จากเซสชันก่อนหน้า เช่น run retry --retry -s หรือ run retry --retry --shard-count ที่มีชาร์ดดิ้ง TF

run cts --retry ไม่ ใช้ได้กับ Android 9 ขึ้นไป

run cts-sim

สําหรับเวอร์ชัน Android 11 ขึ้นไป เรียกใช้ชุดย่อยของการทดสอบใน อุปกรณ์ที่มีซิมการ์ด

--device-token

สำหรับ Android เวอร์ชัน 8.1 หรือเก่ากว่า ระบุว่าอุปกรณ์ที่กำหนดมี โทเค็น เช่น --device-token 1a2b3c4d:sim-card

--enable-token-sharding

สำหรับ Android 10 ขึ้นไปเท่านั้น อัตโนมัติ ตรงกับการทดสอบ ต้องใช้ประเภทซิมที่เกี่ยวข้อง ไม่จำเป็นต้องระบุหมายเลขซีเรียลของอุปกรณ์เพื่อดำเนินการ กรอบการทดสอบที่เกี่ยวข้องกับซิม ซิมที่รองรับ: SIM_CARD, UICC_SIM_CARD, และ SECURE_ELEMENT_SIM_CARD

run cts-dev

เรียกใช้แผน CTS เริ่มต้น (กล่าวคือ การเรียกใช้ CTS เต็มรูปแบบ) แต่ ข้ามเงื่อนไขเบื้องต้นเพื่อประหยัดเวลาในการทำงานสำหรับการพัฒนา การทดสอบ การดำเนินการนี้จะข้ามการยืนยันและการตั้งค่าของอุปกรณ์ เช่น การพุชไฟล์สื่อหรือการตรวจสอบ Wi-Fi เช่นเดียวกับที่ทำเมื่อใช้ตัวเลือก --skip-preconditions ช่วงเวลานี้ จะข้ามการเก็บรวบรวมข้อมูลอุปกรณ์และตัวตรวจสอบสถานะระบบทั้งหมดด้วย และ ทำการทดสอบใน ABI เดียวเท่านั้น สำหรับการตรวจสอบอุปกรณ์ ให้หลีกเลี่ยงการเพิ่มประสิทธิภาพนี้และ รวมถึงเงื่อนไขและการตรวจสอบเบื้องต้นทั้งหมด โปรดดู cts-dev.xml เพื่อยกเว้น

คอนโซล CTS รับคำสั่งอื่นๆ ขณะกำลังทดสอบได้

หากไม่มีอุปกรณ์เชื่อมต่ออยู่ เครื่องเดสก์ท็อป CTS (หรือโฮสต์) จะรอ อุปกรณ์ต้องเชื่อมต่อก่อนเริ่มการทดสอบ หากมีมากกว่า 1 รายการ เชื่อมต่ออุปกรณ์แล้ว โฮสต์ 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 ตามค่าเริ่มต้น ทำการทดสอบ 1 ครั้งสำหรับ 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 แสดงรายการคำสั่ง run ที่ดำเนินการกับอุปกรณ์อยู่ในขณะนี้
list commands แสดงรายการคำสั่ง run ทั้งหมดที่อยู่ในคิวซึ่งกำลังรอการมอบหมายให้กับอุปกรณ์
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 ถูกต้อง