ตั้งค่า CTS

หากต้องการเรียกใช้ CTS ก่อนอื่นให้เตรียมสภาพแวดล้อมจริง เครื่องเดสก์ท็อป และ อุปกรณ์ Android ที่คุณใช้ทดสอบ

สภาพแวดล้อมทางกายภาพ

บีคอน LE บลูทูธ

หากอุปกรณ์ที่อยู่ภายใต้การทดสอบ (DUT) รองรับ Bluetooth LE ให้วาง 3 อุปกรณ์เป็นอย่างน้อย บีคอน LE ของบลูทูธในระยะ 5 เมตรจาก DUT สำหรับการทดสอบการสแกน Bluetooth LE บีคอนเหล่านี้ไม่จำเป็นต้องกำหนดค่าหรือปล่อยสัญญาณอะไรเป็นพิเศษ และสามารถ อุปกรณ์ใดก็ได้ รวมถึง iBeacon, Eddystone หรือแม้แต่อุปกรณ์ที่จำลองบีคอน BLE

แถบความถี่กว้างยิ่งยวด

หาก DUT รองรับแถบความถี่กว้างยิ่งยวด (UWB) อุปกรณ์อื่น UWB ที่รองรับต้องมีการวางตำแหน่งที่เหมาะสมและสอดคล้องกันเพื่อไม่ให้มี เสาอากาศและโซนเดือดวิทยุ สำหรับการทดสอบความแม่นยำระยะทาง มี การกำหนดตำแหน่งและการวางแนวที่เฉพาะเจาะจง ดูรายละเอียดการตั้งค่าได้ที่ ข้อกำหนดของ UWB ต้องทำการทดสอบ UWB ด้วยตนเอง โดยระบุบรรทัดคำสั่งว่า อุปกรณ์อยู่ห่างกัน 1 เมตร ดูรายละเอียดเกี่ยวกับการชาร์ดดิ้งที่จำเป็นสำหรับการทดสอบนี้ได้ที่ ชาร์ดดิ้งในเครื่อง

กล้อง

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

เล็งเซ็นเซอร์กล้องไปยังฉากที่มีแสงเพียงพอเพื่อให้ เซ็นเซอร์อยู่ระหว่างทดสอบเพื่อให้เข้าถึงได้ และยังคงอยู่ที่เฟรมเป้าหมายที่กำหนดค่าไว้สูงสุด ต่อวินาที (FPS) ตามที่ระบุไว้ใน CONTROL_AE_TARGET_FPS_RANGE ซึ่งจะมีผลกับเซ็นเซอร์กล้องทั้งหมดที่รายงานโดย getCameraIdList ขณะทดสอบซ้ำๆ กับอุปกรณ์ที่ระบุไว้และวัดประสิทธิภาพ แยกกัน

หาก DUT รองรับกล้องภายนอก เช่น เว็บแคม USB ให้เสียบปลั๊กกล้องภายนอก เมื่อใช้ CTS ไม่เช่นนั้นการทดสอบ CTS จะล้มเหลว

GPS/GNSS

หาก DUT รองรับระบบระบุตำแหน่งบนพื้นโลก/ดาวเทียมนำทางทั่วโลก คุณลักษณะระบบ (GPS/GNSS) ให้สัญญาณ GPS/GNSS กับ DUT ในสถานที่ที่เหมาะสม ระดับสัญญาณสำหรับการรับและการคำนวณตำแหน่ง GPS ส่วน GPS ต้อง สอดคล้องกับ ICD-GPS-200C ไม่เช่นนั้น สัญญาณ GPS/GNSS จะเป็นอะไรก็ได้ รวมถึงเครื่องจำลองดาวเทียมหรือตัวส่งสัญญาณซ้ำ GPS/GNSS กับสัญญาณกลางแจ้ง หรือ คุณสามารถวาง DUT ไว้ใกล้หน้าต่างพอที่จะรับ สัญญาณ GPS/GNSS ที่เพียงพอ

Wi-Fi และ IPv6

