Estación de prueba de Android

Android Test Station es una herramienta de prueba que los desarrolladores e ingenieros de pruebas de Android pueden utilizar para emplear una interfaz de usuario para ejecutar conjuntos de pruebas estándar de Android, como Android Compatibility Test Suite (CTS) . Esta herramienta actúa como una interfaz web para Trade Federation (TF) , lo que le permite ejecutar CTS fácilmente en un conjunto de dispositivos de prueba con una configuración mínima, así como establecer un cronograma para ejecutar pruebas continuamente.

Configurar la estación de prueba de Android

Esta sección explica cómo instalar y configurar Android Test Station.

Android Test Station utiliza código fuente de estas ubicaciones:

Instalar la estación de prueba de Android

Siga los requisitos de hardware y software para los conjuntos de pruebas que ejecute.

Los requisitos para CTS se encuentran en source.android.com .

No existen requisitos de hardware adicionales para ATS, pero recomendamos utilizar los requisitos de host CTS como punto de partida.

Hay dos formas de instalar Android Test Station:

Instalar con el programa instalador

En Ubuntu 20.04+, el programa de instalación instala y configura todos los programas y recursos necesarios para ejecutar Android Test Station.

Para utilizar el programa de instalación:

  1. Ejecute el programa de instalación:

    curl https://storage.googleapis.com/android-mtt.appspot.com/prod/install.sh | bash
    
  2. Ejecute mtt version para verificar la versión instalada de la CLI de Android Test Station.

Instalar manualmente

Instalar ventana acoplable
  1. Siga las instrucciones para instalar Docker Community Edition (CE) en su máquina Linux.

  2. Siga los pasos posteriores a la instalación para administrar Docker como usuario no root .

  3. Es posible que deba reiniciar la ventana de su terminal o cerrar sesión e iniciar sesión nuevamente para que los cambios de permisos surtan efecto.

Instalar Python 3

La CLI de Android Test Station se verifica con las versiones de Python 3.7 a 3.10.

Para Ubuntu 16.04 o anterior, primero agregue el repositorio para Python 3 realizando una de las siguientes acciones:

  • Ejecute este comando:

    sudo add-apt-repository ppa:deadsnakes/ppa
    
  • Construya e instale el repositorio desde el código fuente .

Para instalar Python 3, ejecute estos comandos:

sudo apt-get update
sudo apt install python3 python3-distutils

Para instalar una versión específica de Python 3 (por ejemplo, 3.10), ejecute estos comandos:

sudo apt-get update
sudo apt install python3.10 python3.10-distutils

Obtenga la CLI de la estación de prueba de Android

Descargue el paquete de interfaz de línea de comandos (CLI) aquí.

Iniciar la estación de prueba de Android

Inicie Android Test Station con el siguiente comando:

mtt start

La primera vez que se inicia la interfaz de usuario, es posible que tarde unos minutos en aparecer. La CLI muestra una URL web para acceder a la interfaz de usuario en un navegador. De forma predeterminada, la URL web es localhost:8000 . Si es necesario, puede cambiar el puerto predeterminado al iniciar con el indicador --port .

Si hay una versión más nueva disponible, puede actualizar a la versión actual. Puede consultar las Notas de la versión para conocer las últimas versiones.

Para actualizar a la versión actual, ejecute:

mtt start --force_update

Para detener la aplicación, ejecute:

mtt stop

Para ver una lista de otros comandos, use:

mtt --help

Realizar una copia de seguridad y restaurar la base de datos

Para hacer una copia de seguridad de la base de datos ATS, detenga la aplicación y ejecute el siguiente comando, que realiza una copia de seguridad de la base de datos actual en un archivo TAR llamado mtt-backup.tar en su directorio de inicio:

docker run --rm --mount source=mtt-data,target=/data -v ~:/out ubuntu bash -c "cd /data && tar cvf /out/mtt-backup.tar ."

Para restaurar, ejecute el siguiente comando antes de iniciar la aplicación:

docker run --rm --mount source=mtt-data,target=/data -v ~:/out ubuntu bash -c "cd /data && tar xvf /out/mtt-backup.tar"

Asistente de configuración

Después de instalar y ejecutar Android Test Station por primera vez, el asistente de configuración lo guiará a través de algunos pasos para ayudarlo a personalizar la herramienta para su entorno. Cualquier cambio que realice aquí se puede reconfigurar más adelante a través de la página de Configuración.

