Ejecuta pruebas de varios dispositivos del verificador de CTS

Esta página contiene instrucciones para usar las pruebas de varios dispositivos del verificador de CTS (CTS-V) para Android 16 y versiones posteriores.

Cómo configurar pruebas multidispositivo del host

En esta sección, se explica cómo configurar pruebas multidispositivo.

  1. Asegúrate de que tu computadora de escritorio cumpla con los requisitos del sistema operativo para CTS.
  2. Sigue los pasos 2 y 5 de Cómo instalar software para computadoras para asegurarte de que adb, AAPT2 y Python estén instalados correctamente en tu computadora.
  3. Prepara dos dispositivos de prueba (DUT) que coincidan, cada uno con CTS-V configurado.

    • Para obtener información sobre cómo configurar un DUT, consulta Configura el DUT.
    • Para obtener instrucciones sobre cómo configurar CTS-V, consulta Configuración.
  4. Si estás probando un módulo que no sea NFC, sigue las instrucciones para configurar pruebas estándar de dos dispositivos.

  5. Si estás probando el módulo de CDM, sigue las instrucciones para configurar pruebas de CDM, además de la configuración estándar de dos dispositivos.

Cómo configurar pruebas estándar de dos dispositivos

Para la configuración predeterminada de dos dispositivos, haz lo siguiente:

  1. Coloca dos DUT de Android coincidentes a una distancia de aproximadamente 20 cm.
  2. Para garantizar un entorno limpio, coloca ambos dispositivos en una caja protectora.

  3. (Opcional) Configura un sniffer inalámbrico para la depuración de Wi-Fi.

Cómo configurar pruebas de NFC

Las pruebas de NFC usan un DUT y un chip NFC PN532.

Para configurar pruebas de NFC, haz lo siguiente:

  1. Compra un chip NFC PN532. Te recomendamos el PN532 todo en uno.
  2. En el DUT, navega a la app de Configuración.

  3. Habilita NFC.

  4. Coloca el chip NFC de la siguiente manera:

    • En el caso de los teléfonos, coloca el lector de NFC del DUT como se muestra en la figura 1:

      Posicionamiento del chip NFC

      Figura 1: Posicionamiento del chip NFC

    • Para otros tipos de dispositivos, coloca el chip junto a la antena NFC del dispositivo.

  5. Conecta el chip NFC PN532 a la estación de trabajo de prueba con un cable USB.

Cómo configurar pruebas de CDM

El caso de prueba test_permissions_sync() tiene un comportamiento diferente según el tipo de compilación de los dispositivos en los que se ejecuta la prueba. Es fundamental que los OEM prueben ambas compilaciones (de depuración y no de depuración) y que las pruebas sean exitosas para ambas.

Exención

La cláusula del CDD para la implementación de la API de sincronización de permisos solo requiere que pueda transferir datos de forma correcta entre dispositivos a través de un canal seguro. Dado que la implementación del canal seguro no es un requisito de cumplimiento de la CDD, se puede omitir esta prueba en compilaciones no depurables (del usuario), pero solo si no quieres admitir la función de sincronización de permisos de CDM.

Las pruebas deben aprobarse en compilaciones depurables sin excepciones.

Requisitos previos para realizar pruebas en compilaciones no depurables

Si no cumples con las cláusulas de exención anteriores, asegúrate de que se cumplan los siguientes requisitos:

El canal seguro usa AVF (AttestationVerificationFramework) para verificar la confiabilidad del hardware. Las certificaciones que generan ambas partes contienen varios datos sobre sí mismos para garantizar que no haya habido ninguna alteración no autorizada en su sistema. La AVF verifica los siguientes estados durante el proceso de verificación:

  • El dispositivo tiene acceso a Internet.
  • El dispositivo usa el inicio verificado, y la compilación debe estar firmada con una clave de lanzamiento, no con una clave de desarrollador.
  • El bootloader del dispositivo está bloqueado. Para obtener instrucciones detalladas, consulta cómo bloquear el bootloader.
  • Los niveles de parches del SO, el inicio de sesión con claves y los proveedores clave deben estar dentro de los 12 meses. No uses una compilación que tenga más de un año.
  • La certificación del dispositivo está respaldada por uno de los certificados raíz aprobados por el proveedor. Especifica tus certificados raíz de confianza en la superposición de recursos vendor_required_attestation_certificates.xml.

