ตั้งค่า CTS

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

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

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

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

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

หาก DUT รองรับแถบความถี่กว้างยิ่งยวด (UWB) อุปกรณ์อื่นที่รองรับ UWB จะต้องอยู่ในตำแหน่งที่ใกล้พอและปรับทิศทางเพื่อไม่ให้มีเสาอากาศและจุดอับสัญญาณวิทยุ การทดสอบความแม่นยำของระยะทางจำเป็นต้องมีการวางตำแหน่งและการวางแนวที่เฉพาะเจาะจง โปรดดูรายละเอียดการตั้งค่าที่หัวข้อข้อกำหนดของ UWB คุณต้องเรียกใช้การทดสอบ UWB ด้วยตนเอง โดยระบุในบรรทัดคำสั่งว่าอุปกรณ์ 2 เครื่องอยู่ห่างกัน 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 Repeater ของสัญญาณกลางแจ้ง หรือจะวาง DUT ไว้ใกล้กับหน้าต่างพอที่จะรับสัญญาณ GPS/GNSS ได้โดยตรงก็ได้

Wi-Fi และ IPv6

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

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

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

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

RTT ของ Wi-Fi

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

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

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

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

FFMPEG

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

ข้อกำหนดของเครื่องโฮสต์

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

ADB และ AAPT2

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

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

ตรวจสอบว่า 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 ที่เกี่ยวข้องกับ Mainline บางไฟล์แบบไดนามิก ซึ่งจะเพิ่มเวลาในการเรียกใช้อย่างน้อย 10 นาที ทั้งนี้ขึ้นอยู่กับความเร็วของเครือข่าย

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

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

    adb shell getprop ro.build.version.sdk
    
  2. ทำตามวิธีการในสคริปต์ download_mcts.sh เพื่อดาวน์โหลดไฟล์ CTS หลัก

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

การตรวจหาอุปกรณ์

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

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

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

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

บิลด์ของผู้ใช้

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

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

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

ผู้ผลิตอุปกรณ์อาจกำหนดพร็อพเพอร์ตี้เวลาสร้าง ro.product.first_api_level เพื่อทำให้ CTS มีข้อมูลนี้ ค่าของพร็อพเพอร์ตี้นี้คือ 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 Management API (เช่น การอัปเดตเป็นเวอร์ชันใหม่หรือการรายงาน APEX ที่ใช้งานอยู่) คุณต้องติดตั้งแพ็กเกจ CtsShimApex ล่วงหน้าในพาร์ติชัน /system

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

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

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

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

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

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

ตั้งแต่ Android 11 เป็นต้นไป CtsShimApex จะมีแอปที่สร้างไว้ล่วงหน้า 2 แอป (สร้างจากแหล่งที่มาของบิลด์) ซึ่งไม่มีโค้ดใดๆ เลย ยกเว้นไฟล์ 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 15 android15-arm-release android15-x86-release android15-arm-CtsShim.apk

android15-arm-CtsShimPriv.apk

android15-x86-CtsShim.apk

android15-x86-CtsShimPriv.apk

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 android10-release 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 สำหรับอุปกรณ์ที่รายงานองค์ประกอบที่ปลอดภัยมากกว่า 1 รายการ CTS จะเพิ่มกรณีทดสอบเพื่อตรวจสอบลักษณะการทำงานของ Open Mobile API กรณีทดสอบเหล่านี้ต้องมีการติดตั้งแอปเพล็ตตัวอย่างครั้งเดียวลงในองค์ประกอบที่ปลอดภัยแบบฝัง (eSE) ของ DUT หรือลงในซิมการ์ดที่ DUT ใช้ คุณสามารถดูแอปเพล็ตตัวอย่าง eSE และแอปเพล็ตตัวอย่าง SIM ใน AOSP

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

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

การทดสอบความเครียดของสื่อ CTS กำหนดให้คลิปวิดีโอต้องอยู่ในพื้นที่เก็บข้อมูลภายนอก (/sdcard) คลิปส่วนใหญ่มาจาก Big Buck Bunny ซึ่งเป็นลิขสิทธิ์ของ Blender Foundation ภายใต้สัญญาอนุญาต Creative Commons Attribution 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 ที่มีไฟล์เฉพาะสำหรับโทรคมนาคม (DFTelecom) เป็นไปตามข้อกำหนดนี้

UICC ของนักพัฒนาแอป

หากต้องการเรียกใช้การทดสอบ CTS Carrier API อุปกรณ์ต้องใช้ SIM ที่มีสิทธิ์ของผู้ให้บริการ 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