Google se compromete a impulsar la igualdad racial para las comunidades afrodescendientes. Obtén información al respecto.

Usando CTS Verifier

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 las funciones que no se pueden probar en un dispositivo estacionario sin entrada manual, como la calidad de 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 correctamente 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 de emulación de tarjeta de 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 poder desconectarse de Internet, pero no debe estar apagado.

Configurar

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.

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 sean SDK.

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

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

  2. Conecte el DUT a la computadora Linux.

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

    adb install -r -g CtsVerifier.apk
    
  4. Para Android 10 y superior, 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 superior, 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. Asegúrese de que el dispositivo bajo prueba tenga los datos del sistema y la hora configurados correctamente.

Corriendo

Inicie la aplicación CTS Verifier tocando el icono CTS Verifier en el dispositivo bajo prueba.

Icono de CTS Verifier en el lanzador

Figura 1. Icono del verificador de CTS

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

Menú de pruebas de CTS Verifier

Figura 2. Menú de pruebas de CTS Verifier

Cada prueba contiene un conjunto de elementos comunes (Información, Pasa, No pasa) en la parte inferior de la pantalla.

Verificador de calidad de video en streaming

Figura 3. Elementos de prueba

  • Información (?). Toque para mostrar las instrucciones de la prueba. También aparece automáticamente la primera vez que se abre una prueba.
  • Aprobar (✓). Toque si el dispositivo bajo prueba cumple los requisitos de prueba según las instrucciones de información.
  • Falla (!). Toque si el dispositivo bajo prueba no cumple con los requisitos de la 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 una configuración e instrucciones de prueba adicionales, como se detalla en las siguientes secciones.

Prueba del modo de accesorio USB para 8.0 y superior

Prueba de accesorios USB CTS Verifier

Figura 4. Procedimiento de prueba de accesorios 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

Prueba del modo de accesorio USB para 7.xy versiones anteriores

La prueba de accesorios 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 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 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
    

Calibración del 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 calibración-patró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 a continuación.
      Objetivo impreso de la cámara

      Figura 7. Objetivo impreso de la cámara

  2. Establecer 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. Presione el botón de configuración y seleccione Distancia de marcador .
    4. Mida e introduzca la distancia al patrón objetivo (~ 100 cm).
    5. Presione el botón Atrás para volver 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 de destino. La rejilla 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 sobre la imagen.
    2. Determine la precisión:
      • Si las líneas se alinean con las líneas verticales en el patrón de destino 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 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 mostrado es una aproximación cercana al valor correcto. El campo de visión informado debe estar dentro de +/- 1 grado 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 dispositivo bajo prueba.

Ejecución de 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.

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>

Exportando resultados

Una vez finalizadas todas las pruebas, puede guardar los resultados como un informe y descargarlos a una computadora. Los nombres de los informes se marcan automáticamente según la hora del sistema DUT.

  1. Presiona el ícono Guardar (disco) .
    Icono de guardar del verificador de CTS

    Figura 8. Icono Guardar del Verificador de CTS

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

    Figura 9. Ruta del verificador CTS al informe guardado

  3. Conecte el DUT a la computadora Linux.

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

    • Para Android 7.xy versiones posteriores, descargue todos los informes usando:

      adb pull /sdcard/verifierReports
      
    • Para Android 6.0 y versiones anteriores, descargue todos los informes usando:

      adb pull /mnt/sdcard/ctsVerifierReports/
      
    • Para Android 10 y versiones posteriores, implementando Automotive y dispositivos que se ejecutan como un usuario secundario , descargue el informe más reciente usando:

      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 .