A partir del 27 de marzo de 2025, te recomendamos que uses android-latest-release en lugar de aosp-main para compilar y contribuir a AOSP. Para obtener más información, consulta Cambios en AOSP.

Se usó la API de Cloud Translation para traducir esta página.

Ejecuta pruebas de CTS-V

El verificador del Conjunto de pruebas de compatibilidad de Android (verificador del CTS) complementa el Conjunto de pruebas de compatibilidad (CTS). Si bien el CTS verifica las APIs y las funciones que se pueden automatizar, el verificador del CTS proporciona pruebas para las APIs y las funciones que no se pueden probar en un dispositivo fijo sin entradas o posicionamiento manuales, como la calidad de audio, la pantalla táctil, el acelerómetro y la cámara.

Requisitos

Antes de ejecutar CTS Verifier, asegúrate de tener el siguiente equipo:

Dispositivo Android que verificó la compatibilidad con la API de Android al aprobar correctamente el CTS. Este es el dispositivo en prueba (DUT).
Computadora Linux con un puerto compatible con USB 2.0 Todas las conexiones al DUT pasan por este puerto.
Segundo dispositivo Android con una implementación conocida y compatible de Bluetooth, Wi-Fi Direct, Wi-Fi Aware, UWB (si el DUT admite UWB) y emulación de tarjeta de host (HCE) de NFC.
Un router Wi-Fi configurado con el nombre y la contraseña del punto de acceso El router debe poder desconectarse de Internet, pero no apagarse.

Asegúrate de preparar también los trípodes, los soportes para dispositivos y las distancias medidas previamente que se requieren para las pruebas de medición de distancia (proximidad) para UWB, Wi-Fi NAN y RSSI de 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:

Desactivado (usa datos de transacción de 0x54)
Anular la selección (usa datos de transacción de 0x52)
Comando de 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 una 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 (AID) autorizado para el acceso a eventos NFC: 0xA000000476416E64726F696443545341

En el emulador, esperamos que el evento de transacción envíe la actividad correspondiente al primer plano.

Configuración

Cambia el modo de navegación del sistema del dispositivo de prueba al modo de tres botones de la siguiente manera:

Abre Configuración.
Navega a Sistema > Gesto > Navegación del sistema.
Selecciona cualquier modo de navegación basado en botones (se recomienda el modo de tres botones, si está disponible).

Para configurar el entorno de pruebas del verificador del CTS, haz lo siguiente:

En la computadora Linux, haz lo siguiente:
- Ejecuta el siguiente comando antes de instalar el CTS Verifier para permitir el acceso a interfaces que no son del SDK.
```
adb shell settings put global hidden_api_policy 1
```
- Instala Android Studio.
- Descarga el APK del verificador de CTS para la versión de Android que deseas probar.
Conecta el DUT a la computadora Linux.
Desde una terminal en la computadora con Linux, instala CtsVerifier.apk en el DUT.
```
adb install -r -g CtsVerifier.apk
```
En Android 10 y versiones posteriores, ejecuta el siguiente comando para otorgar permiso a la app para crear el informe.
```
adb shell appops set com.android.cts.verifier android:read_device_identifiers allow
```
En Android 11 y versiones posteriores, ejecuta el siguiente comando 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 Android 13 y versiones posteriores, ejecuta el siguiente comando para permitir el acceso a la API de prueba para el verificador de CTS.
```
adb shell am compat enable ALLOW_TEST_API_ACCESS com.android.cts.verifier
```
En Android 14 y versiones posteriores, ejecuta el siguiente comando para otorgar 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.

Ejecuta el verificador de CTS

Presiona el ícono de CTS Verifier en el DUT para iniciar la aplicación.

Figura 1: Ícono del verificador de CTS

La app muestra varios conjuntos de pruebas 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.

Verificador de la calidad de transmisión de video

Figura 3: Pantalla de prueba con elementos de prueba comunes destacados

Aprobar (✓): Presiona si el DUT cumple con los requisitos de la prueba según las instrucciones de Info.
Información (?). Presiona para mostrar las instrucciones de la prueba. También aparece automáticamente la primera vez que se abre una prueba.
Falla (!). Presiona si el DUT no cumple con los requisitos de la prueba según las instrucciones de Info.

Algunas pruebas, como la del modo de accesorio USB y la de calibración de la cámara, requieren instrucciones y una configuración de prueba adicionales, como se detalla en las siguientes secciones.

Prueba el modo de accesorio USB para 8.0 y versiones posteriores

Prueba de accesorio USB del verificador de CTS

Figura 4: Procedimiento de prueba de accesorios USB para Android 8.0 y versiones posteriores

Prueba de accesorio USB del verificador de CTS

Figura 5: Cómo probar el modo de accesorio USB para Android 8.0 y versiones posteriores

Prueba el modo de accesorio USB para 7.x y versiones anteriores

La prueba de accesorio USB requiere una computadora Linux para ejecutar el programa de la máquina de escritorio USB (host).

