ตั้งค่า 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)

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

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

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

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 ที่เกี่ยวข้องกับ Mainline (ไม่บังคับ)

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

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

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

    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 จะยืนยันการติดตั้งใช้งาน CtsShimApex

ro.apex.updatable requirements

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

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

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

  15. ก่อนเรียกใช้ CTS ให้ตั้งค่า Roboto2 เป็นแบบอักษรที่ไม่มี 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