Restaurar una copia de seguridad de la configuración

Si tiene una copia de seguridad de un archivo de configuración desde otro host de Android Test Station, puede cargar el archivo para copiar cualquier configuración modificada desde ese host haciendo clic en el botón Cargar archivo .

Restaurar copia de seguridad de configuración

Figura 1. Restauración de una copia de seguridad de la configuración.

Establecer la cuenta de servicio predeterminada

Puede configurar una cuenta de servicio que Android Test Station utilice de forma predeterminada al acceder a sus recursos (por ejemplo, Google Cloud Storage, Google Drive). Para autenticar su cuenta de servicio, haga clic en Cargar clave de cuenta de servicio y seleccione el archivo de clave JSON de su cuenta de servicio.

Establecer cuenta de servicio

Figura 2. Configuración de la cuenta de servicio.

Cuando la cuenta de servicio se autentica correctamente, la dirección de correo electrónico de la cuenta aparece en la esquina superior derecha de la página. Para cambiar la cuenta de servicio, haga clic en el nombre de la cuenta, elimine la cuenta predeterminada actual y cargue una nueva clave de cuenta de servicio.

Cambiar cuenta de servicio

Figura 3. Cambiar la cuenta de servicio.

Importar conjuntos de configuraciones

Un conjunto de configuraciones es un conjunto de configuraciones para ejecutar conjuntos de pruebas, incluidas acciones de dispositivos relacionadas y canales de compilación. Los conjuntos de configuración se alojan en un depósito específico de Google Cloud Storage (GCS). Después de autenticar el canal de compilación de GCS con su cuenta de Google, verá una lista de todos los conjuntos de configuraciones que están disponibles para usted.

Seleccione cualquier conjunto de configuración que desee agregar al host de su estación de prueba y haga clic en Importar seleccionados .

Importar conjuntos de configuración

Figura 4. Importación de un conjunto de configuración.

Incluir configuración de Wi-Fi

Algunas pruebas CTS requieren que su dispositivo se conecte a un punto de acceso Wi-Fi. Para seleccionar su red Wi-Fi, ingrese el SSID de WiFi y el PSK de WiFi opcional.

Configuración de Wi-Fi

Figura 5. Configuración del punto de acceso Wi-Fi.

Después de completar el Asistente de configuración, la página se vuelve a cargar con la nueva configuración aplicada.

Conectar un dispositivo

La depuración USB debe estar habilitada para utilizar un dispositivo para realizar pruebas. Para habilitar la depuración:

  1. Siga las instrucciones en Habilitar opciones de desarrollador y depuración .

  2. Si planea utilizar compilaciones de prueba de Android precargadas con claves ADB personalizadas, coloque los archivos .adb_key personalizados en el directorio ~/.android/ .

    Los archivos se cargan automáticamente y se pasan a ADB para habilitar automáticamente la depuración USB después de que se actualiza el dispositivo para los dispositivos que ejecutan esas compilaciones.

  3. Conecte el dispositivo a la máquina host mediante USB.

    El dispositivo aparece en la pestaña Dispositivos de Android Test Station dentro de un minuto después de actualizar la interfaz web. También puede ver el estado de los dispositivos en esta pestaña.

    Conectar un dispositivo

    Figura 6. Conexión de un dispositivo.

Los diferentes estados del dispositivo son:

  • Disponible : el dispositivo está conectado y listo para ejecutar una prueba.
  • Asignado : el dispositivo está conectado y actualmente ejecuta una prueba. Cada dispositivo solo puede ejecutar una prueba a la vez, por lo que el dispositivo debe finalizar la prueba actual antes de ejecutar una nueva.

ejecutar una prueba

Seleccione una prueba

Android Test Station viene con un conjunto de configuraciones CTS predeterminadas. Para ejecutar una de estas pruebas, vaya a la pestaña Conjuntos de pruebas y haga clic en Ejecutar prueba para la prueba deseada.

Seleccione una prueba

Figura 7. Selección de una prueba.

Para editar o agregar nuevas pruebas, consulte Agregar pruebas .

Configurar la ejecución de prueba

Edite los parámetros que se utilizarán para esta ejecución de prueba específica. La mayoría de los parámetros se completan previamente con valores definidos en la configuración de prueba seleccionada.