Conecta el DUT a la computadora Linux.
En la computadora, ejecuta el programa cts-usb-accessory desde el paquete de CTS Verifier:
```
./cts-usb-accessory
```
Espera a que aparezca un mensaje emergente en el DUT y, luego, selecciona Aceptar.

Figura 6: Prueba de accesorio USB
Ve a la prueba de accesorios USB en la aplicación de CTS Verifier del 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 de visión de la cámara

Usa el procedimiento de calibración del campo de visión para determinar rápidamente el campo de visión del dispositivo con una precisión moderada.

Configura el entorno de pruebas:
1. Imprime el archivo de destino calibration-pattern.pdf en papel de tamaño 11" x 17" o A3.
2. Monta el patrón impreso sobre un soporte rígido.
3. Orienta la cámara y el objetivo impreso como se muestra en el siguiente diagrama.
  
  Figura 7: Objetivo de la cámara impreso
Establece el ancho objetivo:
1. Mide la distancia (en centímetros) entre las líneas continuas del patrón de destino para tener en cuenta las imprecisiones de impresión (aproximadamente 38 cm).
2. Inicia la aplicación de calibración.
3. Presiona el botón de configuración y selecciona Distancia entre marcadores.
4. Mide e ingresa la distancia al patrón objetivo (aproximadamente 100 cm).
5. Presiona el botón Atrás para volver a la vista previa de la calibración.
Verifica que el dispositivo y el objetivo estén colocados como se muestra en la figura y que se hayan ingresado las distancias correctas en el diálogo de configuración. En la vista previa, se muestra la imagen con una línea vertical superpuesta. Esta línea debe alinearse con la línea central del patrón objetivo. La cuadrícula transparente se puede usar con las otras líneas verticales para garantizar que el eje óptico sea ortogonal al objetivo.
Ejecuta la prueba de calibración:
1. Selecciona una resolución de imagen (con el selector de la esquina inferior izquierda) y, luego, presiona la pantalla para tomar una foto. La prueba ingresa al modo de calibración y muestra la foto con dos líneas verticales superpuestas en la imagen.
2. Cómo determinar la precisión:
  - Si las líneas se alinean con las líneas verticales del patrón objetivo en un rango de pocos centímetros, el campo de visión informado para la resolución seleccionada es preciso.
  - Si las líneas no se alinean, el campo de visión informado es impreciso. Para corregir esto, ajusta el control deslizante en la parte inferior de la pantalla hasta que la superposición se alinee con el patrón objetivo lo más posible. Cuando la superposición y la imagen del patrón objetivo están alineadas, el campo de visión que se muestra es una aproximación cercana al valor correcto. El campo visual informado debe estar dentro de +/-2 grados del valor de calibración.
3. Presiona el botón Atrás y repite la prueba de calibración para todas las resoluciones de imagen admitidas por el DUT.

Cómo ejecutar el verificador de CTS para modos alternativos

A partir de las versiones CTS 10 R6 y CTS 11 R2, CTS Verifier admite las pruebas necesarias para dispositivos con modos alternativos o con más de un modo de pantalla.

En la parte superior de la vista de lista principal de CTS Verifier, se muestra un botón que permite a los usuarios alternar entre el modo de pantalla plegada y desplegada. El verificador del CTS mostrará las pruebas necesarias para el modo de visualización seleccionado. Para ejecutar los modos alternativos en el CTS Verifier, se debe cambiar el botón al modo de visualización adecuado y ejecutar la lista de pruebas que se muestra.

Interruptor de CTS-V

Figura 8: Interruptor del verificador de CTS

Los resultados de las pruebas de dispositivos plegables se registrarán en el mismo informe que los de las pruebas de dispositivos desplegados. Para identificar cada resultado de la prueba del que proviene el conjunto de pruebas, 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

Una vez que se completen todas las pruebas, podrás guardar los resultados como un informe y descargarlos en una computadora. Los nombres de los informes se registran automáticamente con la fecha y hora según la hora del sistema del DUT.

Para guardar los resultados de la prueba, presiona el ícono de guardar (disco) en la parte superior de la lista de categorías de pruebas.

Nota: Android 7.0 y versiones posteriores no incluyen la función de vista previa.
Espera a que aparezca un mensaje emergente que muestre la ruta de acceso del archivo al informe guardado (por ejemplo, /sdcard/verifierReports/ctsVerifierReport-date-time.zip) y, luego, registra la ruta.
Conecta el DUT a la computadora Linux.
Desde la instalación del SDK de Android en la computadora con Linux, descarga informes del dispositivo conectado con adb shell content read o adb 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/
```
- En el caso de Android 10 y versiones posteriores, para implementar Automotive y dispositivos que se ejecutan como un usuario secundario, descarga el informe más reciente con el siguiente comando:
```
adb shell content read --user CURRENT_USER --uri

content://com.android.cts.verifier.testresultsprovider/reports/latest > report.zip
```
  Nota: Usa adb shell am get-current-user para obtener el ID de CURRENT_USER.
  
  Para enumerar 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 el 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 de aprobación o rechazo, selecciona los resultados en la app de CTS Verifier y, luego, Menú > Borrar.