Usando el verificador CTS

El Verificador del conjunto de pruebas de compatibilidad de Android (CTS Verifier) ​​complementa el Conjunto de pruebas de compatibilidad (CTS). Mientras que CTS verifica las API y las funciones que se pueden automatizar, CTS Verifier proporciona pruebas para las API y funciones que no se pueden probar en un dispositivo estacionario sin entrada o posicionamiento manual, como la calidad del audio, la pantalla táctil, el acelerómetro y la cámara.

Requisitos

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

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

Asegúrese también de preparar los trípodes, los soportes de dispositivos y las distancias medidas previamente necesarias para las pruebas de medición de distancia (proximidad) para UWB, Wi-Fi NAN y Bluetooth RSSI. Para obtener más información, consulte Calibración de presencia .

Requisitos de la UICC para pruebas NFC

CTS Verifier tiene los siguientes casos de prueba NFC:

• Campo desactivado (utiliza datos de transacción de 0x54)
• Deseleccionar (utiliza datos de transacción de 0x52)
• Comando HCI (0025000000) (utiliza datos de transacción de 0x02)

Las pruebas de eventos de transacción requieren dos dispositivos, uno de los cuales debe tener SecureElement UICC con las siguientes reglas de acceso:

• Hash de 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 acceso a eventos NFC: 0xA000000476416E64726F696443545341

En el lado del emulador, esperamos que el evento de transacción coloque la actividad correspondiente en primer plano.

Configuración

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

1. Configuración abierta.
2. Vaya a Sistema > Gesto > Navegación del sistema .
3. Seleccione cualquier modo de navegación basado en botones, preferiblemente el modo de tres botones, si está disponible.

Nota: Cambiar el modo de navegación del sistema es una opción de flujo de trabajo en dispositivos Pixel 4 con Android 10. Puede cambiar en otros dispositivos Android o versiones del sistema operativo.

Para configurar el entorno de prueba de CTS Verifier:

1. En la computadora Linux:

   • Ejecute el siguiente comando antes de instalar CTS Verifier para permitir el acceso a interfaces que no son SDK.

     adb shell settings put global hidden_api_policy 1
     

   • Instale Android Studio .

   • Descargue el APK de CTS Verifier para la versión de Android a probar.

2. Conecte el DUT a la computadora Linux.

3. Desde una terminal en la computadora Linux, instale CtsVerifier.apk en el DUT.

   adb install -r -g CtsVerifier.apk
   

4. Para Android 10 y versiones posteriores, ejecute el siguiente comando para otorgar permiso a la aplicación para crear el informe.

   adb shell appops set com.android.cts.verifier android:read_device_identifiers allow
   

5. Para Android 11 y versiones posteriores, ejecute 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
   

6. Para Android 13 y versiones posteriores, ejecute el siguiente comando para permitir el acceso a la API de prueba para CTS Verifier.

   adb shell am compat enable ALLOW_TEST_API_ACCESS com.android.cts.verifier
   

7. Para Android 14 y versiones posteriores, ejecute el siguiente comando para otorgar permiso a la aplicación para encender la pantalla.

   adb shell appops set com.android.cts.verifier TURN_SCREEN_ON 0
   

8. Asegúrese de que el DUT tenga la fecha y hora del sistema configuradas correctamente.

Nota: Consulte CTS Verifier para aplicaciones instantáneas para obtener más información.

Ejecute el verificador CTS

Inicie la aplicación CTS Verifier tocando el ícono CTS Verifier en el DUT.

Figura 1. Icono del Verificador CTS

La aplicación muestra varios conjuntos de prueba disponibles para verificación manual.

Figura 2. Menú de pruebas de CTS Verifier

Cada prueba contiene un conjunto de elementos comunes en la parte inferior de la pantalla.

Figura 3. Pantalla de prueba con elementos de prueba comunes resaltados

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

Nota: En algunas pruebas, la aprobación/reprobación se determina automáticamente.

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

Pruebe el modo accesorio USB para 8.0 y superior

Figura 4. Procedimiento de prueba de accesorios USB para 8.0 y superiores

Figura 5. Prueba del modo accesorio USB para 8.0 y superiores

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

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

1. Conecte el DUT a la computadora Linux.

2. En la computadora, ejecute el programa cts-usb-accessory del paquete CTS Verifier:

   ./cts-usb-accessory