การทดสอบ CTS ต้องมีเครือข่าย Wi-Fi ที่รองรับ IPv4 และ IPv6 และมีอินเทอร์เน็ต เชื่อมต่อกับ DNS ที่ใช้งานได้สําหรับ IPv4 และ IPv6 รองรับ IP Multicast และสามารถ ถือว่า DUT เป็นไคลเอ็นต์ที่แยกต่างหาก ไคลเอ็นต์แบบแยกคือการกำหนดค่าที่ DUT ไม่มี การมองเห็นข้อความบรอดแคสต์/มัลติเครือข่ายในเครือข่ายย่อยนั้นๆ ช่วงเวลานี้ เกิดขึ้นกับการกำหนดค่าจุดเข้าใช้งาน (AP) หรือโดยการเรียกใช้ DUT บนอุปกรณ์ เครือข่ายย่อยที่แยกต่างหากโดยไม่มีการเชื่อมต่ออุปกรณ์อื่นๆ

หากคุณไม่มีสิทธิ์เข้าถึงเครือข่าย IPv6 แบบดั้งเดิม เครือข่ายผู้ให้บริการ IPv6 หรือ VPN จะผ่านการทดสอบบางอย่าง ซึ่งขึ้นอยู่กับ IPv6 คุณสามารถใช้จุดเข้าใช้งาน Wi-Fi และ IPv6 Tunnel

หากต้องการผ่าน CTS DUT จะต้องตั้งค่าแฟล็ก UP, BROADCAST และ MULTICAST อินเทอร์เฟซ Wi-Fi อินเทอร์เฟซ Wi-Fi ต้องมีการกำหนดที่อยู่ IPv4 และ IPv6 ตรวจสอบคุณสมบัติของอินเทอร์เฟซ Wi-Fi ด้วย adb shell ifconfig

สำหรับอุปกรณ์ที่รองรับ การเชื่อมต่อ Wi-Fi STA/STA พร้อมกัน ต้องใช้เครือข่าย Wi-Fi หลายเครือข่าย (อย่างน้อย 2 เครือข่าย) หากต้องการส่งผ่าน CTS การเชื่อมต่อ Wi-Fi เครือข่ายต้องทำงานในย่านความถี่ที่แตกต่างกันที่มี SSID หรือบน SSID เดียวกันแต่มี BSSID ต่างกัน

RTT ของ Wi-Fi

Android ประกอบด้วย RTT API ของ Wi-Fi สำหรับระยะเวลารับส่งข้อมูล Wi-Fi (RTT) แบบพื้นฐาน ซึ่งช่วยให้อุปกรณ์วัดระยะทางไปยังจุดเข้าใช้งาน ความแม่นยำ 1 ถึง 2 เมตร ซึ่งจะช่วยเพิ่มความแม่นยำของตำแหน่งในอาคารอย่างมาก อุปกรณ์ที่แนะนำ 2 ตัวที่รองรับ RTT ของ Wi-Fi ได้แก่ Google Wifi และ จุดเข้าใช้งาน fitlet2 ของ Compulab (ตั้งค่าเป็นแบนด์วิดท์ 40 MHz ที่ 5 GHz)

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

การตั้งค่าเครื่องเดสก์ท็อป

ข้อควรระวัง: CTS รองรับเครื่อง Linux 64 บิต ระบบปฏิบัติการ Windows ไม่รองรับ CTS หรือ MacOS

FFMPEG

ติดตั้งแพ็กเกจ ffmpeg เวอร์ชัน 5.1.3 (ขึ้นไป) ในเครื่องโฮสต์

การอัปเกรดเครื่องโฮสต์

ขอแนะนําอย่างยิ่งให้อัปเกรด RAM ของเครื่องโฮสต์ CTS เป็น 128 GB และอัปเกรด HDD เป็น 256 GB จำเป็นต้องรองรับกรอบการทดสอบ CTS ที่เพิ่มขึ้นและการจองพื้นที่ฮีปของ Java ที่เพิ่มขึ้นในการแลกเปลี่ยน

ADB และ AAPT2

ก่อนที่จะเรียกใช้ CTS ให้ตรวจสอบว่าคุณได้ติดตั้งเวอร์ชันล่าสุดของ ทั้งคู่ Android Debug Bridge (adb) และ Android Asset Pack Tool (AAPT2) และเพิ่มตำแหน่งของเครื่องมือเหล่านั้นลงในเส้นทางระบบของเครื่อง

