Ejecutar pruebas automatizadas (Android 11 o versiones posteriores)

Existen dos opciones para ejecutar pruebas automatizadas de CTS:

• Trade Federation es un framework de pruebas y apps que te permite ejecutar pruebas desde la línea de comandos. En esencia, el framework te permite anotar pruebas con la anotación @Test, y la app encuentra y ejecuta esas pruebas.

• OmniLab Android Test Station es una app que te permite ejecutar pruebas en una GUI.

En esta página, se explica cómo ejecutar pruebas automatizadas con Trade Federation. Si quieres obtener instrucciones para ejecutar pruebas con el sistema de pruebas de Android de OmniLab, consulta OmniLab Android Test Station.

Ejecuta todas las pruebas automatizadas de CTS

Trade Federation contiene la consola de CTS, una interfaz de línea de comandos para ejecutar pruebas. Para ejecutar todo el paquete de pruebas automatizado del CTS, haz lo siguiente:

1. Asegúrate de haber seguido las instrucciones en Configura pruebas automatizadas de CTS.

2. En la estación de trabajo de prueba, inicia la consola de CTS ejecutando la secuencia de comandos cts-tradefed desde la carpeta en la que se extrajo el paquete de CTS:

   ./android-cts/tools/cts-tradefed
   

   La consola de CTS muestra un cursor para que escribas los comandos de CTS (cts-tradefed >).

3. El plan de pruebas de cts contiene todas las pruebas de CTS automatizadas. Ejecuta el siguiente comando para ejecutar el plan de prueba de cts:

   run cts
   

   Se ejecutan las pruebas automatizadas de CTS. Ten en cuenta lo siguiente:

   • Android 13 y versiones posteriores admiten pruebas multidispositivo. Estas pruebas se ejecutan automáticamente solo cuando se usa el particionamiento. Para obtener más información sobre el particionamiento, consulta Cómo mejorar el tiempo de ejecución de pruebas. Si quieres ejecutar estas pruebas manualmente, consulta Cómo ejecutar pruebas multidispositivo.

   • Cada vez que ejecutes CTS, presiona Ctrl + C para detener la consola de CTS existente y, luego, vuelve a ejecutarla.

   • No puedes ejecutar varias versiones de CTS en un solo host porque cada una se abre con un servidor de código de ubicación abierta (OLC) existente.

4. Consulta los resultados de la prueba. Para obtener más información, consulta Cómo interpretar los resultados de CTS.

5. Si esta es tu primera ejecución de prueba, es posible que algunas no se ejecuten correctamente debido a problemas fuera de tu control. Por ejemplo, una conexión de red puede ser lenta o una señal de GPS puede ser débil. Vuelve a ejecutar (reintenta) las pruebas hasta que se completen todos los módulos de prueba y los números de fallas de la prueba sean los mismos entre las últimas dos sesiones de reintento:

   run retry --retry session_number`
   

6. Una vez que las fallas de las pruebas sean coherentes en los reintentos, enfócate en depurar las pruebas restantes que fallaron. Si deseas obtener información para solucionar problemas relacionados con los resultados de las pruebas, consulta Fallas de la prueba de clasificación y Soluciona problemas de las pruebas de CTS.

Ejecuta CTS para dispositivos multipantalla

Si tu dispositivo ejecuta Android 11 o 12 y tiene varias pantallas, debes ejecutar el plan de prueba de cts-foldable por separado:

run cts-foldable

Los casos de prueba aprobados o fallidos para el modo de pantalla alternativo se adjuntan con el valor de display_mode, por ejemplo, testcase1[display_mode=0].

Ejecuta pruebas multidispositivo (Android 15 o versiones anteriores)

Ejecuta el siguiente comando para ejecutar el plan de prueba de cts-multidevice:

run cts-multidevice

Ejecuta planes de prueba individuales

En lugar de ejecutar todos los planes de prueba a la vez, puedes ejecutar planes de prueba individuales. Esta opción es útil para ahorrar tiempo y enfocarse en un conjunto específico de pruebas. Para ejecutar un plan de pruebas individual, sigue estos pasos:

1. Ejecuta el comando list modules para identificar el nombre del plan de prueba que deseas ejecutar.

2. Ejecuta el plan de pruebas:

   run cts --plan test_module_or_plan_name
   

Mejora el tiempo de ejecución de las pruebas

Si deseas mejorar el tiempo de ejecución de las pruebas, puedes dividirlas en varios dispositivos. El fragmentación requiere que el host conecte al menos dos dispositivos, pero se recomiendan seis o más dispositivos para mejorar la eficiencia.

Para dividir pruebas en Android 11 o versiones posteriores, ejecuta lo siguiente:

run cts --shard-count number_of_shards

Además, antes de ejecutar las pruebas de validación, puedes mejorar el tiempo de ejecución de las pruebas con el comando run cts-dev de CTS. Este comando omite las condiciones previas, la recopilación de información del dispositivo y todos los verificadores de estado del sistema. También ejecuta las pruebas en una sola ABI.