Ejecución de pruebas CTS

Trade Federation es un marco de prueba continuo para ejecutar pruebas en dispositivos Android. Para ejecutar Compatibility Test Suite (CTS), primero lea la Descripción general de Trade Federation para obtener una explicación del marco de prueba de Tradefed.

Para ejecutar un plan de prueba:

  1. Configure los dispositivos bajo prueba (DUT) según la configuración del dispositivo Android .
  2. Asegúrese de haber instalado las versiones recientes de Android Debug Bridge (adb) y Android Asset Packaging Tool (AAPT) y agregó la ubicación de esas herramientas a la ruta del sistema de su máquina. Para obtener información sobre cómo instalar esas herramientas, consulte Configuración de CTS: ADB y AAPT.
  3. Descargue las compilaciones CTS publicadas en su máquina host Linux y descomprima la compilación en la ubicación del host.
  4. Conecte al menos un dispositivo. Para preparar el DUT:
    • Presione el botón de inicio para configurar el dispositivo en la pantalla de inicio.
    • No utilice el DUT para ninguna otra tarea.
    • Mantenga el DUT en una posición estacionaria para evitar activar la actividad del sensor.
    • Apunte la cámara del dispositivo a un objeto que se pueda enfocar.
    • No presione ninguna tecla en el dispositivo mientras se ejecuta el CTS. Presionar teclas o tocar la pantalla de un dispositivo bajo prueba interfiere con las pruebas en ejecución y puede provocar fallas en las pruebas.
  5. Inicie el script cts-tradefed de la consola CTS desde la carpeta donde se descomprimió el paquete CTS. En el shell de línea de comandos del host, ejecute:

    ./android-cts/tools/cts-tradefed
  6. Ejecute el plan de prueba predeterminado (contiene todos los paquetes de prueba):

    cts-tradefed > run cts
    • Si desea mejorar el tiempo de ejecución de las pruebas, puede fragmentar las pruebas en varios dispositivos. La fragmentación requiere que el host conecte al menos dos dispositivos, pero se recomiendan seis o más dispositivos para mayor eficiencia. Al fragmentar más de 1 dispositivo:

      • Para Android 9 y superior, use la opción de comando

        --shard-count number_of_shards
      • Para Android 8.1 y versiones anteriores, use la opción de comando

        --shards number_of_shards
    • Si no desea ejecutar todo el conjunto de pruebas, puede ejecutar el plan CTS de su elección desde la línea de comandos:

      run cts --plan test_plan_name

      Para encontrar el nombre del plan de prueba:

      • Para Android 7.0 y superior, para ver una lista de módulos de prueba, ingrese

        list modules
      • Para Android 6.0 y versiones anteriores, para ver una lista de planes de prueba en el repositorio, ingrese

        list plans
      • Para Android 6.0 y versiones anteriores, para ver una lista de paquetes de prueba en el repositorio, ingrese

        list packages
    • Para obtener opciones de comandos adicionales según las versiones de CTS, consulte la referencia de comandos de la consola o en "ayudar a todos" en la consola de Tradefed.

  7. Ejecute varias sesiones de reintento hasta que se completen todos los módulos de prueba y los números de error de la prueba sean los mismos en las dos últimas sesiones de reintento.

    • Para Android 9 y superior, utilice

      run retry --retry session_number --shard-count number_of_shards
    • Para Android 7.0–8.1, utilice

      run cts --retry session_number --shards number_of_shards
    • Para conocer las opciones adicionales del comando Reintentar según la versión de CTS, consulte Consola de comandos de CTS v2 .

    • Para comprender los detalles de implementación para el reintento de CTS, consulte Reintento de Trade Federation Suite .

  8. Vea el progreso de la prueba y los resultados informados en la consola.

Ejecución de CTS con Android Test Station

Android Test Station es una herramienta de automatización de pruebas que los desarrolladores e ingenieros de pruebas de Android pueden usar para emplear una interfaz de usuario para ejecutar conjuntos de pruebas estándar. Funciona con Android Compatibility Test Suite (CTS) .

La herramienta está disponible públicamente a través de la Guía del usuario de ATS , y su código es de fuente abierta en AOSP ( multitest_transport , tradefed_cluster ).

Ejecución de CTS para modos alternativos

La versión CTS 10 R4 agrega un plan de prueba para dispositivos con modos alternativos o para dispositivos con más de una pantalla. Para el plan de prueba de modo alternativo, ejecute el plan de prueba con el comando 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] .