เรียกใช้การทดสอบ CTS-V

โปรแกรมตรวจสอบชุดเครื่องมือทดสอบความเข้ากันได้ของ Android (CTS Verifier) จะช่วยเสริม ชุดเครื่องมือทดสอบความเข้ากันได้ (CTS) แม้ว่า CTS จะตรวจสอบ API และฟังก์ชันที่ ทำให้เป็นอัตโนมัติได้ แต่ CTS Verifier จะมีการทดสอบสำหรับ API และฟังก์ชันที่ ทดสอบในอุปกรณ์แบบอยู่กับที่ไม่ได้หากไม่มีการป้อนข้อมูลหรือการวางตำแหน่งด้วยตนเอง เช่น คุณภาพเสียง หน้าจอสัมผัส มาตรความเร่ง และกล้อง

ข้อกำหนด

ก่อนเรียกใช้ CTS Verifier โปรดตรวจสอบว่าคุณมีอุปกรณ์ต่อไปนี้

  • อุปกรณ์ Android ที่ยืนยันความเข้ากันได้ของ Android API โดยผ่าน CTS เรียบร้อยแล้ว นี่คืออุปกรณ์ภายใต้การทดสอบ (DUT)
  • คอมพิวเตอร์ Linux ที่มีพอร์ตที่รองรับ USB 2.0 การเชื่อมต่อทั้งหมดกับ DUT จะผ่านพอร์ตนี้
  • อุปกรณ์ Android เครื่องที่ 2 ที่มีบลูทูธ, Wi-Fi Direct, Wi-Fi Aware, UWB (หาก DUT รองรับ UWB) และการจำลองบัตรโฮสต์ NFC (HCE) ที่เข้ากันได้
  • เราเตอร์ Wi-Fi ที่กำหนดค่าด้วยชื่อและรหัสผ่านของจุดเข้าใช้งาน เราเตอร์ ควรมีฟีเจอร์ที่ตัดการเชื่อมต่อจากอินเทอร์เน็ตได้ แต่ไม่ควรปิด เครื่อง

นอกจากนี้ โปรดเตรียมขาตั้งกล้อง ที่ยึดอุปกรณ์ และระยะทางที่วัดไว้ล่วงหน้า ซึ่งจำเป็นสำหรับการทดสอบการวัดระยะทาง (ความใกล้เคียง) สำหรับ UWB, Wi-Fi NAN และ RSSI ของบลูทูธ ดูรายละเอียดได้ที่ การปรับเทียบการตรวจหาบุคคล

ข้อกำหนด UICC สำหรับการทดสอบ NFC

CTS Verifier มีกรณีทดสอบ NFC ต่อไปนี้

  • ฟิลด์ออฟ (ใช้ข้อมูลธุรกรรมจาก 0x54)
  • ยกเลิกการเลือก (ใช้ข้อมูลธุรกรรมจาก 0x52)
  • คำสั่ง HCI (0025000000) (ใช้ข้อมูลธุรกรรมจาก 0x02)

การทดสอบเหตุการณ์ธุรกรรมต้องใช้อุปกรณ์ 2 เครื่อง โดยเครื่องหนึ่งต้องมี SecureElement UICC ที่มีกฎการเข้าถึงต่อไปนี้

  • แฮช APK ของ CtsVerifier: 61:ED:37:7E:85:D3:86:A8:DF:EE:6B:86:4B:D8:5B:0B:FA:A5:AF:81
  • ตัวระบุแอปพลิเคชันที่ได้รับอนุญาต (AID) สำหรับการเข้าถึงกิจกรรม NFC: 0xA000000476416E64726F696443545341

ในส่วนของโปรแกรมจำลอง เราคาดว่าเหตุการณ์ธุรกรรมจะพุชกิจกรรมที่เกี่ยวข้อง ไปที่เบื้องหน้า

ตั้งค่า

เปลี่ยนโหมดการนำทางของระบบในอุปกรณ์ทดสอบเป็นโหมด 3 ปุ่มโดยทำดังนี้

  1. เปิดการตั้งค่า
  2. ไปที่ระบบ > ท่าทางสัมผัส > การนำทางของระบบ
  3. เลือกโหมดการนำทางแบบปุ่มใดก็ได้ โดยควรเลือกโหมด 3 ปุ่ม หากมี