Ejecuta pruebas multidispositivo del host (AOSP 16 o versiones posteriores)

El verificador del CTS 16 presenta la compatibilidad con pruebas multidispositivo del host. Estas pruebas se pueden ejecutar con secuencias de comandos automatizadas en el host, en lugar de la operación de prueba manual en el dispositivo. Después de que se completa cada prueba, los resultados se cargan automáticamente en el DUT y se muestran en la app de CTS Verifier.

En esta sección, se explica cómo ejecutar las pruebas multidispositivo del host.

Ejecuta pruebas en varios dispositivos

Para ejecutar una prueba multidispositivo, haz lo siguiente:

  1. En tu estación de trabajo de prueba, inicia la consola cts-v-host desde el directorio en el que se extrajo el paquete ZIP de CTS-V:

    ./android-cts-verifier/android-cts-v-host/tools/cts-v-host-tradefed
    
  2. En la app de CTS Verifier del DUT, haz clic en Pruebas del host. En la Figura 2, se muestran las pruebas del host en la app de CTS Verifier:

    Pruebas multidispositivo del host en la app del verificador de CTS

    Figura 2: Pruebas multidispositivo del host en la app del verificador de CTS

    Se muestra una lista de módulos de prueba multidispositivo del host de prueba.

  3. Identifica el nombre del módulo de prueba que deseas ejecutar. Por ejemplo, el módulo CompanionDeviceManager aparece como CtsCompanionDeviceManagerMultiDeviceTestCases.

  4. En la consola cts-v-host, ejecuta el siguiente comando: Nota: Si presionas un módulo del host en la app de CTS Verifier, no verás una lista de casos de prueba individuales. En su lugar, la IU se propaga automáticamente con los resultados del caso de prueba después de que se ejecuta el módulo en el host.

  5. En la consola de xTS, ejecuta el siguiente comando:

    run cts-v-host -m test_module_name
    

    Por ejemplo:

    run cts-v-host -m CtsCompanionDeviceManagerMultiDeviceTestCases
    

    Después de que la consola de xTS termine de ejecutar las pruebas, los resultados aparecerán en la app de CTS Verifier. Las pruebas marcadas en verde aprobaron. Las pruebas marcadas en rojo fallaron. En la Figura 3, se muestran ejemplos de resultados de las pruebas de CtsCompanionDeviceManager:

    Resultados de la prueba multidispositivo del host en la app del verificador de CTS

    Figura 3: Resultados de la prueba multidispositivo del host en la app del verificador de CTS.

Soluciona problemas de pruebas multidispositivo

En esta sección, se proporciona ayuda para solucionar posibles problemas.

Se corrigió el error de que no se recibía respuesta de GetFirmwareVersion durante las pruebas de NFC.

Si recibes el mensaje verify_firmware_version RuntimeError: No response for GetFirmwareVersion mientras ejecutas las pruebas de varios dispositivos, estas no podrán acceder a la placa NFC PN532.

Para solucionar este problema, identifica la ruta de acceso en serie que usa la placa NFC PN532 en tu host, como dev/ttyUSB1, y especifícala manualmente con el argumento --module-arg en la consola:

run cts-v-host -m CtsNfcHceMultiDeviceTestCases --module-arg CtsNfcHceMultiDeviceTestCases:pn532_serial_path:/dev/ttyUSB1

Se corrigió el mensaje de error de transacción fallida durante las pruebas de NFC

Si recibes el mensaje Transaction failed, check device logs for more information. para todos los casos de prueba de NFC, es probable que el chip NFC del DUT no pueda detectar el PN532.

Si tienes varios dispositivos conectados al host y algunos de ellos no tienen un PN532 en la parte superior, es posible que se haya seleccionado el DUT incorrecto. Para obtener más información, consulta Configura pruebas de NFC.

Para solucionar este problema, realiza una de las siguientes acciones:

  • Configura el número de serie correcto del DUT en el comando de prueba del host con la marca -s.

  • Desconecta todos los dispositivos que no sean DUT del host.

Se ignora el caso de prueba test_permissions_sync de CDM

Si la prueba se ejecuta en dispositivos que no se pueden depurar, verifica si estás exento. De lo contrario, asegúrate de que ambos dispositivos cumplan con los requisitos.