Este paso se puede completar utilizando los valores predeterminados, pero puede cambiar cualquiera de los parámetros, como Max Retry y Command , para adaptarlo a sus necesidades.

Configurar la ejecución de prueba

Figura 8. Configuración de una ejecución de prueba.

Los parámetros de ejecución de la prueba son:

  • Nombre : nombre del conjunto de pruebas que desea ejecutar.
  • Recuento de ejecuciones : número de veces que se debe ejecutar esta ejecución de prueba cuando está programada. Las ejecuciones de prueba se programan mediante Trade Federation , que ejecuta hasta 20 ejecuciones de prueba en paralelo si hay capacidad para hacerlo.
  • Reintento máximo : número máximo de veces para reintentar una ejecución de prueba si falla al menos una prueba. Por lo general, esto se establece en 4 a 6 reintentos para una ejecución completa de CTS para manejar pruebas inestables.
  • Tiempo de espera de cola : si una ejecución de prueba permanece en el estado En cola durante demasiado tiempo, se cancela automáticamente. Especifique aquí el tiempo de espera antes de la cancelación. El valor predeterminado es 24 horas.
  • Comando : el comando para ejecutar el conjunto de pruebas. Puede ingresar argumentos de línea de comando adicionales aquí. Por ejemplo, ejecute un módulo específico en CTS 8.1 con:

    cts-suite -m ShortModuleName
    
  • Comando de reintento : el comando para reintentar un conjunto de pruebas. Puede agregar argumentos de línea de comando adicionales aquí. Por ejemplo, para volver a intentar solo un módulo específico en CTS 8.1, use:

    cts --retry 0 -m ShortModuleName
    

    Los argumentos de reintento pueden diferir de los disponibles con el comando inicial, así que verifique los parámetros admitidos en el sitio oficial del conjunto de pruebas seleccionado.

  • Ejecución de prueba anterior : si desea volver a ejecutar una ejecución de prueba anterior:

    • Local: si la ejecución se inició en el host actual, ingrese el ID de la ejecución de prueba que se ve al ver los detalles de la ejecución de prueba.

      Ejecución de prueba anterior local

      Figura 9. Ejecución de prueba previa local.

    • Remoto: si la ejecución se inició en un host diferente, cargue el archivo de resultados de la prueba seleccionando Remoto , haciendo clic en Cargar archivo de resultados de la prueba y seleccionando un archivo de su almacenamiento local.

      Ejecución de prueba anterior remota

      Figura 10. Ejecución de prueba previa remota.

Seleccionar dispositivos

Haga clic en las casillas de verificación para seleccionar los dispositivos que se asignarán para ejecutar el conjunto de pruebas. El recuento de fragmentos debería cambiar automáticamente para coincidir con la cantidad de dispositivos seleccionados.

Seleccionar dispositivos

Figura 11. Selección de dispositivos.

Para seleccionar dispositivos por atributos distintos del número de serie del dispositivo, puede ingresar manualmente "Especificaciones del dispositivo". Por ejemplo, para seleccionar 3 dispositivos cuyo nombre de producto sea "bramble", ingrese lo siguiente:

product:bramble;product:bramble;product:bramble

Los atributos admitidos son:

  • id_compilación
  • serie_dispositivo
  • tipo de dispositivo
  • nombre de host
  • producto
  • variante_producto
  • estado_sim

Todos los dispositivos seleccionados deben estar en el estado Disponible para ejecutar la ejecución de prueba y todos cambian al estado Asignado cuando se ejecuta la ejecución de prueba. Una ejecución de prueba está en estado En cola mientras espera que los dispositivos estén disponibles.

Agregar acciones de dispositivo

Las acciones del dispositivo son scripts que se pueden ejecutar antes de cada ejecución de prueba. Algunas acciones del dispositivo ya vienen configuradas, como flashear y reiniciar. Para crear nuevas acciones de dispositivo, consulte Crear una nueva acción de dispositivo .

Acciones del dispositivo

Figura 12. Acciones del dispositivo.

Para agregar una acción de dispositivo a una ejecución de prueba, haga clic en Agregar nueva acción , seleccione las casillas de verificación de las acciones que desea agregar y haga clic en Agregar acciones . Las acciones del dispositivo se realizan de forma secuencial. Puedes reordenar las acciones arrastrándolas.

