ตัวตรวจสอบชุดทดสอบความเข้ากันได้ของ Android (CTS Verifier) เสริมชุดทดสอบความเข้ากันได้ (CTS) แม้ว่า CTS จะตรวจสอบ API และฟังก์ชันที่สามารถทำงานอัตโนมัติได้ แต่ CTS Verifier จะทำการทดสอบ API และฟังก์ชันที่ไม่สามารถทดสอบบนอุปกรณ์เคลื่อนที่ได้หากไม่มีการป้อนข้อมูลด้วยตนเอง เช่น คุณภาพเสียง หน้าจอสัมผัส มาตรความเร่ง และกล้อง
ความต้องการ
ก่อนเรียกใช้ CTS Verifier ตรวจสอบให้แน่ใจว่าคุณมีอุปกรณ์ต่อไปนี้:
- อุปกรณ์ Android ที่ตรวจสอบความเข้ากันได้ของ Android API โดยผ่าน CTS สำเร็จ นี่คืออุปกรณ์ที่อยู่ระหว่างการทดสอบ (DUT)
- คอมพิวเตอร์ Linux พร้อมพอร์ตที่รองรับ USB 2.0 การเชื่อมต่อกับ DUT ทั้งหมดต้องผ่านพอร์ตนี้
- อุปกรณ์ Android เครื่องที่สองที่มี Bluetooth, Wi-Fi direct และ NFC host card emulation (HCE) ที่ใช้งานร่วมกันได้
- เราเตอร์ Wi-Fi ที่กำหนดค่าด้วยชื่อจุดเข้าใช้งานและรหัสผ่าน เราเตอร์ควรมีความสามารถในการตัดการเชื่อมต่อจากอินเทอร์เน็ต แต่ไม่สามารถปิดได้
ข้อกำหนดของ UICC สำหรับการทดสอบ NFC
CTS Verifier มีกรณีทดสอบ NFC ดังต่อไปนี้:
- Field-off (ใช้ข้อมูลธุรกรรมจาก 0x54)
- ยกเลิกการเลือก (ใช้ข้อมูลธุรกรรมจาก 0x52)
- คำสั่ง HCI (0025000000) (ใช้ข้อมูลธุรกรรมจาก 0x02)
การทดสอบเหตุการณ์การทำธุรกรรมต้องใช้อุปกรณ์สองเครื่อง โดยหนึ่งในนั้นต้องมี SecureElement UICC พร้อมกฎการเข้าถึงต่อไปนี้:
- แฮช CtsVerifier APK: 61:ED:37:7E:85:D3:86:A8:DF:EE:6B:86:4B:D8:5B:0B:FA:A5:AF:81
- ตัวระบุแอปพลิเคชันที่ได้รับอนุญาต (AID) สำหรับการเข้าถึงเหตุการณ์ NFC: 0xA000000476416E64726F696443545341
ในด้านอีมูเลเตอร์ เราคาดว่าเหตุการณ์การทำธุรกรรมจะผลักดันกิจกรรมที่สอดคล้องกันไปสู่เบื้องหน้า
ติดตั้ง
เปลี่ยนโหมดการนำทางของระบบของอุปกรณ์ทดสอบเป็นโหมดสามปุ่มดังต่อไปนี้:
- เปิดการตั้งค่า
- นำทางไปยัง ระบบ > ท่าทางสัมผัส > การนำทางระบบ
- เลือกโหมดการนำทางแบบใช้ปุ่ม โหมดสามปุ่มที่ต้องการ ถ้ามี
ในการตั้งค่าสภาพแวดล้อมการทดสอบ CTS Verifier:
บนคอมพิวเตอร์ Linux:
เรียกใช้คำสั่งต่อไปนี้ก่อนที่จะติดตั้ง CTS Verifier เพื่ออนุญาตการเข้าถึงอินเทอร์เฟซที่ไม่ใช่ SDK
adb shell settings put global hidden_api_policy 1
ติดตั้ง Android Studio
ดาวน์โหลด CTS Verifier APK สำหรับเวอร์ชันของ Android เพื่อทดสอบ
เชื่อมต่อ DUT กับคอมพิวเตอร์ Linux
จากเทอร์มินัลบนคอมพิวเตอร์ Linux ให้ติดตั้ง
CtsVerifier.apk
บน DUTadb install -r -g CtsVerifier.apk
สำหรับ Android 10 ขึ้นไป ให้เรียกใช้คำสั่งต่อไปนี้เพื่อให้สิทธิ์แก่แอปในการสร้างรายงาน
adb shell appops set com.android.cts.verifier android:read_device_identifiers allow
สำหรับ Android 11 ขึ้นไป ให้รันคำสั่งต่อไปนี้เพื่ออนุญาตให้บันทึกรายงานในไดเร็กทอรีที่กำหนดด้วยตนเองภายใต้ไดเร็กทอรีภายนอกระดับบนสุดของอุปกรณ์
adb shell appops set com.android.cts.verifier MANAGE_EXTERNAL_STORAGE 0
สำหรับ Android 13 ขึ้นไป ให้รันคำสั่งต่อไปนี้เพื่ออนุญาตการเข้าถึง API ทดสอบสำหรับ CTS Verifier
adb shell am compat enable ALLOW_TEST_API_ACCESS com.android.cts.verifier
ตรวจสอบให้แน่ใจว่า DUT มีข้อมูลระบบและตั้งเวลาอย่างถูกต้อง
เรียกใช้ตัวตรวจสอบ CTS
เปิดแอปพลิเคชัน CTS Verifier โดยแตะที่ไอคอน CTS Verifier บน DUT
รูปที่ 1 ไอคอนตัวตรวจสอบ CTS
แอพแสดงชุดการทดสอบหลายชุดสำหรับการตรวจสอบด้วยตนเอง
รูปที่ 2 เมนูทดสอบ CTS Verifier
การทดสอบแต่ละครั้งประกอบด้วยชุดขององค์ประกอบทั่วไปที่ด้านล่างของหน้าจอ
รูปที่ 3 หน้าจอทดสอบที่ไฮไลต์องค์ประกอบการทดสอบทั่วไป
- ผ่าน (✓) แตะหาก DUT ตรงตามข้อกำหนดการทดสอบตามคำแนะนำข้อมูล
- ข้อมูล (?) แตะเพื่อแสดงคำแนะนำในการทดสอบ ปรากฏขึ้นโดยอัตโนมัติเมื่อเปิดการทดสอบครั้งแรก
- ล้มเหลว (!) แตะหาก DUT ไม่ตรงตามข้อกำหนดการทดสอบตามคำแนะนำข้อมูล
การทดสอบบางอย่าง เช่น โหมดอุปกรณ์เสริม USB และการทดสอบการปรับเทียบกล้อง จำเป็นต้องมีการตั้งค่าการทดสอบเพิ่มเติมและคำแนะนำตามรายละเอียดในหัวข้อต่อไปนี้
ทดสอบโหมดอุปกรณ์เสริม USB สำหรับ 8.0 และสูงกว่า
รูปที่ 4 ขั้นตอนการทดสอบอุปกรณ์เสริม USB สำหรับ 8.0 ขึ้นไป
รูปที่ 5 การทดสอบโหมดอุปกรณ์เสริม USB สำหรับ 8.0 และสูงกว่า
ทดสอบโหมดอุปกรณ์เสริม USB สำหรับ 7.x และต่ำกว่า
การทดสอบอุปกรณ์เสริม USB ต้องใช้คอมพิวเตอร์ Linux เพื่อเรียกใช้โปรแกรมเครื่องเดสก์ท็อป USB (โฮสต์)
- เชื่อมต่อ DUT กับคอมพิวเตอร์ Linux
บนคอมพิวเตอร์ ให้รันโปรแกรม
cts-usb-accessory
จากแพ็คเกจ CTS Verifier:./cts-usb-accessory
รอให้ข้อความป๊อปอัปปรากฏขึ้นบน DUT จากนั้นเลือก ตกลง
รูปที่ 6 การทดสอบอุปกรณ์เสริม USB
ไปที่การทดสอบอุปกรณ์เสริม USB ในแอปพลิเคชัน CTS Verifier บน DUT
บนคอมพิวเตอร์ ตรวจสอบผลลัพธ์จากคอนโซล ตัวอย่างเอาต์พุต:
CTS USB Accessory Tester Found possible Android device (413c:2106) - attempting to switch to accessory mode... Failed to read protocol versionfigure3 Found Android device in accessory mode (18d1:2d01)... [RECV] Message from Android device #0 [SENT] Message from Android accessory #0 [RECV] Message from Android device #1 [SENT] Message from Android accessory #1 [RECV] Message from Android device #2 [SENT] Message from Android accessory #2 [RECV] Message from Android device #3 [SENT] Message from Android accessory #3 [RECV] Message from Android device #4 [SENT] Message from Android accessory #4 [RECV] Message from Android device #5 [SENT] Message from Android accessory #5 [RECV] Message from Android device #6 [SENT] Message from Android accessory #6 [RECV] Message from Android device #7 [SENT] Message from Android accessory #7 [RECV] Message from Android device #8 [SENT] Message from Android accessory #8 [RECV] Message from Android device #9 [SENT] Message from Android accessory #9 [RECV] Message from Android device #10 [SENT] Message from Android accessory #10
ปรับเทียบมุมมองของกล้อง
ใช้ขั้นตอนการสอบเทียบขอบเขตการมองเห็นเพื่อกำหนดขอบเขตการมองเห็นของอุปกรณ์อย่างรวดเร็วด้วยความแม่นยำระดับปานกลาง
ตั้งค่าสภาพแวดล้อมการทดสอบ:
- พิมพ์ไฟล์เป้าหมาย calibration-pattern.pdf บนกระดาษขนาด 11” x 17” หรือ A3
- ติดตั้งรูปแบบการพิมพ์บนแผ่นรองหลังแบบแข็ง
จัดวางอุปกรณ์กล้องและเป้าหมายที่พิมพ์ตามที่แสดงในแผนภาพต่อไปนี้
รูปที่ 7. เป้าพิมพ์ของกล้อง
กำหนดความกว้างของเป้าหมาย:
- วัดระยะห่าง (หน่วยเป็นเซนติเมตร) ระหว่างเส้นทึบบนรูปแบบชิ้นงานเพื่อพิจารณาความไม่ถูกต้องในการพิมพ์ (~38 ซม.)
- เริ่มแอปพลิเคชันการสอบเทียบ
- กดปุ่มตั้งค่าและเลือก ระยะมาร์กเกอร์
- วัดและป้อนระยะทางไปยังรูปแบบเป้าหมาย (~100 ซม.)
- กดปุ่มย้อนกลับเพื่อกลับไปยังการแสดงตัวอย่างการสอบเทียบ
ตรวจสอบว่าได้วางอุปกรณ์และเป้าหมายตามที่แสดงในภาพและป้อนระยะทางที่ถูกต้องในกล่องโต้ตอบการตั้งค่า ภาพตัวอย่างแสดงภาพโดยมีเส้นแนวตั้งซ้อนทับ เส้นนี้ควรตรงกับเส้นกึ่งกลางของรูปแบบเป้าหมาย สามารถใช้เส้นกริดโปร่งใสกับเส้นแนวตั้งอื่นๆ เพื่อให้แน่ใจว่าแกนออปติกตั้งฉากกับชิ้นงาน
เรียกใช้การทดสอบการสอบเทียบ:
- เลือกความละเอียดของภาพ (โดยใช้ตัวเลือกที่ด้านล่างซ้าย) จากนั้นแตะหน้าจอเพื่อถ่ายภาพ การทดสอบเข้าสู่โหมดการปรับเทียบและแสดงภาพถ่ายโดยมีเส้นแนวตั้งสองเส้นซ้อนทับบนภาพ
- กำหนดความแม่นยำ:
- หากเส้นตรงกับเส้นแนวตั้งของรูปแบบเป้าหมายภายในระยะไม่กี่เซนติเมตร ขอบเขตการมองเห็นที่รายงานสำหรับผลลัพธ์ที่เลือกนั้นถูกต้อง
- ถ้าเส้นไม่ตรงกัน แสดงว่าขอบเขตการมองเห็นที่รายงานนั้นไม่ถูกต้อง ในการแก้ไขปัญหานี้ ให้ปรับตัวเลื่อนที่ด้านล่างของหน้าจอจนกว่าภาพซ้อนทับจะจัดแนวกับรูปแบบเป้าหมายให้ใกล้เคียงที่สุด เมื่อภาพซ้อนทับและภาพรูปแบบเป้าหมายอยู่ในแนวเดียวกัน ขอบเขตการมองเห็นที่แสดงจะเป็นค่าประมาณที่ใกล้เคียงกับค่าที่ถูกต้อง มุมมองที่รายงานควรอยู่ภายในระดับ +/-2 ของค่าการสอบเทียบ
- กดปุ่มย้อนกลับและทำการทดสอบการปรับเทียบซ้ำสำหรับความละเอียดของภาพทั้งหมดที่รองรับโดย DUT
เรียกใช้ตัวตรวจสอบ CTS สำหรับโหมดสำรอง
ตั้งแต่เปิดตัว CTS 10 R6 และ CTS 11 R2 CTS Verifier รองรับการทดสอบที่จำเป็นสำหรับอุปกรณ์ที่มีโหมดสำรอง หรือสำหรับอุปกรณ์ที่มีโหมดหน้าจอมากกว่าหนึ่งโหมด
ที่ด้านบนสุดของมุมมองรายการหลักใน CTS Verifier ปุ่มจะแสดงขึ้นเพื่อให้ผู้ใช้สามารถสลับระหว่างโหมดการแสดงผลที่กางออกและพับได้ CTS Verifier จะแสดงการทดสอบที่จำเป็นสำหรับโหมดการแสดงผลที่เลือก ในการดำเนินการโหมดอื่นใน CTS Verifier ควรเปลี่ยนปุ่มเป็นโหมดการแสดงผลที่เหมาะสมและเรียกใช้รายการการทดสอบที่แสดง
ผลลัพธ์ของการทดสอบแบบพับจะถูกบันทึกในรายงานเดียวกันกับการทดสอบที่กางออก ในการระบุผลการทดสอบแต่ละรายการซึ่งเป็นที่มาของชุดการทดสอบ จะมีการเพิ่มส่วนต่อท้ายให้กับชื่อการทดสอบแต่ละรายการภายใต้โหมดพับ
<Test result="fail" name="com.android.cts.verifier.deskclock.DeskClockTestsActivity[folded]">
<RunHistory subtest="CREATE_ALARM[folded]">
<Run start="1594176663973" end="1594176665841" isAutomated="false" />
</RunHistory>
</Test>
ผลลัพธ์การส่งออก
หลังจากการทดสอบทั้งหมดเสร็จสิ้น คุณสามารถบันทึกผลลัพธ์เป็นรายงานและดาวน์โหลดลงในคอมพิวเตอร์ได้ ชื่อรายงานจะถูกประทับเวลาโดยอัตโนมัติตามเวลาของระบบ DUT
หากต้องการบันทึกผลการทดสอบ ให้แตะไอคอนบันทึก (ดิสก์) ที่ด้านบนของรายการประเภทการทดสอบ
รอข้อความป๊อปอัพที่แสดงพาธไฟล์ไปยังรายงานที่บันทึกไว้ (เช่น
/sdcard/verifierReports/ctsVerifierReport-date-time.zip
) จากนั้นบันทึกพาธเชื่อมต่อ DUT กับคอมพิวเตอร์ Linux
จากการติดตั้ง Android SDK บนคอมพิวเตอร์ Linux ให้ดาวน์โหลดรายงานจากอุปกรณ์ที่เชื่อมต่อโดยใช้การ
adb shell content read
หรือadb pull CTSVerifierReportPath
สำหรับ Android 7.x และสูงกว่า ให้ดาวน์โหลดรายงานทั้งหมดโดยใช้คำสั่งต่อไปนี้:
adb pull /sdcard/verifierReports
สำหรับ Android 6.0 และต่ำกว่า ให้ดาวน์โหลดรายงานทั้งหมดโดยใช้คำสั่งต่อไปนี้:
adb pull /mnt/sdcard/ctsVerifierReports/
สำหรับ Android 10 ขึ้นไป การติดตั้งยานยนต์และอุปกรณ์ที่ทำงานเป็น ผู้ใช้รอง ให้ดาวน์โหลดรายงานล่าสุดโดยใช้คำสั่งต่อไปนี้:
adb shell content read --user CURRENT_USER --uri content://com.android.cts.verifier.testresultsprovider/reports/latest > report.zip
การแสดงรายการรายงานทั้งหมดที่มีในอุปกรณ์ที่เชื่อมต่อ:
adb shell content query --user CURRENT_USER --uri content://com.android.cts.verifier.testresultsprovider/reports
หากต้องการดาวน์โหลดรายงานจากรายการ คุณสามารถระบุรหัสแถวหรือชื่อไฟล์ได้ ตัวอย่างเช่น:
adb shell content read --user CURRENT_USER --uri content://com.android.cts.verifier.testresultsprovider/reports/0 > report.zip adb shell content read --user CURRENT_USER --uri content://com.android.cts.verifier.testresultsprovider/reports/ctsVerifierReport-date-time.zip > report.zip
หากต้องการล้างผลลัพธ์ที่ผ่าน/ไม่ผ่าน ให้เลือกผลลัพธ์ในแอป CTS Verifier และเลือก Menu > Clear