วิธีตั้งค่าสภาพแวดล้อมการทดสอบ CTS Verifier

  1. ในคอมพิวเตอร์ Linux ให้ทำดังนี้

    • เรียกใช้คำสั่งต่อไปนี้ก่อนติดตั้ง CTS Verifier เพื่ออนุญาต การเข้าถึงอินเทอร์เฟซที่ไม่ใช่ SDK

      adb shell settings put global hidden_api_policy 1

    • ติดตั้ง Android Studio

    • ดาวน์โหลด APK ของ CTS Verifier สำหรับ Android เวอร์ชันที่จะทดสอบ

  2. เชื่อมต่อ DUT กับคอมพิวเตอร์ Linux

  3. จากเทอร์มินัลในคอมพิวเตอร์ Linux ให้ติดตั้ง CtsVerifier.apk ใน DUT

    adb install -r -g CtsVerifier.apk

  4. สำหรับ Android 10 ขึ้นไป ให้เรียกใช้คำสั่งต่อไปนี้ เพื่อให้สิทธิ์แก่แอปในการสร้างรายงาน

    adb shell appops set com.android.cts.verifier android:read_device_identifiers allow

  5. สำหรับ Android 11 ขึ้นไป ให้เรียกใช้คำสั่งต่อไปนี้เพื่ออนุญาตให้บันทึกรายงานในไดเรกทอรีที่กำหนดเองภายใต้ไดเรกทอรีระดับบนสุดภายนอกของอุปกรณ์

    adb shell appops set com.android.cts.verifier MANAGE_EXTERNAL_STORAGE 0

  6. สำหรับ Android 13 ขึ้นไป ให้เรียกใช้คำสั่งต่อไปนี้เพื่ออนุญาตการเข้าถึง API สำหรับทดสอบสำหรับ CTS Verifier

    adb shell am compat enable ALLOW_TEST_API_ACCESS com.android.cts.verifier

  7. สำหรับ Android 14 ขึ้นไป ให้เรียกใช้คำสั่งต่อไปนี้ เพื่อให้สิทธิ์แอปในการเปิดหน้าจอ

    adb shell appops set com.android.cts.verifier TURN_SCREEN_ON 0

  8. ตรวจสอบว่า DUT ตั้งค่าวันที่และเวลาของระบบอย่างถูกต้อง

เรียกใช้โปรแกรมตรวจสอบ CTS

เปิดแอปพลิเคชันโปรแกรมตรวจสอบ CTS โดยแตะไอคอนโปรแกรมตรวจสอบ CTS ใน DUT

ไอคอน CTS Verifier ใน Launcher

รูปที่ 1 ไอคอนโปรแกรมตรวจสอบ CTS

แอปจะแสดงชุดการทดสอบหลายชุดที่พร้อมสำหรับการยืนยันด้วยตนเอง

เมนูการทดสอบของโปรแกรมตรวจสอบ CTS

รูปที่ 2 เมนูการทดสอบของโปรแกรมตรวจสอบ CTS

การทดสอบแต่ละครั้งจะมีชุดองค์ประกอบทั่วไปที่ด้านล่างของหน้าจอ

เครื่องมือตรวจสอบคุณภาพวิดีโอสตรีมมิง

รูปที่ 3 หน้าจอทดสอบที่มีการไฮไลต์องค์ประกอบทดสอบทั่วไป

  • ผ่าน (✓) แตะหาก DUT เป็นไปตามข้อกำหนดการทดสอบตามวิธีการในข้อมูล
  • ข้อมูล (?) แตะเพื่อแสดงวิธีการทดสอบ และจะปรากฏขึ้นโดยอัตโนมัติ เมื่อเปิดการทดสอบเป็นครั้งแรก
  • ไม่ผ่าน (!): แตะหาก DUT ไม่เป็นไปตามข้อกำหนดในการทดสอบตามคำแนะนำในข้อมูล