Agregar acciones

Figura 13. Acciones de reordenación.

Establecer recursos de prueba

Los recursos de prueba son archivos necesarios para ejecutar una ejecución de prueba. Por ejemplo, ejecutar CTS requiere un archivo android-cts*.zip y actualizar un dispositivo requiere que proporciones la imagen de compilación.

La URL de descarga del archivo zip del conjunto de pruebas debe ser de forma predeterminada los enlaces de Google Drive proporcionados a los socios. Puede seleccionar un archivo diferente haciendo clic en Examinar . En la ventana emergente, puede ingresar un enlace de descarga de archivos, usar un archivo de un canal de compilación autenticado o cargar un archivo para usarlo desde el almacenamiento local.

Recursos de prueba

Figura 14. Recursos de prueba.

A continuación se muestra la ventana emergente para seleccionar un recurso de prueba mediante una URL web. Simplemente puede ingresar el enlace de la URL de descarga y hacer clic en el botón Seleccionar para confirmar la selección.

Selector de recursos de prueba: URL web

Figura 15. Selector de recursos de prueba: URL web.

Si ha subido recursos a Google Grive, Google Cloud Storage (GCS) u otros canales, también puede navegar a la pestaña del canal específico y seleccionar recursos allí. A continuación se muestra un ejemplo para seleccionar un recurso de Google Drive.

Selector de recursos de prueba: Google Drive

Figura 16. Selector de recursos de prueba: Google Drive.

Además de simplemente seleccionar archivos, también se admiten caracteres comodín en el campo Nombre de archivo . La documentación se puede encontrar aquí .

Selector de recursos de prueba: compatibilidad con patrones comodín

Figura 17. Selector de recursos de prueba: compatibilidad con patrones comodín.

También puede seleccionar un archivo del almacenamiento de archivos local de Android Test Station. Puede cargar archivos en este almacenamiento o utilizar directamente archivos y directorios locales .

Selector de recursos de prueba: almacén de archivos local

Figura 18. Selector de recursos de prueba: almacén de archivos local.

Agregar configuraciones de repetición

Puede programar reejecuciones que comiencen después de que se complete la ejecución principal y cargar sus resultados, pero puede usar diferentes dispositivos, acciones o recursos.

Agregar configuraciones de repetición

Figura 19. Agregar configuraciones de repetición.

Iniciar una ejecución de prueba

Después de ingresar la información necesaria para la ejecución de prueba, haga clic en Iniciar ejecución de prueba . Si toda la información es válida, se inicia la ejecución de prueba y se le redirige a una página para ver los detalles y el progreso de la ejecución de prueba.

Iniciar ejecución de prueba

Figura 20. Inicio de una ejecución de prueba.

Crear un plan de prueba

Los planes de prueba se utilizan para crear ejecuciones de prueba según un cronograma periódico. Por ejemplo, ejecutar CTS 9.0 todos los días a las 5 p.m. Para crear un nuevo plan de prueba, haga clic en Crear un nuevo plan de prueba .

Crear plan de prueba

Figura 21. Creación de un plan de prueba.

Configurar plan de prueba

Ingrese el nombre del plan de prueba y las etiquetas que desee agregar. Luego seleccione un horario para usar.

  • Manual : el plan de prueba crea ejecuciones de prueba solo cuando un usuario hace clic en Ejecutar plan de prueba en la página de lista de planes de prueba.
  • Periódico : el plan de pruebas programa automáticamente ejecuciones de pruebas según el programa periódico seleccionado. Por ejemplo, programar una ejecución de prueba todos los días a las 5:00 p.m.
  • Personalizado : el plan de prueba programa automáticamente ejecuciones de prueba según la expresión cron ingresada. Por ejemplo, para programar una ejecución de prueba todos los días a las 5:00 p. m., la expresión cron es 0 17 * * * .

Configurar el plan de prueba

Figura 22. Configuración de un plan de prueba.

Agregar conjuntos de pruebas

Agregue los conjuntos de pruebas que desea que el plan de pruebas programe haciendo clic en + Agregar configuración de ejecución de prueba . Seleccione un conjunto de pruebas en el menú desplegable Nombre y haga clic en Siguiente paso . Luego seleccione los dispositivos en los que desea ejecutar la prueba y haga clic en Agregar configuración . Puede agregar múltiples configuraciones para cada plan de prueba.

