Consola de comandos de CTS v2

Usar la consola de CTS v2

Para Android 7.0 o versiones posteriores, usa CTS v2.

Seleccionar planes

Los planes de prueba disponibles incluyen los siguientes:

  • cts: Ejecuta el CTS desde una instalación del CTS preexistente.
  • cts-camera: Ejecuta la cámara CTS desde una instalación del CTS preexistente.
  • cts-java: Ejecuta pruebas principales de Java desde una instalación de CTS preexistente.
  • cts-pdk: ejecuta pruebas útiles para validar una compilación de fusión de PDK.
  • Todo: Configuración común para los conjuntos de compatibilidad.

Entre otras opciones de configuración disponibles, se incluyen las siguientes:

  • basic-reporters: Configuración con generadores de informes de CTS básicos.
  • collect-tests-only: ejecuta el CTS desde una instalación del CTS preexistente.
  • common-compatibility-config: configuración común para paquetes de compatibilidad.
  • cts-filtered-sample: configuración común para conjuntos de compatibilidad.
  • cts-known-failures: configuración con fallas conocidas de CTS
  • cts-preconditions: Configuración de las condiciones previas del CTS.
  • host: Ejecuta una sola prueba basada en host en un dispositivo existente.
  • instrument: Ejecuta una sola prueba de instrumentación de Android en un dispositivo existente.
  • native-benchmark: Ejecuta una prueba de esfuerzo nativa en un dispositivo existente.
  • native-stress: Ejecuta una prueba de esfuerzo nativa en un dispositivo existente.
  • recarga: Es una prueba falsa que espera los dispositivos casi descargados y los retiene para cargarse.
  • testdef: Ejecuta pruebas contenidas en archivos test_def.xml en un dispositivo existente.
  • util/wifi: Configuración de la compañía eléctrica para configurar el Wi-Fi en el dispositivo.
  • util/wipe: Limpia los datos del usuario del dispositivo.

Todos estos planes y configuraciones se pueden ejecutar con el comando run cts.

Referencia de comandos de consola de CTS v2

Esta tabla resume los comandos de la consola de CTS v2 para para varios usos.

Host Descripción
help Muestra un resumen de los comandos más usados
help all Muestra la lista completa de comandos disponibles.
version Muestra la versión.
exit Sal correctamente de la consola de CTS. La consola se cierra cuando las pruebas en ejecución hayan finalizado.
extdir

El archivo de descargas comprimido se descomprime en extdir. Si quieres Para deshacerte del resultado aumentado, usa la opción -q:

unzip -q android-cts-9.0_r15-linux_x86-arm.zip -d extdir

Si deseas descomprimir el archivo en el directorio actual, no uses la opción -d. simplemente ejecuta:

unzip -q android-cts-9.0_r15-linux_x86-arm.zip

Ejecutar Descripción
run cts

En Android 10, ejecuta el plan de CTS predeterminado y CTS-Instant (es decir, la invocación completa del CTS). En el caso de Android 9 o versiones anteriores, ejecuta el modo Solo para el plan de CTS. Usa esta opción completa (incluidas las condiciones previas) para validar el dispositivo. Consulta cts.xml para ver las inclusiones.

La consola de CTS puede aceptar otros comandos mientras las pruebas están en curso.

Si no hay dispositivos conectados, la máquina de escritorio (o host) del CTS esperará. para que se conecte un dispositivo antes de comenzar las pruebas. Si hay más de uno está conectado, el host del CTS elegirá un dispositivo automáticamente.

run cts-instant

En el caso de Android 9, ejecuta el plan predeterminado CTS-Instant.

run cts --module-parameter INSTANT_APP

En Android 10, ejecuta el plan predeterminado de CTS-Instant.

run cts --module-parameter INSTANT_APP --module/-m test_module_name

En Android 10, ejecuta el módulo de prueba CTS-Instant especificado. o módulos.

run retry

Solo para Android 9 o versiones posteriores. Reintentar todas las pruebas que fallaron o que no se ejecutaron de sesiones anteriores. Por ejemplo, run retry --retry -s o run retry --retry --shard-count con fragmentación de TF.

run cts --retry no es permitidos para Android 9 o versiones posteriores.

run cts-sim

Para Android 11 o versiones posteriores Ejecuta el subconjunto de pruebas en un dispositivo con tarjeta SIM.

--device-token

Para Android 8.1 o versiones anteriores Especifica que un dispositivo determinado tiene la token. Por ejemplo, --device-token 1a2b3c4d:sim-card.

--enable-token-sharding

Solo para Android 10 o versiones posteriores. Automáticamente coincide con la prueba que requiere el tipo de SIM correspondiente. No es necesario proporcionar un número de serie de dispositivo para ejecutar. Casos de prueba relacionados con SIM SIMs compatibles: SIM_CARD, UICC_SIM_CARD, y SECURE_ELEMENT_SIM_CARD.

run cts-dev

