Uso del verificador CTS

El Verificador de la Suite de Pruebas de Compatibilidad de Android (CTS Verifier) ​​complementa la Suite 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 las funciones que no se pueden probar en un dispositivo estacionario sin entrada 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 con la API de Android al pasar con éxito el CTS. Este es el dispositivo bajo prueba (DUT).
  • Computadora Linux con puerto compatible con USB 2.0. Todas las conexiones al dispositivo bajo prueba pasan por este puerto.
  • Segundo dispositivo Android con una implementación de emulación de tarjeta host (HCE) compatible con Bluetooth, Wi-Fi Direct y NFC.
  • Un enrutador Wi-Fi configurado con el nombre y la contraseña del punto de acceso. El enrutador debe tener la capacidad de desconectarse de Internet, pero no debe estar apagado.

Requisitos de la UICC para pruebas NFC

CTS Verifier tiene los siguientes casos de prueba de NFC:

  • Field-off (utiliza datos de transacción de 0x54)
  • Deseleccionar (utiliza datos de transacción de 0x52)
  • Comando HCI (0025000000) (usa datos de transacción de 0x02)

Las pruebas de eventos de transacciones 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 empuje la actividad correspondiente al 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, preferentemente el modo de tres botones, si está disponible.

Para configurar el entorno de prueba de CTS Verifier:

  1. En la computadora con Linux:

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

      adb shell settings put global hidden_api_policy 1
      
    • Instala Android Studio .

    • Descargue el APK de CTS Verifier para la versión de Android para 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 de nivel superior externo del dispositivo.

    adb shell appops set com.android.cts.verifier MANAGE_EXTERNAL_STORAGE 0
    
  6. Asegúrese de que el dispositivo bajo prueba tenga los datos del sistema y la hora configurados correctamente.

Ejecutar Verificador CTS

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

Ícono del verificador CTS en el lanzador

Figura 1. Ícono del Verificador CTS

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

Menú de pruebas del Verificador CTS

Figura 2. Menú de pruebas del Verificador CTS

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

Verificador de calidad de transmisión de video

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

  • Pase (✓). Toque si el dispositivo bajo prueba 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 dispositivo bajo prueba no cumple con los requisitos de prueba según las instrucciones de información.

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

Pruebe el modo de accesorio USB para 8.0 y superior

Prueba de accesorios usb CTS Verifier

Figura 4. Procedimiento de prueba del accesorio USB para 8.0 y superior

Prueba de accesorios usb CTS Verifier

Figura 5. Prueba del modo de accesorio USB para 8.0 y superior

Pruebe el modo de accesorio USB para 7.x e inferior

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

  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 dispositivo bajo prueba y, a continuación, seleccione Aceptar .
    Prueba de accesorios usb CTS Verifier

    Figura 6. Prueba de accesorios USB

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

  5. En la computadora, revise la salida 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 patrón-calibración.pdf en papel de tamaño A3 o 11” x 17”.
    2. Monte el patrón impreso en un respaldo rígido.
    3. Oriente el dispositivo de la cámara y el objetivo impreso como se muestra en el siguiente diagrama.
      Objetivo impreso de la cámara

      Figura 7. Objetivo impreso de la cámara

  2. Establezca el ancho objetivo:

    1. Mida la distancia (en centímetros) entre las líneas continuas 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. Pulse el botón de configuración y seleccione Distancia de marcador .
    4. Mida e ingrese la distancia al patrón objetivo (~100 cm).
    5. Pulse el botón Atrás para volver a la vista previa de la 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 usar 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 en el patrón objetivo dentro de unos pocos centímetros, el campo de visión informado para la resolución seleccionada es exacto.
      • Si las líneas no se alinean, el campo de visión informado es inexacto. 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 que se muestra 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 compatibles con el dispositivo bajo prueba.

Ejecute CTS Verifier para modos alternativos

A partir de las versiones CTS 10 R6 y CTS 11 R2, CTS Verifier admite las pruebas requeridas 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 desplegada y plegada. 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 adecuado y ejecutar la lista de pruebas que se muestra.

Interruptor de palanca CTS-V

Los resultados de las pruebas plegadas se registrarán en el mismo informe con las pruebas desplegadas. Para identificar cada resultado de prueba del que proviene el conjunto de prueba, 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, puede guardar los resultados como un informe y descargarlos a una computadora. Los nombres de los informes se marcan automáticamente con la hora en función de la hora del sistema DUT.

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

  2. Espere 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 con 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 con el siguiente comando:

      adb pull /sdcard/verifierReports
      
    • Para Android 6.0 y versiones anteriores, descargue todos los informes con 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 con el siguiente comando:

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

      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 .