Configurar la ejecución de prueba

Figura 23. Configuración de una ejecución de prueba.

Agregar acciones de dispositivo

Agregue las acciones del dispositivo que desea que se ejecuten antes de cada ejecución de prueba. Consulte Agregar acciones de dispositivo para obtener más detalles.

Agregar acciones de dispositivo

Figura 24. Agregar acciones de dispositivo.

Establecer recursos de prueba

Agregar recursos de prueba a los planes de prueba es lo mismo que agregarlos a ejecuciones de prueba individuales. Consulte Configuración de recursos de prueba para obtener más detalles.

Establecer recursos de prueba

Figura 25. Configuración de recursos de prueba.

Ver ejecuciones de prueba

Lista de ejecución de prueba

Vea la lista de ejecuciones de prueba programadas en la página Ejecuciones de prueba. Haga clic en Ver para ver más detalles sobre una ejecución de prueba.

También puede filtrar la lista ingresando una cadena en la barra de filtro y presionando la tecla Enter . Puede utilizar varios filtros separándolos con una coma. El filtro devuelve todas las filas que contienen el texto exacto (sin coincidencia de subcadenas) en cualquier columna, excluyendo Estado y Creado .

Un filtro vacío devuelve todas las filas. Actualmente no hay forma de filtrar filas con valores vacíos.

Lista de ejecución de prueba

Figura 26. Lista de ejecución de pruebas.

Detalles de la ejecución de prueba

Puede ver los detalles de una ejecución de prueba aquí, como el estado, los registros y los resultados.

Detalles de la ejecución de prueba

Figura 27. Detalles de la ejecución de prueba.

Estado de ejecución de prueba

El progreso de una ejecución de prueba se muestra en la sección Estado. Si hay un mensaje relacionado, como el progreso de la descarga, el motivo de la cancelación o un mensaje de error, también se muestra aquí.

Estado de ejecución de prueba

Figura 28. Estado de ejecución de prueba.

Los estados de ejecución de prueba son:

  • Pendiente : se están descargando los recursos necesarios.
  • En cola : la prueba está lista para ejecutarse cuando un dispositivo esté disponible.
  • En ejecución : la prueba se está ejecutando en un dispositivo asignado.
  • Completado : la prueba se completó y reportó sus resultados.
  • Cancelada : el usuario canceló la prueba o se agotó el tiempo de espera al intentar encontrar dispositivos disponibles.
  • Error : se produjo un error que impidió que se ejecutara la prueba.

Cancelar una ejecución de prueba

Si la ejecución de prueba no se ha completado, puede cancelarla haciendo clic en Cancelar y luego haciendo clic en en el cuadro de diálogo de confirmación. Las ejecuciones de prueba también se cancelan automáticamente si permanecen en el estado En cola durante más tiempo que el campo queue_timeout_segundos . La cancelación de una ejecución de prueba mientras se encuentra en estado En ejecución puede tardar unos minutos en surtir efecto.

Cancelar ejecución de prueba

Figura 29. Cancelación de una ejecución de prueba.

Resultados de la ejecución de prueba

Una vez finalizada una ejecución de prueba, los resultados se recopilan y muestran. Puede ver detalles adicionales haciendo clic en la flecha de cada ejecución. Haga clic en Ver archivos de salida para ver los artefactos de prueba recopilados, como test_result.xml y test_result_failures.html .

Resultados de la ejecución de prueba

Figura 30. Resultados de la ejecución de prueba.

Puede ver los registros del host en vivo y de Tradefed en la pestaña Registros.

Registros de ejecución de prueba

Figura 31. Pestaña Registros.

Los resultados de los módulos individuales se encuentran en la pestaña Resultados de la prueba.

Pestaña de resultados de la prueba

Figura 32. Pestaña Resultados de la prueba.

Puede descargar los archivos utilizados como recursos de prueba haciendo clic en Abrir en la pestaña Recursos de prueba.

Pestaña Recursos de prueba

Figura 33. Pestaña Recursos de prueba.

Para ver los detalles de la ejecución de prueba, como create_time , vaya a la pestaña Configuración.

Pestaña de configuración de prueba

Figura 34. Pestaña Configuración.

Características avanzadas

Administrar archivos de configuración

