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

ใช้คอนโซล CTS v2

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

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

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

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

การกําหนดค่าอื่นๆ ที่มี ได้แก่

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

ระบบจะคลายการบีบอัดไฟล์ที่ดาวน์โหลดแบบ ZIP ไปยัง 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 Plan เริ่มต้นและ 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 ที่ระบุหรือข้อบังคับการทดสอบ
run retry

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

สำหรับ Android 12 ขึ้นไป คำสั่งนี้จะรองรับการกรองโดยใช้ตัวเลือก --module/-m และ --exclude-filter ระบบจะแคชการทดสอบที่ไม่ได้รวมอยู่ในเซสชันการลองอีกครั้งจากเซสชันก่อนหน้า

ไม่อนุญาต 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 ซิมที่รองรับ: 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 ถ่ายโอนบันทึกของ TradeFed สําหรับการเรียกใช้ที่ทํางานอยู่ทั้งหมด
เพิ่ม คำอธิบาย
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 ใช้ได้