หากต้องการติดตั้ง ADB และ AAPT2 ให้ดาวน์โหลดเวอร์ชันล่าสุด เครื่องมือแพลตฟอร์ม Android SDK และ เครื่องมือสร้าง Android SDK จาก Android Studio เครื่องมือจัดการ SDK หรือจาก SDK Manager เครื่องมือบรรทัดคำสั่ง

ตรวจสอบว่า adb และ aapt2 อยู่ในเส้นทางระบบของคุณ คำสั่งต่อไปนี้ จะถือว่าคุณได้ดาวน์โหลดข้อมูลแพ็กเกจที่เก็บไว้ไปยังไดเรกทอรีย่อยที่ชื่อ android-sdk ในไดเรกทอรีหลักของคุณ:

export PATH=$PATH:$HOME/android-sdk/platform-tools:$HOME/android-sdk/build-tools/<tools version number>

Java Development Kit สำหรับ Ubuntu

ติดตั้งเวอร์ชันที่เหมาะสมของ Java Development Kit (JDK)

• สำหรับ Android 11 ให้ติดตั้ง OpenJDK11
• สำหรับ Android 9 และ Android 10 ติดตั้ง OpenJDK9
• สำหรับ Android 7.0, 7.1, 8.0 และ 8.1 ให้ติดตั้ง OpenJDK8

โปรดดูรายละเอียดที่หัวข้อข้อกำหนดของ JDK

การตั้งค่าสำหรับการรองรับ Python

ติดตั้ง virtualenv สำหรับแพลตฟอร์มโดยทำตาม การติดตั้ง วิธีทำ

คุณยืนยันว่าการติดตั้งเสร็จสมบูรณ์ได้โดยเรียกใช้ virtualenv -h

ไฟล์ CTS

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

ดาวน์โหลดและเปิดเวอร์ชันล่าสุดของ ไฟล์สื่อ CTS

ดาวน์โหลดไฟล์ CTS ที่เกี่ยวข้องกับเมนไลน์ (ไม่บังคับ)

เมื่อคุณเรียกใช้เวอร์ชัน CTS เป็นครั้งแรก CTS จะดาวน์โหลดแบบไดนามิก ไฟล์ CTS ที่เกี่ยวข้องกับเมนไลน์ ซึ่งเพิ่มเวลาทำงานอย่างน้อย 10 นาที ทั้งนี้ขึ้นอยู่กับความเร็วของเครือข่าย

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

1. ดูระดับ API ของ Android ในอุปกรณ์โดยเรียกใช้สิ่งต่อไปนี้

   adb shell getprop ro.build.version.sdk
   

2. ทำตามวิธีการในสคริปต์ download_mcts.sh เพื่อดาวน์โหลดไฟล์ Mainline CTS

   การดาวน์โหลดจะใช้เวลาอย่างน้อย 10 นาที ทั้งนี้ขึ้นอยู่กับความเร็วของเครือข่าย

การตรวจจับอุปกรณ์

ทำตามขั้นตอนเพื่อ ตั้งค่าระบบเพื่อตรวจหาอุปกรณ์ของคุณ

ขีดจำกัดหน่วยความจำ

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

การตั้งค่าอุปกรณ์ Android

บิลด์ผู้ใช้

อุปกรณ์ที่เข้ากันได้หมายถึงอุปกรณ์ที่มีบิลด์ที่รับรองโดยผู้ใช้/คีย์การเผยแพร่ อุปกรณ์ควรเรียกใช้อิมเมจระบบตามที่ทราบกันว่าใช้งานร่วมกันได้ บิลด์ผู้ใช้ (Android 4.0 ขึ้นไป) จาก ชื่อเวอร์ชัน แท็ก และหมายเลขบิลด์

พร็อพเพอร์ตี้ของบิลด์ระดับ API แรก

ข้อกำหนด CTS บางรายการขึ้นอยู่กับบิลด์ของอุปกรณ์ในตอนแรก จัดส่งด้วย ตัวอย่างเช่น อุปกรณ์ที่แต่เดิมมีรุ่นก่อนหน้านี้ อาจไม่รวมอยู่ในข้อกำหนดของระบบที่บังคับใช้กับอุปกรณ์ที่จัดส่งด้วย ของเวอร์ชันต่อๆ ไป