Android Test Station utiliza archivos de configuración escritos en YAML para cargar opciones predefinidas, como pruebas, canales de creación y acciones del dispositivo. A continuación se muestra un archivo de configuración de ejemplo para algunas opciones.

// example_file.yaml
tests:
- id : android.cts.9_0.arm
  name: CTS 9.0 (ARM)
  test_resource_defs:
  - name: android-cts.zip
    default_download_url: https://dl.google.com/dl/android/cts/android-cts-9.0_r7-linux_x86-arm.zip
    test_resource_type: TEST_PACKAGE
  command: cts
  env_vars:
  - name: TF_PATH
    value: ${TF_WORK_DIR}/android-cts/tools:${TF_WORK_DIR}/android-cts/testcases
  - name: LD_LIBRARY_PATH
    value: ${TF_WORK_DIR}/android-cts/lib:${TF_WORK_DIR}/android-cts/lib64
  setup_scripts:
  output_file_patterns:
  - android-cts/logs/latest/.*
  - android-cts/results/latest/.*\.html
  - android-cts/results/latest/compatibility_result\..*
  - android-cts/results/latest/logo.png
  - android-cts/results/latest/test_result.xml
  result_file: test_result.xml
  java_properties:
  - name: CTS_ROOT
    value: ${TF_WORK_DIR}
  context_file_dir: android-cts/results/
  context_file_pattern: '[\d_\.]+\.zip'
  retry_command_line: retry --retry 0
  runner_sharding_args: --shard-count ${TF_SHARD_COUNT}

build_channels:
- id: google_drive
  name: Google Drive
  provider_name: Google Drive

device_actions:
- id: flash
  name: Flash
  test_resource_defs:
  - name: bootloader.img
    test_resource_type: DEVICE_IMAGE
  - name: radio.img
    test_resource_type: DEVICE_IMAGE
  - name: img.zip
    test_resource_type: DEVICE_IMAGE
  tradefed_target_preparers:
  - class_name: com.android.tradefed.targetprep.RunHostCommandTargetPreparer
    option_values:
    - name: work-dir
      values:
      - ${TF_WORK_DIR}
    - name: host-setup-command
      values:
      - adb -s $SERIAL reboot-bootloader
      - fastboot -s $SERIAL flash bootloader bootloader.img
      - fastboot -s $SERIAL flash radio radio.img
      - fastboot -s $SERIAL reboot-bootloader
      - fastboot -s $SERIAL -w update img.zip
      - adb -s $SERIAL wait-for-device
    - name: host-cmd-timeout
      values:
      - 10m

Cuando configura su instancia de Android Test Station, puede compartir su configuración con otros usuarios exportándola como un archivo. Para hacer esto, vaya a la página Configuración y haga clic en Exportar en la parte superior derecha.

Gestión de archivos de configuración

Figura 35. Gestión de archivos de configuración.

Una vez descargado su archivo de configuración, compártalo con otros usuarios. Pueden agregar el archivo de configuración a su instancia de Android Test Station haciendo clic en Importar y seleccionando el archivo de configuración.

Crear una nueva acción de dispositivo

Las acciones del dispositivo se utilizan para automatizar el proceso de configuración del dispositivo. Las acciones son secuencias de comandos ejecutadas en cada dispositivo en el que se ejecuta la prueba antes de cada ejecución de prueba, incluso antes de los reintentos. Para ver una lista de acciones del dispositivo disponibles, vaya a la página Configuración y haga clic en la pestaña Acciones del dispositivo. Varias acciones del dispositivo ya vienen configuradas, como reiniciar y flashear.

Pestaña Acciones del dispositivo

Figura 36. Pestaña Acciones del dispositivo.