Ejecutar el plan de CTS predeterminado (es decir, la invocación de CTS completa) omitir condiciones previas para ahorrar tiempo de ejecución para el desarrollo iterativo de un nuevo la prueba. Esta acción omite la verificación y configuración del configuración, como enviar archivos multimedia o buscar redes Wi-Fi que se hace cuando se usa la opción --skip-preconditions. Esta también omite 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. Para validar dispositivos, evita esta optimización y incluir todas las condiciones previas y verificaciones. Consulta cts-dev.xml para las exclusiones.

La consola de CTS puede aceptar otros comandos mientras las pruebas están en curso.

Si no hay dispositivos conectados, la máquina de escritorio (o host) del CTS esperará. para que se conecte un dispositivo antes de comenzar las pruebas. Si hay más de uno está conectado, el host del CTS elegirá un dispositivo automáticamente.

--subplan subplan_name Ejecutar el subplan especificado
--module/-m test_module_name --test/-t test_name  Ejecuta el módulo especificado y haz una prueba. Por ejemplo: run cts -m Gesture --test android.gesture.cts.GestureTest#testGetStrokes ejecuta el paquete, la clase o la prueba específicos.
--retry Vuelve a intentar todas las pruebas que fallaron o que no se ejecutaron en las sesiones anteriores. Usa list results para obtener el ID de sesión.
--retry-type NOT_EXECUTED Reintentar solo las pruebas que no se ejecutaron en las sesiones anteriores. Usa list results para obtener el ID de sesión.
--shards number_of_shards Para Android 8.1 o versiones anteriores. Fragmenta un CTS te encuentras con una cantidad determinada de fragmentos independientes para ejecutarse en varios dispositivos en paralelo.
--shard-count number_of_shards En Android 9. Fragmenta una ejecución de CTS en una cantidad determinada de independientes para que se ejecuten en varios dispositivos en paralelo.
--serial/-s deviceID Ejecuta el CTS en el dispositivo específico.
--include-filter "test_module_name test_name" Ejecuta con los módulos especificados o paquetes de prueba, clases y casos. Por ejemplo: run cts --include-filter "CtsCalendarcommon2TestCases android.calendarcommon2.cts.Calendarcommon2Test#testStaticLinking" incluye el módulo especificado.

No se admite esta opción de comando cuando se ejecuta el reintento.

--exclude-filter "test_module_name test_name" Excluye de la ejecución los módulos o los paquetes de prueba, las clases y los casos especificados. Por ejemplo: run cts --exclude-filter "CtsCalendarcommon2Test android.calendarcommon2.cts.Calendarcommon2Test#testStaticLinking" excluye el módulo especificado.
--log-level-display/-l log_level Ejecuta de modo que se muestre el nivel de registro mínimo especificado STDOUT. Valores válidos: [VERBOSE, DEBUG, INFO y WARN ERROR, ASSERT].
--abi abi_name Fuerza la ejecución de la prueba en la ABI 32 o 64 determinada. De forma predeterminada, el CTS ejecuta una prueba una vez por cada ABI compatible con el dispositivo.
--logcat-on-failure:
--bugreport-on-failure de
--screenshoot-on-failure
Brinda más visibilidad de las fallas y puede ayudar con el diagnóstico.
--device-token Especifica que un dispositivo tiene un token determinado, como --device-token 1a2b3c4d:sim-card.
--skip-device-info Omite la recopilación de información sobre el dispositivo.
--skip-preconditions Omite las condiciones previas para ahorrar tiempo de ejecución para el desarrollo iterativo de un nueva prueba. Esta acción omite la verificación y configuración del configuración, como enviar archivos multimedia o buscar redes Wi-Fi conexión.
Lista Descripción
list modules Enumera todos los módulos de prueba disponibles en el repositorio.
list plans o list configs Enumera todos los planes de prueba (configuraciones) disponibles en el repositorio.
list subplans Enumera todos los subplanes disponibles en el repositorio.
list invocations Enumera los comandos run que se ejecutan actualmente en los dispositivos.
list commands Enumera todos los comandos run que se encuentran actualmente en la cola a la espera de ser asignados a dispositivos.
list results Enumera los resultados de CTS almacenados actualmente en el repositorio.
list devices Enumera los dispositivos conectados actualmente y su estado.

Los dispositivos disponibles son dispositivos inactivos, en funcionamiento y disponibles para ejecutar pruebas.

Los dispositivos no disponibles son visibles a través de adb, pero no responden a adb. comandos y no se asignarán a pruebas.

Los dispositivos asignados son dispositivos que actualmente ejecutan pruebas.

Volcado Descripción
dump logs Vuelca los registros de intercambio de todas las invocaciones en ejecución.
Agregar Descripción
add subplan --name/-n subplan_name
--result-type
[passed | failed | not_executed]
[--session session_id]
Crear un subplan derivado de la sesión anterior esta opción genera que puede usarse para ejecutar un subconjunto de pruebas.

El único la opción requerida es --session. Otras son opcionales, pero cuando incluidos, debe estar seguido de un valor. El La opción --result-type se puede repetir. por ejemplo add subplan --session 0 --result-type passed --result-type failed es válido.