Cómo configurar las pruebas automatizadas de CTS

Antes de ejecutar las pruebas automatizadas del CTS, prepara tu entorno físico, configura tu estación de trabajo y el dispositivo que probarás.

Configura el entorno físico

Algunas pruebas de CTS requieren el uso de dispositivos externos que deben configurarse cerca del DUT. Para configurar tu entorno físico, haz lo siguiente:

  1. (Opcional) Si tu DUT admite Bluetooth LE, coloca al menos tres balizas Bluetooth LE a menos de 5 metros del DUT para realizar pruebas de detección de Bluetooth LE. Además:

    • Las balizas no necesitan configurarse ni emitir nada específico.
    • Las balizas pueden ser de cualquier tipo, incluidas iBeacon, Eddystone o incluso dispositivos que simulen balizas BLE.

  2. Coloca el teléfono frente a una escena, como una pared o el techo, a una distancia equivalente a la distancia de enfoque mínima del DUT. Además:

    • La escena debe tener iluminación suficiente para permitir que los sensores en prueba alcancen y mantengan los fotogramas por segundo (FPS) objetivo máximos configurados, como se especifica en CONTROL_AE_TARGET_FPS_RANGE.
    • Esta configuración se aplica a todos los sensores de la cámara que informa getCameraIdList a medida que la prueba itera sobre los dispositivos enumerados y mide el rendimiento de forma individual.
    • Si el DUT admite cámaras externas, como cámaras web USB, conecta una cámara externa cuando ejecutes el CTS. De lo contrario, las pruebas de CTS fallarán.

  3. (Opcional) Si tu DUT admite un sistema de posicionamiento global (GPS) o algún otro sistema global de navegación por satélite (GNSS), proporciona una señal de GNSS al DUT con un nivel de señal adecuado para la recepción y el cálculo de la ubicación. Además:

    • El GPS debe cumplir con el documento ICD-GPS-200C.
    • El indicador GNSS puede ser de cualquier tipo, incluido un simulador de satélite o un repetidor de indicadores exteriores.
    • Puedes colocar el DUT cerca de una ventana para que pueda recibir directamente suficiente señal de GNSS de un satélite.

  4. Asegúrate de que tu red Wi-Fi admita IPv4 e IPv6, tenga una conexión a Internet con DNS para IPv4 e IPv6, admita la multidifusión IP y pueda tratar el DUT como un cliente aislado.

    Si no tienes acceso a una red IPv6 nativa, una red de operador de IPv6 o una VPN para aprobar las pruebas de IPv6, usa un AP Wi-Fi y un túnel IPv6.

  5. Asegúrate de que el DUT tenga las marcas UP, BROADCAST y MULTICAST configuradas en la interfaz de Wi-Fi.

  6. Asegúrate de que la interfaz Wi-Fi tenga asignadas direcciones IPv4 e IPv6. Para verificar las propiedades de la interfaz Wi-Fi, ejecuta adb shell ifconfig.

  7. (Opcional) Si tu DUT admite la simultaneidad de STA o STA de Wi-Fi, configura al menos dos redes Wi-Fi. Estas redes Wi-Fi deben ejecutarse en bandas diferentes con SSID diferentes o en el mismo SSID con BSSID diferentes.

  8. (Opcional) Si tu DUT admite el tiempo de ida y vuelta (RTT) de Wi-Fi, configura un dispositivo que admita el RTT de Wi-Fi:

    1. Coloca el dispositivo de RTT de Wi-Fi a menos de 12 metros del DUT.
    2. Enciende el dispositivo Wi-Fi RTT.

    Estos son dos dispositivos recomendados que admiten el RTT de Wi-Fi: - Google Wifi - Punto de acceso fitlet2 de Compulab (configurado en un ancho de banda de 40 MHz a 5 GHz).

Configura tu computadora de escritorio

Antes de ejecutar las pruebas automatizadas del CTS, asegúrate de que tu computadora de escritorio cumpla con los requisitos de hardware y sistema operativo, y de que tenga instalado el software adecuado, como se describe en las siguientes secciones.

Cumple con los requisitos de hardware

Tu computadora de escritorio para CTS debe cumplir o superar estos requisitos de hardware:

  • Un sistema x86 de 64 bits

  • Al menos 256 GB de espacio libre en disco para admitir la mayor cantidad de casos de prueba del CTS y un aumento en la reserva de espacio de montón de Java en Tradefed

  • Al menos 32 GB de RAM