เพื่อให้ข้อมูลนี้พร้อมใช้งานสำหรับ CTS ผู้ผลิตอุปกรณ์ กำหนดพร็อพเพอร์ตี้เวลาบิลด์ ro.product.first_api_level แล้ว ค่าของ คือ API ระดับแรกที่มีการเปิดตัวอุปกรณ์ในเชิงพาณิชย์

ผู้ผลิตอุปกรณ์สามารถนำวิธีการใช้งานพื้นฐานทั่วไปมาใช้ซ้ำเพื่อ เปิดตัวผลิตภัณฑ์ใหม่เป็นการอัปเกรดผลิตภัณฑ์ที่มีอยู่แล้วในอุปกรณ์เดียวกัน กลุ่ม ผู้ผลิตอุปกรณ์สามารถตั้งค่าระดับ API ของ ผลิตภัณฑ์เป็น ro.product.first_api_level ดังนั้นข้อกำหนดในการอัปเกรดมีดังนี้ สำหรับ CTS และ Treble/VTS

ผู้ผลิตอุปกรณ์จะกำหนด PRODUCT_SHIPPING_API_LEVEL ใน device.mk เพื่อตั้งค่าพร็อพเพอร์ตี้นี้ ดังที่ปรากฏในตัวอย่างต่อไปนี้

# PRODUCT_SHIPPING_API_LEVEL sets ro.product.first_api_level to indicate
# the first api level that the device has been commercially launched on.
PRODUCT_SHIPPING_API_LEVEL := 21

API ระดับแรกสำหรับ Android 9 ขึ้นไป

สำหรับอุปกรณ์ที่เปิดตัวด้วย Android 9 ขึ้นไป ให้ตั้งค่า พร็อพเพอร์ตี้ ro.product.first_api_level เป็นค่าที่ถูกต้องตั้งแต่ ชื่อเวอร์ชัน แท็ก และหมายเลขบิลด์

API ระดับแรกสำหรับ Android 8.x หรือต่ำกว่า

สำหรับอุปกรณ์ที่เปิดตัวใน Android 8.x หรือต่ำกว่า ให้ยกเลิกการตั้งค่า (นำออก) พร็อพเพอร์ตี้ ro.product.first_api_level สำหรับบิลด์แรกของผลิตภัณฑ์ สำหรับ บิลด์ต่อๆ มาทั้งหมด ให้ตั้งค่า ro.product.first_api_level เป็นระดับ API ที่ถูกต้อง วิธีนี้ช่วยให้พร็อพเพอร์ตี้ระบุผลิตภัณฑ์ใหม่ได้อย่างถูกต้องและ เก็บข้อมูลเกี่ยวกับ API ระดับแรกของผลิตภัณฑ์ไว้ หากแฟล็กคือ ไม่ได้ตั้งค่า Android จะกำหนด Build.VERSION.SDK_INT ให้กับ ro.product.first_api_level

แพ็กเกจชิมของ CTS

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

การทดสอบการตรวจสอบ APEX shim จะยืนยันการติดตั้งใช้งาน CtsShimApex

ข้อกำหนดเกี่ยวกับ ro.apex.updatable

• หากตั้งค่าพร็อพเพอร์ตี้ ro.apex.updatable เป็น true ค่า CtsShimApex จะเป็น ซึ่งจำเป็นสำหรับอุปกรณ์ทั้งหมดที่รองรับการจัดการแพ็กเกจ APEX

• หากพร็อพเพอร์ตี้ ro.apex.updatable ขาดหายไปหรือไม่ได้ตั้งค่าไว้ CtsShimApex ไม่จำเป็นต้องติดตั้งไว้ล่วงหน้าในอุปกรณ์

การทดสอบการตรวจสอบ APEX shim จะยืนยันการติดตั้งใช้งาน CtsShimApex

การติดตั้งล่วงหน้าและการโหลดล่วงหน้าของ CtsShim

ตั้งแต่ Android 11 เป็นต้นไป CtsShimApex มี แอปที่สร้างไว้ล่วงหน้า (สร้างจาก ต้นทางของการสร้าง) ซึ่งไม่มีโค้ดใดๆ ยกเว้นไฟล์ Manifest CTS ใช้แอปเหล่านี้เพื่อ สิทธิ์และสิทธิ์ทดสอบ

