ตั้งค่า CTS

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

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

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

หากอุปกรณ์ที่อยู่ภายใต้การทดสอบ (DUT) รองรับ Bluetooth 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 หรือ คุณสามารถวาง 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

DUT ต้องใช้แฟล็ก UP, BROADCAST และ MULTICAST ในอินเทอร์เฟซ Wi-Fi จึงจะผ่าน CTS อินเทอร์เฟซ 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 มี Wi-Fi RTT API สำหรับความสามารถ Wi-Fi ไป-กลับ (RTT) ซึ่งช่วยให้อุปกรณ์วัดระยะทางไปยังจุดเข้าใช้งานด้วยความแม่นยำ 1 ถึง 2 เมตร ซึ่งจะทำให้ความแม่นยำของตำแหน่งในอาคารเพิ่มขึ้นอย่างมาก อุปกรณ์ที่แนะนำ 2 ตัวที่รองรับ RTT สำหรับ Wi-Fi คือ Google Wifi และ จุดเข้าใช้งาน fitlet2 ของ Compulab (ตั้งค่าแบนด์วิดท์ 40 MHz ที่ 5 GHz)

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

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

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

FFMPEG

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

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

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

ADB และ AAPT2

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

การทดสอบความเครียดของสื่อของ 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 หรือใช้การ์ดที่มีความเร็วอย่างน้อย Class 10 ขึ้นไปเพื่อให้แน่ใจว่าจะผ่าน CTS

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

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