Cumple con los requisitos del sistema operativo

  • Tu máquina de desarrollo debe ejecutar una distribución de Linux de 64 bits con la biblioteca GNU C (glibc) 2.17 o una versión posterior.

  • El idioma del sistema operativo debe establecerse en "inglés" para permitir que CTS resuelva la ruta correctamente.

Instala el software para computadoras

Para instalar el software de escritorio adecuado para el CTS, haz lo siguiente:

  1. Instala el paquete FFmpeg versión 5.1.3 o posterior.

  2. Instala las versiones más recientes de Android Debug Bridge (adb) y Android Asset Packaging Tool (AAPT2), y agrega la ubicación de esas herramientas a la ruta del sistema de tu máquina:

    1. Sigue las instrucciones que se indican al comienzo de la documentación de SDK Manager para instalar la herramienta de línea de comandos de sdkmanager. El vínculo para descargar las herramientas de línea de comandos se encuentra en la sección Solo herramientas de línea de comandos en la parte inferior de la página de descarga de Android Studio.
    2. Actualiza la ruta del sistema para incluir la ubicación de sdkmanager recién instalado.
    3. Con sdkmanager, instala los paquetes platform-tools y build-tools más recientes. Estos paquetes contienen adb y AAPT2. Para obtener información sobre la instalación de paquetes, consulta Instala paquetes.
    4. Actualiza tu ruta de acceso para incluir la ubicación de las herramientas adb y AAPT2 recién instaladas.
    5. Verifica que adb y AAPT2 estén en tu ruta de acceso.

  3. Instala la versión correcta del Java Development Kit (JDK):

  4. (Opcional) En Android 13 y 14, instala virtualenv. La herramienta virtualenv es obligatoria para las pruebas multidispositivo.

  5. Para asegurarte de que Python esté instalado, escribe python3. Deberían aparecer la versión y la fecha de Python, lo que indica que Python está instalado correctamente.

  6. Descarga y abre los paquetes del CTS desde Descargas del Conjunto de pruebas de compatibilidad que coincidan con la versión de Android de tus dispositivos y todas las interfaces binarias de aplicaciones (ABIs) que admitan tus dispositivos.

  7. Descarga y abre la versión más reciente de los archivos multimedia del CTS. Los archivos multimedia incluyen clips de video de Big Buck Bunny, que están protegidos por derechos de autor de Blender Foundation bajo la licencia Creative Commons Attribution 3.0.

  8. (Opcional) Cuando ejecutas el CTS por primera vez, se descargan de forma dinámica algunos archivos del CTS relacionados con Mainline. Según la velocidad de tu red, esta descarga agrega 10 minutos o más al tiempo de ejecución de las CTS.

    Para evitar este tiempo de ejecución adicional del CTS, puedes descargar los archivos del CTS relacionados con Mainline antes de ejecutar el CTS. Para obtener información sobre cómo descargar los archivos del CTS relacionados con Mainline, consulta Descarga archivos del CTS relacionados con Mainline.

Prepara el DUT

Después de configurar la máquina de escritorio, debes configurar el DUT.

Configura el DUT

