En esta página, se incluyen instrucciones para usar las pruebas multidispositivo del verificador de CTS (CTS-V) para Android 16 y versiones posteriores.
Configura pruebas multidispositivo del host
En esta sección, se explica cómo configurar pruebas en varios dispositivos.
- Asegúrate de que tu computadora de escritorio cumpla con los requisitos del sistema operativo para el CTS.
- Sigue los pasos 2 y 5 de Instala software para computadoras para asegurarte de que adb, AAPT2 y Python estén instalados correctamente en tu computadora.
Prepara dos dispositivos bajo prueba (DUT) coincidentes, cada uno con CTS-V configurado.
- Para obtener información sobre cómo configurar un DUT, consulta Cómo configurar el DUT.
- Para obtener instrucciones sobre cómo configurar CTS-V, consulta Configuración.
Si estás probando un módulo que no es NFC, sigue los pasos en Cómo configurar pruebas estándar con dos dispositivos.
- Para las pruebas de NFC, sigue los pasos que se indican en Cómo configurar pruebas de NFC.
Si vas a probar el módulo CDM, sigue los pasos de Configura pruebas de CDM además de la configuración estándar de dos dispositivos.
Cómo configurar pruebas estándar con dos dispositivos
Para la configuración predeterminada de dos dispositivos, haz lo siguiente:
- Coloca dos DUTs de Android coincidentes a una distancia aproximada de 20 cm.
Para garantizar un entorno limpio, coloca ambos dispositivos en una caja de protección.
(Opcional) Configura un analizador de OTA 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:
- Compra un chip NFC PN532. Te recomendamos el All-In-One PN532.
En el DUT, navega a la app de Configuración.
Habilita NFC.
Coloca el chip NFC de la siguiente manera:
En el caso de los teléfonos, coloca el lector NFC del DUT como se muestra en la figura 1:
Figura 1: Posicionamiento del chip NFC
En otros tipos de dispositivos, coloca el chip junto a la antena NFC del dispositivo.
Conecta el chip NFC PN532 a tu estación de trabajo de prueba con un cable USB.
Configura 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, tanto las depurables (userdebug o eng) como las no depurables (user), y que las pruebas se aprueben en ambos casos.
Exención
La cláusula de CDD para la implementación de la API de sincronización de permisos solo requiere que pueda transferir datos correctamente entre dispositivos a través de un canal seguro. Dado que la implementación del canal seguro no es un requisito de cumplimiento del CDD, esta prueba se puede omitir en las compilaciones no depurables (del usuario), pero solo si deseas inhabilitar la compatibilidad con la función de sincronización de permisos del CDM.
Las pruebas deben aprobarse en compilaciones depurables sin excepción.
Requisitos previos para realizar pruebas en compilaciones no depurables
Si no estás exento según las cláusulas de exención anteriores, asegúrate de cumplir con los siguientes requisitos previos.
El canal seguro usa AVF (AttestationVerificationFramework) para verificar la confiabilidad del hardware. Las certificaciones generadas por ambas partes contienen varios datos sobre sí mismas para garantizar que no se haya producido ninguna alteración no autorizada en su sistema. Durante el proceso de verificación, el AVF comprueba los siguientes estados:
- El dispositivo tiene acceso a Internet
- El dispositivo usa el arranque verificado y la compilación debe firmarse con una clave de lanzamiento, no con una clave de desarrollo.
- El dispositivo tiene el bootloader bloqueado. Para obtener instrucciones detalladas, consulta cómo bloquear el bootloader.
- Los niveles de parche del SO, el arranque clave y el proveedor de claves deben estar dentro de los 12 meses. No uses una compilación con más de un año de antigüedad
La certificación del dispositivo se basa en 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 lado del host (AOSP 16 o versiones posteriores)
El verificador del CTS 16 introduce 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 suben automáticamente al 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 en varios dispositivos, haz lo siguiente:
En tu estación de trabajo de prueba, inicia la consola de
cts-v-hostdesde el directorio en el que se descomprimió el paquete zip de CTS-V:./android-cts-verifier/android-cts-v-host/tools/cts-v-host-tradefedEn la app de CTS Verifier del DUT, haz clic en Host-side Tests. En la figura 2, se muestran las pruebas del host en la app del CTS Verifier:
Figura 2: Pruebas multidispositivo del lado del host en la app del verificador de CTS
Se muestra una lista de los módulos de prueba multidispositivo del host de prueba.
Identifica el nombre del módulo de prueba que deseas ejecutar. Por ejemplo, el módulo CompanionDeviceManager aparece como CtsCompanionDeviceManagerMultiDeviceTestCases.
En la consola de cts-v-host, ejecuta el siguiente comando:
run cts-v-host -m test_module_namePor ejemplo:
run cts-v-host -m CtsCompanionDeviceManagerMultiDeviceTestCasesUna vez que la consola de xTS termina de ejecutar las pruebas, los resultados aparecen en la app de CTS Verifier. Las pruebas marcadas en verde se aprobaron. Las pruebas marcadas en rojo fallaron. En la figura 3, se muestran ejemplos de resultados de las pruebas de CtsCompanionDeviceManager:
Figura 3: Resultados de pruebas multidispositivo del lado 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 problema de falta de respuesta para GetFirmwareVersion durante las pruebas de NFC
Si recibes el mensaje verify_firmware_version RuntimeError: No response
for GetFirmwareVersion mientras ejecutas las pruebas multidispositivo, significa que las pruebas no pueden acceder a la placa NFC PN532.
Para solucionar este problema, identifica la ruta de acceso serial que usa la placa NFC PN532 en tu host, como dev/ttyUSB1, y, luego, especifícala de forma manual 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 falla en la transacción 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 colocado en la parte superior, es posible que se haya seleccionado el DUT incorrecto. Para obtener más información, consulta Cómo configurar pruebas de NFC.
Para solucionar este problema, realiza una de las siguientes acciones:
Establece el número de serie correcto del DUT en el comando de prueba del host con la marca
-s.Desconecta del host todos los dispositivos que no sean el DUT.
Se ignora el caso de prueba test_permissions_sync del CDM
Si la prueba se ejecuta en dispositivos que no se pueden depurar, consulta si estás exento. De lo contrario, asegúrate de que ambos dispositivos cumplan con los requisitos previos.