การทดสอบบางอย่าง เช่น โหมดอุปกรณ์เสริม USB และการทดสอบการปรับเทียบกล้อง ต้องมีการตั้งค่าการทดสอบและวิธีการเพิ่มเติมตามที่ระบุไว้ในส่วนต่อไปนี้

ทดสอบโหมดอุปกรณ์เสริม USB สำหรับ 8.0 ขึ้นไป

การทดสอบอุปกรณ์เสริม USB ของโปรแกรมตรวจสอบ CTS

รูปที่ 4 ขั้นตอนการทดสอบอุปกรณ์เสริม USB สำหรับ 8.0 และ สูงกว่า

การทดสอบอุปกรณ์เสริม USB ของโปรแกรมตรวจสอบ CTS

รูปที่ 5 การทดสอบโหมดอุปกรณ์เสริม USB สำหรับ 8.0 ขึ้นไป

ทดสอบโหมดอุปกรณ์เสริม USB สำหรับ 7.x และต่ำกว่า

การทดสอบอุปกรณ์เสริม USB ต้องใช้คอมพิวเตอร์ Linux เพื่อเรียกใช้โปรแกรมเครื่องเดสก์ท็อป USB (โฮสต์)

  1. เชื่อมต่อ DUT กับคอมพิวเตอร์ Linux

  2. ในคอมพิวเตอร์ ให้เรียกใช้โปรแกรม cts-usb-accessory จากแพ็กเกจ CTS Verifier ดังนี้

    ./cts-usb-accessory

  3. รอให้ข้อความป๊อปอัปปรากฏบน DUT แล้วเลือกตกลง
    การทดสอบอุปกรณ์เสริม USB ของโปรแกรมตรวจสอบ CTS

    รูปที่ 6 การทดสอบอุปกรณ์เสริม USB

  4. ไปที่การทดสอบอุปกรณ์เสริม USB ในแอปพลิเคชัน CTS Verifier บน DUT

  5. ตรวจสอบเอาต์พุตจากคอนโซลในคอมพิวเตอร์ ตัวอย่างเอาต์พุต

    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

ปรับเทียบขอบเขตการมองเห็นของกล้อง

ใช้ขั้นตอนการปรับเทียบมุมมองเพื่อกำหนดมุมมองของอุปกรณ์อย่างรวดเร็วด้วยความแม่นยำปานกลาง

  1. ตั้งค่าสภาพแวดล้อมการทดสอบ

    1. พิมพ์ไฟล์เป้าหมาย calibration-pattern.pdf บนกระดาษขนาด 11" x 17" หรือ A3
    2. ติดลวดลายที่พิมพ์บนแผ่นรองที่แข็ง

    3. วางอุปกรณ์กล้องและเป้าหมายที่พิมพ์ออกมาดังที่แสดงใน แผนภาพต่อไปนี้
      เป้าหมายที่พิมพ์ของกล้อง

      รูปที่ 7 เป้าหมายที่พิมพ์ของกล้อง

  2. ตั้งค่าความกว้างเป้าหมาย

    1. วัดระยะห่าง (เป็นเซนติเมตร) ระหว่างเส้นทึบบน รูปแบบเป้าหมายเพื่อพิจารณาความไม่แม่นยำในการพิมพ์ (~38 ซม.)
    2. เริ่มแอปพลิเคชันการปรับเทียบ
    3. กดปุ่มตั้งค่า แล้วเลือกระยะทางของเครื่องหมาย
    4. วัดและป้อนระยะทางไปยังรูปแบบเป้าหมาย (~100 ซม.)
    5. กดปุ่มย้อนกลับเพื่อกลับไปที่ตัวอย่างการปรับเทียบ

  3. ตรวจสอบว่าวางอุปกรณ์และเป้าหมายตามที่แสดงในรูป และป้อน ระยะทางที่ถูกต้องลงในกล่องโต้ตอบการตั้งค่า การแสดงตัวอย่าง จะแสดงรูปภาพที่มีเส้นแนวตั้งซ้อนทับอยู่ โดยเส้นนี้ควร จัดแนวให้ตรงกับเส้นกึ่งกลางของรูปแบบเป้าหมาย สามารถใช้ตารางกริดแบบโปร่งใส ร่วมกับเส้นแนวตั้งอื่นๆ เพื่อให้แน่ใจว่าแกนแสง ตั้งฉากกับเป้าหมาย

  4. เรียกใช้การทดสอบการปรับเทียบ

    1. เลือกความละเอียดของรูปภาพ (ใช้ตัวเลือกที่ด้านซ้ายล่าง) แล้วแตะหน้าจอเพื่อถ่ายรูป การทดสอบจะเข้าสู่โหมดการปรับเทียบและ แสดงรูปภาพที่มีเส้นแนวตั้ง 2 เส้นซ้อนทับบนรูปภาพ
    2. พิจารณาความถูกต้อง
      • หากเส้นตรงตรงกับเส้นแนวตั้งในรูปแบบเป้าหมาย ภายในไม่กี่เซนติเมตร แสดงว่าฟิลด์มุมมองที่รายงานสำหรับความละเอียดที่เลือก นั้นถูกต้อง
      • หากเส้นไม่ตรงกัน แสดงว่าฟิลด์มุมมองที่รายงานไม่ถูกต้อง หากต้องการแก้ไข ให้ปรับแถบเลื่อนที่ด้านล่างของหน้าจอจนกว่า ภาพซ้อนทับจะอยู่ในแนวเดียวกับรูปแบบเป้าหมายมากที่สุด เมื่อภาพซ้อนทับและรูปภาพรูปแบบเป้าหมายอยู่ในแนวเดียวกัน มุมมองที่แสดงจะใกล้เคียงกับค่าที่ถูกต้อง ฟิลด์ของมุมมองที่รายงานควรอยู่ภายใน +/-2 องศาของ ค่าการปรับเทียบ
    3. กดปุ่มย้อนกลับและทำการทดสอบการปรับเทียบซ้ำสำหรับความละเอียดของรูปภาพทั้งหมด ที่ DUT รองรับ

