กำลังใช้ CTS Verifier

Test Suite Verifier (CTS Verifier) ความเข้ากันได้กับ Android เป็นส่วนเสริมของ ชุดเครื่องมือทดสอบความเข้ากันได้ (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 และ Bluetooth 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

    • ดาวน์โหลด CTS Verifier APK สำหรับ เวอร์ชัน 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 Verifier โดยแตะไอคอน CTS Verifier ใน DUT

ไอคอน CTS Verifier ใน Launcher

รูปที่ 1 ไอคอนผู้ตรวจสอบ CTS

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

เมนูเครื่องมือยืนยัน CTS ของการทดสอบ

รูปที่ 2 เมนูเครื่องมือยืนยัน CTS ของการทดสอบ

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

ตัวตรวจสอบคุณภาพการสตรีมวิดีโอ

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

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

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

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

การทดสอบอุปกรณ์เสริม USB ของ CTS Verifier

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

การทดสอบอุปกรณ์เสริม USB ของ CTS Verifier

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

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

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

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

  2. เรียกใช้โปรแกรม cts-usb-accessory จาก CTS ในคอมพิวเตอร์ แพ็กเกจผู้ตรวจสอบ:

    ./cts-usb-accessory

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

    รูปที่ 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 จะมีปุ่มแสดงขึ้นมาเพื่อให้คุณเปิดใช้ ผู้ใช้สลับไปมาได้ระหว่างโหมดการแสดงผลกางและพับ ผู้ตรวจสอบ CTS จะแสดง การทดสอบที่จําเป็นสําหรับโหมดการแสดงผลที่เลือก เพื่อดำเนินการคำสั่งสำรอง โหมดต่างๆ ในเครื่องมือตรวจสอบ CTS ผู้ใช้ควรสลับปุ่มไปยังจอแสดงผลที่เหมาะสม และเรียกใช้รายการการทดสอบที่แสดง

สวิตช์เปิด/ปิด CTS-V

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

<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 และ เลือก เมนู > ล้าง