หากอุปกรณ์ไม่รองรับการจัดการแพ็กเกจ APEX (กล่าวคือ ไม่มีพร็อพเพอร์ตี้ ro.apex.updatable หรือไม่ได้ตั้งค่าไว้) หรือหากอุปกรณ์ เวอร์ชัน 10 หรือต่ำกว่า แอปที่สร้างไว้ล่วงหน้า 2 แอปจะต้อง ติดตั้งไว้ล่วงหน้าในระบบแยกต่างหาก

หากมีการรองรับ APEX ต้องติดตั้งล่วงหน้าสำหรับรุ่นที่เหมาะสมเป็น /system/apex/com.android.apex.cts.shim.apex

หากใช้แอปที่สร้างไว้ล่วงหน้าตามปกติ CtsShimและCtsShimPrivสำหรับ การเผยแพร่ที่เหมาะสมต้องเป็น /system/app/CtsShimPrebuilt.apk และ /system/priv-app/CtsShimPrivPrebuilt.apk ตามลำดับ

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

เวอร์ชันอุปกรณ์	ติดตั้ง ล่วงหน้า (หากรองรับ APEX)		โหลดล่วงหน้า
	เปิดระบบ	X86	เปิดระบบ	X86
Android 14	android14-arm-release	android14-x86-release	android14-arm-CtsShim.apk android14-arm-CtsShimPriv.apk	android14-x86-CtsShim.apk android14-x86-CtsShimPriv.apk
Android 13	android13-arm-release	android13-x86-release	android13-arm-CtsShim.apk android13-arm-CtsShimPriv.apk	android13-x86-CtsShim.apk android13-x86-CtsShimPriv.apk
Android 12	รุ่น Android12-arm-release	android12-x86-release	android12-arm-CtsShim.apk android12-arm-CtsShimPriv.apk	android12-x86-CtsShim.apk android12-x86-CtsShimPriv.apk
Android 11	android11-arm-release	android11-x86-release	android11-arm-CtsShim.apk android11-arm-CtsShimPriv.apk	android11-x86-CtsShim.apk android11-x86-CtsShimPriv.apk
Android 10	รุ่น android 10		android10-arm-CtsShim.apk android10-arm-CtsShimPriv.apk	android10-x86-CtsShim.apk android10-x86-CtsShimPriv.apk
Android 9, O และ O-MR1	ไม่มี	ไม่มี	arm-CtsShim.apk arm-CtsShimPriv.apk	x86-CtsShim.apk x86-CtsShimPriv.apk

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

แอปเพล็ตตัวอย่าง

Android 9 เปิดตัว Open Mobile API สําหรับอุปกรณ์ที่รายงานมากกว่า องค์ประกอบความปลอดภัย CTS จะเพิ่มกรอบการทดสอบเพื่อตรวจสอบลักษณะการทำงานของ Open Mobile API กรณีทดสอบเหล่านี้จำเป็นต้องติดตั้งแอปเพล็ตตัวอย่างเพียงครั้งเดียวลงใน องค์ประกอบความปลอดภัยที่ฝังไว้ (eSE) ของ DUT หรือในซิมการ์ดที่ใช้โดย DUT แอปเพล็ตตัวอย่าง eSE และ แอปเพล็ตตัวอย่างซิม สามารถพบได้ใน AOSP

ดูการทดสอบ CTS สำหรับองค์ประกอบความปลอดภัยสำหรับ รายละเอียดเพิ่มเติมเกี่ยวกับกรณีการทดสอบ Open Mobile API และการทดสอบการควบคุมการเข้าถึง กรณี

ข้อกำหนดด้านพื้นที่เก็บข้อมูล

การทดสอบความเข้มงวดของสื่อ CTS กำหนดให้วิดีโอคลิปต้องอยู่บนที่จัดเก็บข้อมูลภายนอก (/sdcard) คลิปส่วนใหญ่มาจาก Big Buck Bunny ซึ่งมีลิขสิทธิ์ โดย Blender Foundation สัญญาอนุญาตครีเอทีฟคอมมอนส์ (Creative Commons Attribution License) 3.0

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

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

• 480x360: 98 MB
• 720x480: 193 MB
• 1280x720: 606 MB
• 1920x1080: 1863 MB

หน้าจอและพื้นที่เก็บข้อมูล

