El verificador del Conjunto de pruebas de compatibilidad de Android (verificador del CTS) complementa la Conjunto de pruebas de compatibilidad (CTS). Mientras que el CTS comprueba las APIs y funciones que se pueden automatizado, el verificador del CTS brinda pruebas para las APIs y funciones que no se pueden se prueba en un dispositivo fijo sin entrada ni posicionamiento manual, como audio calidad, pantalla táctil, acelerómetro y cámara.
Requisitos
Antes de ejecutar el verificador del CTS, asegúrate de tener el siguiente equipo:
- Dispositivo Android que verificó correctamente la compatibilidad con la API de Android y pasar el CTS. Este es el dispositivo que se está probando (DUT).
- Computadora Linux con puerto compatible con USB 2.0 Todas las conexiones al DUT se llevan a cabo a través de este puerto.
- Un segundo dispositivo Android con una conexión Bluetooth, Wi-Fi directa o Wi-Fi conocida y compatible Reconocimiento, UWB (si el DUT admite UWB) y emulación de tarjeta de host NFC (HCE) para implementarlos.
- Un router Wi-Fi configurado con el nombre de punto de acceso y la contraseña. El router debería poder desconectarse de Internet, pero no debería estar encendido desactivado.
Asegúrate de preparar también los trípodes, los soportes y los accesorios de medición distancias requeridas para las pruebas de medición de distancia (proximidad) de UWB Wi-Fi NAN y RSSI por Bluetooth. Para obtener más información, consulta Calibración de presencias.
Requisitos de la UICC para las pruebas de NFC
El verificador del CTS tiene los siguientes casos de prueba de NFC:
- Desplazamiento de campo (usa datos de transacción de 0x54)
- Anular selección (usa datos de transacción de 0x52)
- Comando HCI (0025000000) (usa datos de transacción de 0x02)
Las pruebas de eventos de transacción requieren dos dispositivos, uno de los cuales debe tener UICC de SecureElement con las siguientes reglas de acceso:
- Hash del APK de CtsVerifier: 61:ED:37:7E:85:D3:86:A8:DF:EE:6B:86:4B:D8:5B:0B:FA:A5:AF:81
- Identificador de aplicación autorizado (AID) para el acceso a eventos de NFC: 0xA000000476416E64726F696443545341
En el emulador, esperamos que el evento de transacción envíe el evento correspondiente actividad en primer plano.
Configuración
Cambia el modo de navegación del sistema del dispositivo de prueba al modo de tres botones, como se muestra a continuación sigue:
- Abre Configuración.
- Navega a System > Gesto > Navegación del sistema
- Selecciona cualquier modo de navegación basado en botones; se prefiere el modo de tres botones, si disponibles.
Para configurar el entorno de prueba del verificador del CTS, haz lo siguiente:
En la computadora Linux:
Ejecuta el siguiente comando antes de instalar el verificador del CTS para permitir acceso a interfaces que no pertenecen al SDK.
adb shell settings put global hidden_api_policy 1
Instala Android Studio.
Descargar el APK del verificador de CTS para la versión de Android que quieres probar.
Conecta el DUT a la computadora Linux.
Desde una terminal de la computadora Linux, instala
CtsVerifier.apken el DUT.adb install -r -g CtsVerifier.apk
En el caso de Android 10 y versiones posteriores, ejecuta lo siguiente: para otorgar permiso a la app para crear el informe.
adb shell appops set com.android.cts.verifier android:read_device_identifiers allow
En el caso de Android 11 y versiones posteriores, ejecuta lo siguiente: para permitir que los informes se guarden en un directorio autodefinido en el directorio externo de nivel superior del dispositivo.
adb shell appops set com.android.cts.verifier MANAGE_EXTERNAL_STORAGE 0
En el caso de Android 13 y versiones posteriores, ejecuta lo siguiente: para permitir el acceso de prueba a la API para el verificador del CTS.
adb shell am compat enable ALLOW_TEST_API_ACCESS com.android.cts.verifier
En el caso de Android 14 y versiones posteriores, ejecuta lo siguiente: para darle permiso a la app para que encienda la pantalla.
adb shell appops set com.android.cts.verifier TURN_SCREEN_ON 0
Asegúrate de que el DUT tenga la fecha y hora del sistema configuradas correctamente.
Ejecución del verificador del CTS
Para iniciar la aplicación del verificador del CTS, presiona el ícono del verificador del CTS en el DUT.
Figura 1: Ícono del verificador del CTS
La app muestra varios conjuntos de prueba disponibles para la verificación manual.
Figura 2: Menú de pruebas del verificador del CTS
Cada prueba contiene un conjunto de elementos comunes en la parte inferior de la pantalla.
Figura 3: Pantalla de prueba con los elementos de prueba comunes destacados
- Aprobado (✓). Presiona si el DUT cumple con los requisitos de prueba que se indican en la información instrucciones.
- Info (?). Presiona para mostrar las instrucciones de la prueba. También aparece automáticamente la primera vez que se abre una prueba.
- Error (!). Presiona si el DUT no cumple con los requisitos de prueba según la información instrucciones.
Algunas pruebas, como el modo de accesorio USB y la prueba de calibración de la cámara, requieren la configuración y las instrucciones adicionales de la prueba, tal como se detalla en las siguientes secciones.
Cómo probar el modo de accesorio USB para 8.0 y versiones posteriores
Figura 4: Procedimiento de prueba de accesorios USB para 8.0 y arriba de
Figura 5: Cómo probar el modo de accesorio USB para 8.0 y arriba de
Cómo probar el modo de accesorio USB para 7.x y versiones anteriores
La prueba de accesorio USB requiere una computadora Linux para ejecutar la máquina de escritorio USB (anfitrión).
- Conecta el DUT a la computadora Linux.
En la computadora, ejecuta el programa
cts-usb-accessorydesde el CTS Paquete del verificador:./cts-usb-accessory
Espera a que aparezca un mensaje emergente en el DUT y, luego, selecciona OK.
Figura 6: Prueba de accesorios USB
Ve a la prueba de accesorios USB en la aplicación del verificador del CTS en DUT.
En la computadora, revisa el resultado de la consola. Resultado de ejemplo:
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
Calibrar el campo visual de la cámara
Usa el procedimiento de calibración del campo visual para determinar rápidamente el dispositivo. visual con una precisión moderada.
Configura el entorno de pruebas:
- Imprimir el Objetivo de calibration-pattern.pdf en un papel de 11" x 17" o A3.
- Monta el patrón estampado en una parte posterior rígida.
Orienta el dispositivo de cámara y el objetivo impreso como se muestra a continuación diagrama.
Figura 7: Objetivo impreso de la cámara
Establece el ancho de destino:
- Mide la distancia (en centímetros) entre las líneas continuas en el objetivo para tener en cuenta las imprecisiones en la impresión (~38 cm).
- Inicia la aplicación de calibración.
- Presiona el botón de configuración y selecciona Distancia del marcador.
- Mide e ingresa la distancia al patrón del objetivo (~100 cm).
- Presiona el botón Atrás para volver a la vista previa de calibración.
Verifica que el dispositivo y el destino estén colocados como se muestra en la figura, y que se se ingresaron las distancias correctas en el diálogo de configuración. Vista previa muestra la imagen con una línea vertical superpuesta; esta línea debería se alinea con la línea central del patrón objetivo. La cuadrícula transparente puede usarse con las otras líneas verticales para garantizar que el eje óptico esté ortogonales con respecto al objetivo.
Ejecuta la prueba de calibración:
- Selecciona una resolución de imagen (con el selector que se encuentra en la parte inferior izquierda) y, luego, presiona la pantalla para tomar una foto. La prueba entra en el modo de calibración y muestra la foto con dos líneas verticales superpuestas en la imagen.
- Determina la exactitud:
- Si las líneas se alinean con las líneas verticales en el patrón objetivo en unos pocos centímetros, el campo visual informado para la resolución seleccionada sea precisa.
- Si las líneas no están alineadas, el campo visual informado es incorrecto. Para corregirlo, ajusta el control deslizante en la parte inferior de la pantalla hasta para que la superposición se alinee con el patrón de destino lo más cerca posible. Cuando la superposición y la imagen del patrón de destino están alineadas, el campo visual que se muestra es una aproximación cercana a la valor. El campo visual informado debe estar entre +/-2 grados de el valor de calibración.
- Presiona el botón Atrás y repite la prueba de calibración para todas las imágenes del DUT.
Ejecución del verificador del CTS para modos alternativos
A partir de las versiones CTS 10 R6 y CTS 11 R2, el verificador del CTS admite las pruebas necesarias para dispositivos con modos alternativos o para dispositivos con más de un modo de pantalla.
En la parte superior de la vista de lista principal del verificador del CTS, se muestra un botón para habilitar que los usuarios cambien entre el modo de pantalla desplegado y desplegado. El verificador del CTS mostrará las pruebas necesarias para el modo de visualización seleccionado. Para ejecutar la secuencia de comandos en el verificador del CTS, se debería cambiar el botón a la pantalla adecuada y ejecuta la lista de pruebas que se muestra.
Los resultados de las pruebas de plegados se registrarán en el mismo informe con las pruebas desplegadas y pruebas. Para identificar cada resultado de prueba del que proviene el conjunto de prueba, se aplica un se agrega un sufijo a cada nombre de prueba en el modo plegado.
<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>
Exportar resultados
Después de completar todas las pruebas, puedes guardar los resultados como un informe y descargarlos a una computadora. Los nombres de los informes se marcan automáticamente con la marca de tiempo en función del DUT tiempo del sistema.
Para guardar los resultados de la prueba, presiona el ícono de guardar (disco) en la parte superior de la lista. categorías de prueba.
Espera a que aparezca un mensaje emergente que muestre la ruta de acceso al informe guardado (por ejemplo,
/sdcard/verifierReports/ctsVerifierReport-date-time.zip) y, luego, registrar la ruta.Conecta el DUT a la computadora Linux.
Descarga informes desde la instalación del SDK de Android en una computadora con Linux del dispositivo conectado mediante
adb shell content readoadb pull CTSVerifierReportPath.En el caso de Android 7.x y versiones posteriores, descarga todos los informes con el siguiente comando:
adb pull /sdcard/verifierReports
En el caso de Android 6.0 y versiones anteriores, descarga todos los informes con el siguiente comando:
adb pull /mnt/sdcard/ctsVerifierReports/
Para Android 10 y versiones posteriores, implementar Automotriz y dispositivos que se ejecutan como usuario secundario, descargar el último informe con el siguiente comando:
adb shell content read --user CURRENT_USER --uri content://com.android.cts.verifier.testresultsprovider/reports/latest > report.zip
Para ver una lista de todos los informes disponibles en el dispositivo conectado, haz lo siguiente:
adb shell content query --user CURRENT_USER --uri content://com.android.cts.verifier.testresultsprovider/reports
Para descargar un informe de la lista, puedes especificar el ID de fila o nombre de archivo. Por ejemplo:
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
Para borrar los resultados aprobados o reprobados, selecciona los resultados en la app del verificador del CTS y selecciona Menú > Borrar.