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

ใช้คอนโซล CTS v2

สำหรับ Android 7.0 หรือสูงกว่า ให้ใช้ CTS v2

เลือกแผน

แผนการทดสอบที่มีอยู่มีดังต่อไปนี้:

  • cts — รัน CTS จากการติดตั้ง CTS ที่มีอยู่แล้ว
  • cts-cam — รัน CTS-cam จากการติดตั้ง 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
  • โฮสต์ — รันการทดสอบบนโฮสต์เดียวบนอุปกรณ์ที่มีอยู่
  • เครื่องมือ — รันการทดสอบเครื่องมือ Android บนอุปกรณ์ที่มีอยู่
  • เกณฑ์มาตรฐานดั้งเดิม - รันการทดสอบความเครียดดั้งเดิมบนอุปกรณ์ที่มีอยู่
  • ความเครียดแบบเนทีฟ - รันการทดสอบความเครียดแบบเนทิฟบนอุปกรณ์ที่มีอยู่
  • ชาร์จใหม่ — การทดสอบปลอมที่รออุปกรณ์ที่ใกล้จะคายประจุและเก็บไว้เพื่อชาร์จ
  • 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 หรือเวอร์ชันที่สูงกว่า รันการทดสอบชุดย่อยบนอุปกรณ์ที่มีซิมการ์ด

--device-token

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

--enable-token-sharding

สำหรับ Android 10 ขึ้นไปเท่านั้น จับคู่การทดสอบที่ต้องใช้ประเภท 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 หรือเวอร์ชันต่ำกว่า Shard a CTS วิ่งเข้าไปในชิ้นส่วนอิสระตามจำนวนที่กำหนด เพื่อทำงานบนอุปกรณ์หลายเครื่องพร้อมกัน
--shard-count number_of_shards สำหรับระบบปฏิบัติการ Android 9 Shard a 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
[pass | fail | timeout | notExecuted]
[--session session_id ]		 สร้างแผนย่อยที่ได้มาจากเซสชันก่อนหน้า ตัวเลือกนี้สร้างแผนย่อยที่สามารถใช้เพื่อรันชุดย่อยของการทดสอบ

ตัวเลือกที่จำเป็นเท่านั้นคือ --session ส่วนอื่นๆ เป็นทางเลือก แต่เมื่อรวมแล้ว จะต้องตามด้วยค่า ตัวเลือก --result-type สามารถทำซ้ำได้ ตัวอย่างเช่น add subplan --session 0 --result-type passed --result-type failed นั้นถูกต้อง