• อุปกรณ์ใดก็ตามที่ไม่มีหน้าจอฝังอยู่ จะต้องเชื่อมต่อกับ บนหน้าจอ

• หากอุปกรณ์มีช่องเสียบการ์ดหน่วยความจำ ให้เสียบการ์ด SD ที่ว่างเปล่า ใช้ SD การ์ดที่รองรับบัสความเร็วสูงพิเศษ (UHS) ที่มีความจุ SDHC หรือ SDXC หรือ ที่มีคลาสความเร็ว 10 ขึ้นไปเป็นอย่างน้อยเพื่อให้แน่ใจว่าจะผ่าน CTS

• หากอุปกรณ์มีช่องใส่ซิมการ์ด ให้เสียบซิมการ์ดที่เปิดใช้งานแล้วลงในแต่ละช่อง หากอุปกรณ์รองรับ SMS ซิมการ์ดแต่ละอันต้องมีช่องหมายเลขเป็นของตัวเอง ป้อนข้อมูลแล้ว สำหรับอุปกรณ์ที่ใช้ Android 12 หรือ ซิมการ์ดทุกอันต้องรองรับการรองรับการโทรแบบย่อ (ADN) บัตร GSM และ USIM ที่มีไฟล์โทรคมนาคมโดยเฉพาะ (DF_Telecom) เป็นไปตามข้อกำหนดนี้

UICC ของนักพัฒนาซอฟต์แวร์

หากต้องการเรียกใช้การทดสอบ API ผู้ให้บริการ CTS อุปกรณ์ต้องใช้ซิมกับผู้ให้บริการ CTS ตรงตามข้อกำหนดที่ระบุไว้ใน การเตรียม UICC

การกำหนดค่าอุปกรณ์ Android

1. รีเซ็ตอุปกรณ์เป็นค่าเริ่มต้น: การตั้งค่า > การสำรองข้อมูลและ รีเซ็ต > ข้อมูลโรงงาน รีเซ็ต

2. ตั้งค่าภาษาของอุปกรณ์เป็นภาษาอังกฤษ (สหรัฐอเมริกา): การตั้งค่า > ภาษาและ อินพุต > ภาษา

3. หากอุปกรณ์รองรับการปรับแต่งแบบอักษรเริ่มต้น ให้ตั้งค่าเริ่มต้น ชุดแบบอักษร sans-serif เป็น Roboto (ชุดแบบอักษร sans-serif เริ่มต้น ที่ใช้ในบิลด์ AOSP)

4. เปิดการตั้งค่าตำแหน่งหากมี GPS หรือ Wi-Fi/เครือข่ายมือถือ คุณลักษณะบนอุปกรณ์: การตั้งค่า > สถานที่ > เปิด

5. เชื่อมต่อกับเครือข่าย Wi-Fi ที่รองรับ IPv6 ซึ่งถือว่า DUT เป็น ไคลเอ็นต์แบบแยก (ดูสภาพแวดล้อมทางกายภาพด้านบน) และมีการเชื่อมต่ออินเทอร์เน็ต: การตั้งค่า > Wi-Fi

6. ตรวจสอบว่าไม่มีการตั้งค่ารูปแบบการล็อกหรือรหัสผ่านบนอุปกรณ์ดังนี้ การตั้งค่า > ความปลอดภัย > ล็อกหน้าจอ > ไม่มี

7. เปิดใช้การแก้ไขข้อบกพร่อง USB ในอุปกรณ์: การตั้งค่า > ตัวเลือกของนักพัฒนาซอฟต์แวร์ > การแก้ไขข้อบกพร่อง USB

8. ตั้งเวลาเป็นรูปแบบ 12 ชั่วโมง: การตั้งค่า > วันที่ & เวลา > ใช้แบบ 24 ชั่วโมง รูปแบบ > ปิด

9. ตั้งค่าอุปกรณ์ให้เปิดหน้าจอค้างไว้: การตั้งค่า > ตัวเลือกของนักพัฒนาซอฟต์แวร์ > เปิดหน้าจอค้างไว้ > เปิด

10. ใน Android 5.x และ 4.4.x เท่านั้น ให้ตั้งค่าอุปกรณ์ให้อนุญาตการจำลองตำแหน่ง การตั้งค่า > ตัวเลือกของนักพัฒนาซอฟต์แวร์ > อนุญาตให้จำลองตำแหน่ง > เปิด