เรียกใช้ CTS Verifier สำหรับโหมดอื่น

ตั้งแต่ CTS 10 R6 และ CTS 11 R2 เป็นต้นไป CTS Verifier จะรองรับการทดสอบที่จำเป็น สำหรับอุปกรณ์ที่มีโหมดอื่น หรือสำหรับอุปกรณ์ที่มีโหมดหน้าจอมากกว่า 1 โหมด

ที่ด้านบนของมุมมองรายการหลักใน CTS Verifier จะมีปุ่มที่ช่วยให้ผู้ใช้สลับระหว่างโหมดการแสดงผลแบบกางและพับได้ CTS Verifier จะแสดง การทดสอบที่จำเป็นสำหรับโหมดการแสดงผลที่เลือก หากต้องการเรียกใช้โหมดอื่นใน CTS Verifier ผู้ใช้ควรเปลี่ยนปุ่มเป็นโหมดการแสดงผลที่เหมาะสมและเรียกใช้รายการการทดสอบที่แสดง

สวิตช์สลับ CTS-V

รูปที่ 8 สวิตช์สลับโปรแกรมตรวจสอบ CTS

ระบบจะบันทึกผลลัพธ์ของการทดสอบที่พับไว้ในรายงานเดียวกันกับการทดสอบที่กางออก หากต้องการระบุผลการทดสอบแต่ละรายการที่มาจากชุดการทดสอบ ระบบจะเพิ่ม คำต่อท้ายลงในชื่อการทดสอบแต่ละรายการในโหมดพับ

<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

  1. หากต้องการบันทึกผลการทดสอบ ให้แตะไอคอนบันทึก (ดิสก์) ที่ด้านบนของรายการ หมวดหมู่การทดสอบ

  2. รอข้อความป๊อปอัปที่แสดงเส้นทางไฟล์ไปยังรายงานที่บันทึกไว้ (เช่น /sdcard/verifierReports/ctsVerifierReport-date-time.zip) จากนั้น บันทึกเส้นทาง

  3. เชื่อมต่อ DUT กับคอมพิวเตอร์ Linux

  4. จากการติดตั้ง 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

  5. หากต้องการล้างผลการทดสอบที่ผ่าน/ไม่ผ่าน ให้เลือกผลการทดสอบในแอป CTS Verifier แล้วเลือกเมนู > ล้าง