Para configurar el DUT, haz lo siguiente:

  1. Asegúrate de que el DUT ejecute una imagen del sistema basada en la compilación del usuario que se sabe que es compatible (Android 4.0 o versiones posteriores) de Codenames, Tags, and Build Numbers y que use la variante de compilación user. Para obtener más información sobre las variantes de compilación, consulta Cómo elegir un destino.

  2. Si el DUT ejecuta Android 13 o una versión posterior, asegúrate de que la compilación tenga ro.product.first_api_level establecido en el nivel de API con el que se lanzó comercialmente el dispositivo. Para establecer este valor, realiza el siguiente cambio en el archivo device.mk:

    PRODUCT_SHIPPING_API_LEVEL := 21

    Algunos requisitos del CTS dependen de la compilación con la que se envió originalmente un dispositivo. Por ejemplo, los dispositivos que se envían originalmente con compilaciones anteriores podrían excluirse de los requisitos del sistema que se aplican a los dispositivos que se envían con compilaciones posteriores. Para conocer los valores válidos del nivel de API, consulta Nombres internos, etiquetas y números de compilación. Para obtener más información sobre ro.product.first_api_level, consulta Nivel de API del proveedor.

    Para Android 10 o versiones anteriores, consulta Cómo configurar el CTS (AOSP 10 o versiones anteriores).

  3. Si tu dispositivo admite la administración de paquetes APEX, haz lo siguiente:

    1. Descarga el paquete de shim de APEX para tu versión de Android y arquitectura de hardware específicas. Las dos columnas de la izquierda de la tabla de paquetes de shim proporcionan vínculos al paquete para descargarlo.
    2. Copia el paquete descargado en /system/apex.
    3. Cambia el nombre del archivo por com.android.apex.cts.shim.apex.

  4. Si tu dispositivo no admite la administración de paquetes APEX, haz lo siguiente:

    1. Descarga los paquetes de shim de APEX para tu versión específica de Android y la arquitectura de hardware. Las dos columnas de la derecha de la tabla de paquetes de simulación proporcionan vínculos a los paquetes que se pueden descargar.
    2. Copia el CtsShim.apk en /system/app/.
    3. Cambia el nombre de CtsShim.apk a CtsShimPrebuilt.apk.
    4. Copia el CtsShimPriv.apk en /system/priv-app/.
    5. Cambia el nombre de CtsShimPriv.apk a CtsShimPrivPrebuilt.apk.

  5. Si tu dispositivo informa más de un elemento seguro, haz lo siguiente:

    1. Descarga google-cardlet.cap.
    2. Copia el archivo descargado en /data/uicc/cardlets/.

  6. Si tu dispositivo informa más de un elemento seguro, instala el applet de muestra en el elemento seguro incorporado (eSE) del DUT o en la tarjeta SIM que usa el DUT. Para obtener más información, consulta Prueba de CTS para el elemento seguro.

  7. Si tu dispositivo no tiene una pantalla integrada, conéctale una.

  8. Si el dispositivo tiene una ranura para tarjeta de memoria, conecta una tarjeta SD vacía. Usa una tarjeta SD que admita un bus de velocidad ultra alta (UHS) con capacidad SDHC o SDXC, o bien una tarjeta con una clase de velocidad 10 o superior para asegurarte de que pueda pasar la CTS.

  9. Si el dispositivo tiene ranuras para tarjetas SIM, conecta una tarjeta SIM activada en cada ranura. Si el dispositivo admite SMS, cada tarjeta SIM debe tener su propio campo de número completado. En el caso de los dispositivos que ejecutan Android 12 o versiones posteriores, todas las tarjetas SIM deben ser compatibles con el almacenamiento de números de marcación abreviados (ADN). Las tarjetas GSM y USIM con el archivo dedicado de telecomunicaciones (DFTelecom) cumplen con este requisito.

  10. Asegúrate de que tu dispositivo tenga una SIM con privilegios de operador de CTS que cumpla con los requisitos especificados en Cómo preparar la UICC.

Configura el DUT

Sigue estos pasos para configurar tu DUT para usarlo con el CTS.

En el DUT, haz lo siguiente:

  1. Restablece la configuración de fábrica del dispositivo.

  2. Establece el idioma del dispositivo en inglés (Estados Unidos).

  3. Si el dispositivo admite la personalización de fuentes predeterminadas, asegúrate de que la familia de fuentes sans-serif predeterminada esté establecida en Roboto.

  4. Si el dispositivo tiene una función de GPS, Wi-Fi o red móvil, habilita el parámetro de configuración de ubicación.

  5. Conéctate a una red Wi-Fi que admita IPv6, pueda tratar el DUT como un cliente aislado y tenga conexión a Internet. Para obtener una explicación sobre los clientes aislados, consulta Configura el entorno físico.

  6. Asegúrate de que no haya un patrón de bloqueo ni una contraseña establecidos.

  7. Habilita la depuración por USB:

    1. Navega a Configuración > Acerca del teléfono y presiona Número de compilación siete veces. La opción Opciones para desarrolladores aparece en la categoría de configuración Sistema.

    2. Presiona Depuración por USB.

    Para habilitar la depuración por USB en Android 10 o versiones anteriores, consulta Configura el CTS (AOSP 10 o versiones anteriores).

  8. Configura la hora en el formato de 12 horas.

  9. Habilita Opciones para desarrolladores > Mantener activa.

  10. Inhabilita la verificación de la app por USB:

    1. Navega a Opciones para desarrolladores.

    2. Presiona Verificar aplicaciones por USB.

  11. En Android 13 o versiones posteriores, habilita el módem simulado:

    1. Navega a Opciones para desarrolladores.

    2. Presiona Permitir módem de prueba.

    Este parámetro de configuración es obligatorio para pruebas de telefonía específicas.