3. Espere a que aparezca un mensaje emergente en el DUT y luego seleccione Aceptar .
   

   Figura 6. Prueba de accesorios USB

4. Vaya a la Prueba de accesorios USB en la aplicación CTS Verifier en DUT.

5. En la computadora, revise el resultado de la consola. Salida 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

Utilice 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.

1. Configure el entorno de prueba:

   1. Imprima el archivo de destino de patrón de calibración.pdf en papel de tamaño 11” x 17” o A3.
   2. Monte el patrón impreso sobre un soporte rígido.

   3. Oriente el dispositivo de la cámara y el objetivo impreso como se muestra en el siguiente diagrama.
      

      Figura 7. Objetivo impreso por la cámara

2. Establezca el ancho del objetivo:

   1. Mida la distancia (en centímetros) entre las líneas sólidas en el patrón de destino para tener en cuenta las imprecisiones de impresión (~38 cm).
   2. Inicie la aplicación de calibración.
   3. Presione el botón de configuración y seleccione Distancia del marcador .
   4. Mida e ingrese la distancia al patrón objetivo (~100 cm).
   5. Presione el botón Atrás para regresar a la vista previa de calibración.

3. Verifique 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 cuadro de diálogo de configuración. La vista previa 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 utilizar con las otras líneas verticales para garantizar que el eje óptico sea ortogonal al objetivo.

4. Ejecute la prueba de calibración:

   1. Seleccione una resolución de imagen (usando el selector en la parte inferior izquierda), luego toque la pantalla para tomar una foto. La prueba ingresa al modo de calibración y muestra la foto con dos líneas verticales superpuestas a la imagen.
   2. Determinar la precisión:
      • Si las líneas se alinean con las líneas verticales del patrón objetivo dentro de unos 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 no es exacto. Para corregir esto, ajuste el control deslizante en la parte inferior de la pantalla hasta 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 de visión mostrado es una aproximación cercana al valor correcto. El campo de visión informado debe estar dentro de +/-2 grados del valor de calibración.
   3. Presione el botón Atrás y repita la prueba de calibración para todas las resoluciones de imagen admitidas por el DUT.

Ejecute CTS Verifier 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 para dispositivos con más de un modo de pantalla.

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

Los resultados de las pruebas plegadas se registrarán en el mismo informe que las pruebas desplegadas. Para identificar cada resultado de 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 completadas todas las pruebas, puede guardar los resultados como un informe y descargarlos a una computadora. Los nombres de los informes reciben automáticamente una marca de tiempo según la hora del sistema DUT.

Nota: Las métricas de ejecución de pruebas (tiempo de ejecución y detección de automatización) se recopilan del informe guardado y se utilizan únicamente con el fin de mejorar el conjunto de pruebas.

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

   Nota: Android 7.0 y versiones posteriores no incluyen la función de vista previa.

2. Espere a que aparezca un mensaje emergente que muestre la ruta del archivo al informe guardado (por ejemplo, /sdcard/verifierReports/ctsVerifierReport-date-time.zip ), luego registre la ruta.

3. Conecte el DUT a la computadora Linux.

4. Desde la instalación del SDK de Android en la computadora Linux, descargue informes desde el dispositivo conectado usando adb shell content read o adb pull CTSVerifierReportPath .

   • Para Android 7.x y superior, descargue todos los informes usando el siguiente comando:

     adb pull /sdcard/verifierReports
     

   • Para Android 6.0 y versiones anteriores, descargue todos los informes usando el siguiente comando:

     adb pull /mnt/sdcard/ctsVerifierReports/
     

   • Para Android 10 y versiones posteriores, implementando Automotive y dispositivos que se ejecutan como usuario secundario , descargue el informe más reciente usando el siguiente comando:

     adb shell content read --user CURRENT_USER --uri
     
     content://com.android.cts.verifier.testresultsprovider/reports/latest > report.zip
     

     Nota: Utilice adb shell am get-current-user para obtener el ID CURRENT_USER .

     Para enumerar todos los informes disponibles en el dispositivo conectado:

     adb shell content query --user CURRENT_USER --uri
     
     content://com.android.cts.verifier.testresultsprovider/reports
     

     Para descargar un informe de la lista, puede 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
     

5. Para borrar los resultados de aprobado/reprobado, seleccione los resultados en la aplicación CTS Verifier y seleccione Menú > Borrar .