11. ใน Android 4.2 หรือสูงกว่า ให้ปิดการยืนยันแอป USB โดยไปที่การตั้งค่า > ตัวเลือกของนักพัฒนาซอฟต์แวร์ > ยืนยันแอปผ่าน USB > ปิด

12. ใน Android 13 ขึ้นไป ให้ตั้งค่าอุปกรณ์ให้อนุญาตการจำลองโมเด็ม ดังนี้ การตั้งค่า > ตัวเลือกของนักพัฒนาซอฟต์แวร์ > อนุญาต Mock Modem > เปิด

13. เปิดเบราว์เซอร์และปิดหน้าจอเริ่มต้น/ตั้งค่า

14. เชื่อมต่อเครื่องเดสก์ท็อปที่จะใช้ทดสอบอุปกรณ์ด้วย USB เคเบิล

15. ก่อนเรียกใช้ CTS ให้ตั้งค่า Roboto2 เป็นแบบอักษร Sans-serif โดยใช้ผู้ใช้ การตั้งค่าราคาที่สามารถเข้าถึงได้ (ไม่ถูกซ่อนไว้)

การติดตั้งไฟล์

ติดตั้งและกำหนดค่าแอปผู้ช่วยในอุปกรณ์

1. ตั้งค่าอุปกรณ์ตามเวอร์ชัน CTS ดังนี้

   • CTS เวอร์ชัน 2.1 R2 ถึง 4.2 R4: ตั้งค่าอุปกรณ์ (หรือโปรแกรมจำลอง) เรียกใช้การทดสอบการช่วยเหลือพิเศษด้วยสิ่งต่อไปนี้ adb install -r android-cts/repository/testcases/CtsDelegatingAccessibilityService.apk

     เปิดใช้การมอบสิทธิ์ในอุปกรณ์: การตั้งค่า > การช่วยเหลือพิเศษ > การช่วยเหลือพิเศษ > การมอบสิทธิ์บริการช่วยเหลือพิเศษ

   • CTS เวอร์ชัน 6.x หรือต่ำกว่า: ในอุปกรณ์ที่ประกาศ android.software.device_admin ตั้งค่าอุปกรณ์เพื่อเรียกใช้อุปกรณ์ การทดสอบการดูแลระบบโดยใช้: adb install -r android-cts/repository/testcases/CtsDeviceAdmin.apk`

     ในการตั้งค่า > ความปลอดภัย > เลือกโปรแกรมควบคุมอุปกรณ์ เปิดใช้ อุปกรณ์ android.deviceadmin.cts.CtsDeviceAdminReceiver* 2 เครื่อง ตรวจสอบว่า android.deviceadmin.cts.CtsDeviceAdminDeactivatedReceiver และอื่นๆ ผู้ดูแลระบบอุปกรณ์รายอื่นๆ ที่โหลดไว้ล่วงหน้าจะยังคงปิดใช้ต่อไป

2. คัดลอกไฟล์สื่อ CTS ไปยังอุปกรณ์ดังนี้

   1. นำทาง (cd) ไปยังเส้นทางที่มีการดาวน์โหลดไฟล์สื่อและ แตกไฟล์แล้ว

   2. เปลี่ยนสิทธิ์ของไฟล์โดยทำดังนี้ chmod u+x copy_media.sh

   3. คัดลอกไฟล์ที่จำเป็น

      • หากต้องการคัดลอกคลิปที่มีความละเอียดไม่เกิน 720x480 ให้เรียกใช้

        ./copy_media.sh 720x480
        

      • หากไม่แน่ใจถึงความละเอียดสูงสุด ให้คัดลอกไฟล์ทั้งหมดด้วยวิธีต่อไปนี้

        ./copy_media.sh all
        

      • หากมีอุปกรณ์หลายเครื่องภายใต้ adb ให้เพิ่มตัวเลือกอนุกรม (-s) ของอุปกรณ์ที่ต้องการไปจนถึงส่วนท้าย ตัวอย่างเช่น หากต้องการคัดลอกไปยัง 720x480 ไปยังอุปกรณ์ที่มีซีเรียล 1234567 ให้เรียกใช้:

        ./copy_media.sh 720x480 -s 1234567