Agregar una nueva acción de dispositivo

  1. Haga clic en Nueva acción de dispositivo .

    Nuevo botón de acción del dispositivo

    Figura 37. Botón de acción de nuevo dispositivo.

  2. Introduzca un nombre y una descripción.

    Nombre de la acción del dispositivo

    Figura 38. Nombre de la acción del dispositivo.

  3. Haga clic en Agregar preparador de destino .

  4. Ingrese el nombre completo de la clase del Preparador de destino de Trade Federation , por ejemplo, com.android.tradefed.targetprep.RunHostCommandTargetPreparer .

    Agregar preparador de objetivos

    Figura 39. Agregar un preparador de objetivos.

    Puede encontrar una lista de preparadores de objetivos disponibles en la referencia com.android.tradefed.targetprep .

    Lista de preparadores de objetivos

    Figura 40. Lista del preparador de objetivos.

  5. Agregue cualquier opción para usar con el preparador de destino. Para ver las opciones disponibles, consulte targetprep para conocer el código fuente de cada preparador de destino en AOSP:

    Ejemplo de opción de acción

    Figura 41. Ejemplo de opción de acción.

  6. Para agregar una opción, haga clic en Agregar opción de preparador de destino e ingrese los valores requeridos.

    Ejemplo de comando de acción

    Figura 42. Ejemplo de comando de acción.

  7. Defina los recursos de prueba que se necesitan para ejecutar la acción del dispositivo, por ejemplo, crear imágenes para flashear. Para agregar una definición de recurso, haga clic en Agregar recurso de prueba y complete los campos obligatorios. Si sabe dónde se encuentran sus archivos, puede proporcionar una URL de descarga predeterminada haciendo clic en Examinar . Si los preparadores de destino aceptan el directorio como recurso de prueba, seleccione Descomprimir . Luego especifique el directorio de destino relativo en el directorio de trabajo temporal y los nombres de archivos que se descomprimirán. Si no se proporcionan nombres de archivos, todos los archivos se descomprimen del recurso de prueba.

    Recursos de prueba de acción

    Figura 43. Recursos de prueba de acción.

  8. Haga clic en Actualizar .

    Acción Guardar cambios

    Figura 44. Acción para guardar cambios.

Gestionar pruebas

Editar una prueba

Para editar una prueba guardada, vaya a la página Pruebas y haga clic en Editar en la fila de la prueba que desea modificar. Después de cambiar la configuración de prueba, haga clic en Actualizar .

Editar una prueba

Figura 45. Edición de una prueba.

Agregar una nueva prueba

Para agregar una nueva prueba, vaya a la página Pruebas y haga clic en Crear una nueva prueba . Ingrese la información apropiada y haga clic en Crear .

Crear una prueba

Figura 46. Creación de una prueba.

Copiar una prueba

Figura 47. Copiar una prueba.

Exportar configuraciones de host

Después de configurar un host, puede exportar las configuraciones del host a un archivo. Puede cargar este archivo en otros hosts para copiar las configuraciones guardadas.

Para exportar las configuraciones de un host, vaya a la página Configuración y haga clic en Exportar en la esquina superior derecha.

Exportar configuraciones de host

Figura 48. Exportación de una configuración de host.

Para importar un archivo de configuración de host, vaya a la página Configuración y haga clic en Importar en la esquina superior derecha.

Importar configuraciones de host

Figura 49. Importación de una configuración de host.

Utilice archivos y directorios locales

A partir de la versión R11, se puede acceder automáticamente a los archivos en el directorio $HOME/.ats_storage en Android Test Station. Copie o mueva un archivo a ese directorio, luego podrá seleccionarlo en la pestaña Archivo local al programar una ejecución de prueba.

cp /path/to/file $HOME/.ats_storage

Seleccionar un archivo local

Figura 50. Selección de un archivo del directorio $HOME/.ats_storage .

Puede montar directorios adicionales en el almacén de archivos local con el indicador --mount_local_path .

mtt start --mount_local_path=/path/to/dir1 --mount_local_path=/path/to/dir2:renamed_dir2

Directorios montados adicionales

Figura 51. Directorios adicionales montados en el almacén de archivos local.

Habilitar el modo multihost

Con el modo Multi-host, los usuarios pueden usar un único host controlador ATS para administrar los dispositivos y realizar pruebas en múltiples hosts trabajadores ATS.

Arquitectura en modo multihost

Figura 52. Arquitectura en modo multihost.

  1. Para iniciar el controlador ATS, utilice el siguiente comando:

    mtt start --operation_mode=ON_PREMISE
    
  2. Se puede acceder al controlador de verificación en http://${CONTROLLER_HOSTNAME}:8000 .

  3. Para iniciar los trabajadores, use el siguiente comando:

    mtt start --control_server_url=http://CONTROLLER_HOSTNAME:8000 --operation_mode=ON_PREMISE
    

