ก่อนอื่น โปรดทำความเข้าใจการจัดการตัวเลือกใน Tradefed
การตั้งค่า Suite อธิบายถึง 2 เลเยอร์ที่มีอยู่ในโครงสร้าง Suite ดังนี้
- ชุดคำสั่งระดับบนสุด
- โมดูล
ในบริบท Tradefed ที่ไม่อยู่ในชุด คุณไม่จำเป็นต้องกังวลเรื่องนี้ เนื่องจากตัวเลือกทั้งหมดจะเรียกใช้แบบเต็ม ในบริบทของชุด โมดูลจะแยกออกจากชุด ดังนั้นตัวเลือกบางรายการจึงใช้ไม่ได้ในระดับนั้น
ส่งตัวเลือกไปยังชุดโปรแกรมระดับบนสุด
ชุดโปรแกรมระดับบนสุดจะทํางานเหมือนกับการกําหนดค่า Tradefed มาตรฐาน นั่นคือการกําหนดค่าแบบเต็ม รวมถึงโปรแกรมรันไทม์ของชุดโปรแกรมจะได้รับตัวเลือกทั้งหมด เช่น การกําหนดค่า Tradefed ที่ไม่รวมชุดโปรแกรม
ส่งตัวเลือกไปยังโมดูล
โดยค่าเริ่มต้น โมดูลจะไม่รับตัวเลือกใดๆ ที่ส่งไปยังคําสั่ง
ผู้ใช้ต้องได้รับการกําหนดเป้าหมายอย่างชัดเจนจึงจะได้รับตัวเลือกผ่านตัวเลือก module-arg การแยกตัวเลือกโมดูลนี้ทําให้การแก้ไขข้อบกพร่องง่ายขึ้น
ตัวอย่าง
cts-tradefed run cts --module-arg <module-name>:<option-name>:<option-value>
cts-tradefed run cts --module-arg CtsGestureTestCases:collect-tests-only:true
ไวยากรณ์นี้ช่วยให้มั่นใจว่าโมดูลเป้าหมายจะได้รับตัวเลือกที่ระบุ
การส่งตัวเลือกไปยังโมดูลยังมีวิธีอื่นๆ อีกมากมาย เช่น test-arg ซึ่งช่วยให้คุณส่งตัวเลือกไปยังโปรแกรมรันทดสอบของแต่ละโมดูลตามประเภทหรือคลาสของโปรแกรมรันได้
ตัวอย่าง
cts-tradefed run cts --test-arg <test-class>:<option-name>:<option-value>
cts-tradefed run cts --test-arg com.android.tradefed.testtype.JarHosttest:collect-tests-only:true
ไวยากรณ์ไม่ได้กำหนดเป้าหมายไปยังโมดูลใดโมดูลหนึ่ง แต่กำหนดเป้าหมายไปยังโปรแกรมรันไทม์การทดสอบทั้งหมดของคลาสนั้น test-arg จะพิจารณาเฉพาะการติดตั้งใช้งาน IRemoteTest เท่านั้นในฐานะผู้รับตัวเลือกที่เป็นไปได้
ส่งตัวเลือกไปยังคลาสทดสอบ Java ใน java_test_host
หากเพิ่ม @Option ลงในคลาสทดสอบ Java เป็นส่วนหนึ่งของเป้าหมายการสร้าง java_test_host คุณจะต้องใช้สิ่งต่อไปนี้เพื่อแทรกตัวเลือกนั้น
cts-tradefed run cts --module-arg <module-name>:set-option:<option-name>:<option-value>
set-option ในบริบทนี้คือตัวเลือกของโปรแกรมรันไทม์ HostTest จากชุดทดสอบที่รวมคลาส Java ของคุณเพื่อเรียกใช้
หากเป้าหมายไฟล์ jar สำหรับตัวเลือกมีคลาสทดสอบหลายคลาส โดยค่าเริ่มต้น คลาสทั้งหมดควรมีการระบุ @option หรือใช้ไวยากรณ์ต่อไปนี้เพื่อกำหนดเป้าหมายไปยังคลาสเดียว
cts-tradefed run cts --module-arg <module-name>:set-option:<class-name>:<option-name>:<option-value>
ส่งตัวกรองไปยังชุด
หากต้องการกรองการทดสอบบางรายการออกจากชุด เราใช้ --include-filter และ
--exclude-filter เพื่อบังคับรวมหรือยกเว้นการทดสอบหรือโมดูลที่เฉพาะเจาะจงตามลำดับ การยกเว้นจะมีลําดับความสําคัญมากกว่า
โดยจะใช้รูปแบบ [abi] <module-name> [test name]
ตัวอย่าง
--include-filter CtsGestureTestCases
--include-filter armeabi-v7a CtsGestureTestCases
--include-filter armeabi-v7a CtsGestureTestCases android.gesture.cts.GestureTest#testGetStrokes