En la computadora de escritorio, haz lo siguiente:

  1. Inicia el navegador y descarta cualquier pantalla de inicio o configuración.

  2. Conecta el DUT a la computadora de escritorio con un cable USB.

  3. Si el sistema te solicita que aceptes una clave RSA que permita la depuración a través de esta computadora, haz clic en Permitir depuración por USB.

  4. Establece Roboto2 como la fuente sans-serif con un ajuste de accesibilidad para el usuario (no oculto).

  5. Copia los archivos multimedia del CTS en el DUT:

    1. Navega (cd) a la ruta en la que se descargaron y descomprimieron los archivos multimedia.

    2. Cambia los permisos del archivo:

      chmod u+x copy_media.sh

    3. Copia los archivos:

      • Para copiar clips con una resolución de hasta 720 x 480, ejecuta el siguiente comando:

        ./copy_media.sh 720x480

      • Si no conoces la resolución máxima, copia todos los archivos:

        ./copy_media.sh all

      • Si hay varios DUT, agrega la opción de número de serie (-s) de un dispositivo específico al final. Por ejemplo, para copiar hasta 720 x 480 al dispositivo con el número de serie 1234567, ejecuta el siguiente comando:

        ./copy_media.sh 720x480 -s 1234567

Descarga archivos del CTS relacionados con Mainline

Para descargar los archivos del CTS relacionados con Mainline, haz lo siguiente:

  1. Para obtener el nivel de API de Android en el dispositivo, ejecuta el siguiente comando:

    adb shell getprop ro.build.version.sdk

  2. Sigue las instrucciones del secuencia de comandos download_mcts.sh para descargar los archivos del CTS de Mainline.

    La descarga tarda al menos 10 minutos, según la velocidad de la red.

Paquetes de shim

En la siguiente tabla, se enumeran los paquetes disponibles para cada versión y arquitectura del dispositivo:

Versión de dispositivo Paquetes (si se admite APEX) Paquetes (si no se admite APEX)
ARM x86 ARM x86
Android 16 16-arm-release android16-x86-release android16-arm-CtsShim.apk

android16-arm-CtsShimPriv.apk

 android16-x86-CtsShim.apk

android16-x86-CtsShimPriv.apk
Android 15 15-arm-release android15-x86-release android15-arm-CtsShim.apk

android15-arm-CtsShimPriv.apk

 android15-x86-CtsShim.apk

android15-x86-CtsShimPriv.apk
Android 14 android14-arm-release android14-x86-release android14-arm-CtsShim.apk

android14-arm-CtsShimPriv.apk

 android14-x86-CtsShim.apk

android14-x86-CtsShimPriv.apk
Android 13 android13-arm-release android13-x86-release android13-arm-CtsShim.apk

android13-arm-CtsShimPriv.apk

 android13-x86-CtsShim.apk

android13-x86-CtsShimPriv.apk
Android 12 android12-arm-release android12-x86-release android12-arm-CtsShim.apk

android12-arm-CtsShimPriv.apk

 android12-x86-CtsShim.apk

android12-x86-CtsShimPriv.apk
Android 11 android11-arm-release android11-x86-release android11-arm-CtsShim.apk

android11-arm-CtsShimPriv.apk

 android11-x86-CtsShim.apk

android11-x86-CtsShimPriv.apk
Android 10 android10-release android10-arm-CtsShim.apk

android10-arm-CtsShimPriv.apk

 android10-x86-CtsShim.apk

android10-x86-CtsShimPriv.apk
Android 9, O y O-MR1 N/A N/A arm-CtsShim.apk

arm-CtsShimPriv.apk

 x86-CtsShim.apk

x86-CtsShimPriv.apk

Próximos pasos

Después de leer este documento, continúa con Cómo ejecutar pruebas de CTS automatizadas.