Si su red no permite que los hosts se comuniquen entre sí, debe seguir las instrucciones de configuración más avanzadas que aparecen a continuación en ATS Worker.

  1. Conecte los dos hosts mediante túneles SSH. Seleccione los puertos para los puertos del servidor principal y de archivos, por ejemplo, 9000 y 9006.

    ssh -L ATS_PORT:localhost:8000 -L FS_PORT:localhost:8006 CONTROLLER_HOSTNAME
    
  2. Configure e inicie ATS.

    DOCKER_GATEWAY_IP_ADDRESS=$(ip -4 addr show dev docker0 | grep -Eo 'inet [.0-9]+/' | grep -Eo '[.0-9]+')
    socat tcp-listen:ATS_PORT,bind="${DOCKER_GATEWAY_IP_ADDRESS}",reuseaddr,fork tcp-connect:127.0.0.1:ATS_PORT &
    socat tcp-listen:FS_PORT,bind="${DOCKER_GATEWAY_IP_ADDRESS}",reuseaddr,fork tcp-connect:127.0.0.1:FS_PORT &
    mtt start --control_server_url=http://${DOCKER_GATEWAY_IP_ADDRESS}:ATS_PORT \
                    --control_file_server_url=http://${DOCKER_GATEWAY_IP_ADDRESS}:FS_PORT \
                    --operation_mode=ON_PREMISE
    

Limpiador de archivos

El limpiador de archivos es un trabajo cron que se ejecuta cada hora para limpiar archivos según configuraciones definidas por el usuario. ATS tiene dos configuraciones predeterminadas para archivar los resultados de las pruebas y eliminar archivos temporales. Esta guía explica cómo personalizar las políticas y configuraciones para administrar sus archivos de manera efectiva.

Políticas

Una política define la operación que se realizará en archivos o directorios y los criterios para seleccionar objetivos. Las operaciones disponibles se muestran en la tabla:

Tipo de operación Parámetros
ARCHIVE remove_file : si es true , elimina el archivo después de archivarlo.
DELETE

Los criterios se basan en los atributos del archivo y la información del sistema. Los criterios disponibles se muestran en la tabla:

Tipo de criterio Descripción Parámetros
LAST_MODIFIED_TIME Filtre archivos según la fecha y hora de su última modificación. ttl : se admiten varios tipos de expresiones de tiempo, por ejemplo, 10m , 2h , 7 days , 4w . Consulte pytimeparse para conocer los formatos admitidos.
LAST_ACCESS_TIME Filtre archivos según la fecha y hora de su último acceso. Lo mismo que LAST_MODIFIED_TIME .
NAME_MATCH Filtre archivos según su nombre usando expresiones regulares. pattern : expresión regular, por ejemplo, [a-f0-9]{8}-([a-f0-9]{4}-){3}[a-f0-9]{12}\.zip para que coincida el resultado se cierra.
SYSTEM_AVAILABLE_SPACE Activa acciones basadas en el espacio disponible en el sistema. threshold : activa la acción cuando el espacio disponible cae por debajo del umbral, por ejemplo, 200 (B), 200KB , 200MB , 200GB , 2TB .

Nueva política de limpieza de archivos

Figura 53. Agregar una nueva política de limpieza de archivos.

Configuraciones

Una configuración combina una o más políticas con directorios específicos. Los archivos y directorios dentro de los directorios especificados se procesan según las políticas definidas. Las políticas se aplican en el orden en que aparecen en la configuración.

Todos los directorios de destino deben estar ubicados en el directorio /data . Si su configuración especifica el directorio de destino como logs , se interpreta como /data/logs .

Editar configuración del limpiador de archivos

Figura 54. Edite la configuración del limpiador de archivos.

Reiniciar

Al hacer clic en Restablecer configuración, la configuración del limpiador de archivos se revierte a su estado predeterminado. Esta acción borra TODOS los elementos personalizados.

Restablecer la configuración del limpiador de archivos

Figura 55. Restablecer la configuración del limpiador de archivos.

Apoyo

Informes de errores

Su contribución a Android Test Station ayuda a mejorar el desarrollo de la herramienta, ¡y queremos su opinión! Consulte las notas de la versión de ATS para obtener detalles sobre la última versión. Para informar errores u ofrecer sugerencias, presente un informe de error . Los socios deben informar errores o sugerencias a través de sus canales de socios.