Android Test Station es una herramienta de prueba que los desarrolladores e ingenieros de pruebas de Android pueden usar para emplear una interfaz de usuario para ejecutar conjuntos de pruebas estándar de Android, como el conjunto de pruebas de compatibilidad de Android (CTS) . Esta herramienta actúa como una interfaz web para Trade Federation (TF) , lo que le permite ejecutar fácilmente CTS en un conjunto de dispositivos de prueba con una configuración mínima, así como establecer un cronograma para ejecutar pruebas continuamente.
Configuración de la estación de prueba de Android
Esta sección explica cómo instalar y configurar Android Test Station.
Android Test Station utiliza el código fuente de estas ubicaciones:
- Código fuente de la estación de prueba de Android
- Código fuente del clúster de TradeFed
Instalación de la estación de prueba de Android
Siga todos los requisitos de hardware y software para los conjuntos de pruebas que desea ejecutar.
Los requisitos para CTS se encuentran en source.android.com .
No hay requisitos de hardware adicionales, pero recomendamos usar una máquina con 100 GB de espacio libre en el disco duro y 8 GB de memoria, que es suficiente para almacenar los archivos de salida de varias ejecuciones del conjunto de pruebas.
Hay dos formas de instalar Android Test Station:
- Ejecute el programa de instalación .
- Instálelo manualmente , lo que requiere la instalación de múltiples programas y recursos.
Instalación con el programa de instalación
En Ubuntu 18.04+, el programa de instalación instala y configura todos los programas y recursos necesarios para ejecutar Android Test Station.
Para usar el programa de instalación:
Ejecute el programa de instalación:
curl https://storage.googleapis.com/android-mtt.appspot.com/prod/install.sh | bash
Ejecute
mtt versionpara verificar la versión instalada de Android Test Station CLI.
Instalación manual
Instalación de Docker
Siga las instrucciones para instalar Docker Community Edition (CE) en su máquina Linux.
Siga los pasos posteriores a la instalación para administrar Docker como usuario no root .
Es posible que deba reiniciar la ventana de su terminal o cerrar sesión y volver a iniciar sesión para que los cambios en los permisos surtan efecto.
Instalación de Python 3.7
La CLI de Android Test Station requiere Python 3.7.
Para Ubuntu 16.04 o anterior, primero debe agregar el repositorio para Python 3.7, realizando una de las siguientes acciones:
Ejecute este comando:
sudo add-apt-repository ppa:deadsnakes/ppa
O construye e instala el repositorio desde la fuente
Para instalar Python 3.7, ejecute estos comandos:
sudo apt-get updatesudo apt install python3.7 python3.7-distutils
Obtención de la CLI de la estación de prueba de Android
Descargue el paquete de la interfaz de línea de comandos (CLI) aquí.
Inicio de 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, puede tardar 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
Copia de seguridad y restauración de 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 hace 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 tarde a través de la página Configuración.
Restaurar una copia de seguridad de la configuración
Si tiene un archivo de configuración respaldado 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 .
Figura 1. Restauración de una copia de seguridad de la configuración
Configuración de la cuenta de servicio predeterminada
Puede configurar una cuenta de servicio que Android Test Station use 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.
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.
Figura 3. Cambiar la cuenta de servicio
Importación de conjuntos de configuración
Un conjunto de configuración es un conjunto de configuraciones para ejecutar conjuntos de pruebas, incluidas acciones de dispositivos relacionadas, canales de compilación, etc. 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 configuración que están disponibles para usted.
Seleccione los conjuntos de configuración que le gustaría agregar a su host de Test Station y haga clic en Importar seleccionado .
Figura 4. Importación de un conjunto de configuración
Incluyendo la 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 Wi-Fi y el PSK de Wi-Fi opcional.
Figura 5. Configuración del punto de acceso Wi-Fi
Después de completar el asistente de configuración, la página se volverá a cargar con la nueva configuración aplicada.
Conexión de un dispositivo
La depuración de USB debe estar habilitada para usar un dispositivo para la prueba. Para habilitar la depuración:
Siga las instrucciones en Habilitar opciones de desarrollador y depuración .
Si planea usar versiones de prueba de Android precargadas con claves ADB personalizadas, coloque los archivos
.adb_keypersonalizados en el directorio~/.android/.Los archivos se cargan automáticamente y se pasan a ADB para habilitar automáticamente la depuración de USB después de que el dispositivo se actualice para los dispositivos que ejecutan esas compilaciones.
Conecte el dispositivo a la máquina host mediante USB.
El dispositivo aparecerá 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.
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 está ejecutando una prueba. Cada dispositivo puede ejecutar solo una prueba a la vez, por lo que el dispositivo debe finalizar su prueba actual antes de ejecutar una nueva.
Ejecutar una prueba
Selección de una prueba
Android Test Station viene con un conjunto de configuraciones CTS preempaquetadas. Para ejecutar una de estas pruebas, vaya a la pestaña Conjuntos de pruebas y haga clic en Ejecutar prueba para la prueba deseada.
Figura 7. Selección de una prueba
Para editar o agregar nuevas pruebas, consulte Agregar pruebas .
Configuración de 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 rellenan previamente con valores definidos en la configuración de prueba seleccionada.
Este paso se puede completar con los valores predeterminados, pero puede cambiar cualquiera de los parámetros, como Max Retry y Command , para adaptarlo a sus necesidades.
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.
- Máximo de reintentos : número máximo de veces para reintentar una ejecución de prueba si al menos una prueba falla. Por lo general, esto se establece en 4 a 6 reintentos para una ejecución completa de CTS para manejar pruebas escamosas.
- Tiempo de espera en cola : si una ejecución de prueba permanece en el estado En cola durante demasiado tiempo, se cancela automáticamente. Especifique la cantidad de tiempo de espera antes de la cancelación aquí. 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 ShortModuleNameComando de reintento : el comando para volver a intentar 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 ShortModuleNameLos argumentos de reintento pueden diferir de los disponibles con el comando inicial, así que verifique los parámetros admitidos en el sitio oficial para el 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 ejecución de prueba que se ve al ver los detalles de la ejecución de prueba.
Figura 9. Ejecución de prueba local anterior
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.
Figura 10. Ejecución de prueba remota anterior
Selección de dispositivos
Haga clic en las casillas de verificación para seleccionar los dispositivos que desea asignar para ejecutar el conjunto de pruebas. El recuento de fragmentos debería cambiar automáticamente para coincidir con la cantidad de dispositivos seleccionados.
Figura 11. Selección de dispositivos
Para seleccionar dispositivos por atributos que no sean números 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 soportados son:
- build_id
- dispositivo_serie
- tipo de dispositivo
- nombre de host
- producto
- variante_del_producto
- sim_estado
Todos los dispositivos seleccionados deben estar en el estado Disponible para ejecutar la prueba y todos cambian al estado Asignado cuando se ejecuta la prueba. Una ejecución de prueba está en estado En cola mientras espera que los dispositivos estén disponibles.
Adición de acciones del 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 .
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 acción(es) . Las acciones del dispositivo se realizan secuencialmente. Puede reordenar las acciones arrastrándolas.
Figura 13. Reordenación de acciones
Configuración de 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 proporcione la imagen de compilación.
La URL de descarga para el archivo zip del conjunto de pruebas debe ser predeterminada a 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 usar desde el almacenamiento local.
Figura 14. Recursos de prueba
A continuación se muestra la ventana emergente para seleccionar un recurso de prueba por una URL web. Simplemente puede ingresar el enlace de URL de descarga y hacer clic en el botón Seleccionar para confirmar la selección.
Figura 15. Selector de recursos de prueba - URL web
Si ha cargado recursos en Google Grive, Google Cloud Storage (GCS) u otros canales, también puede navegar a la pestaña del canal específico y seleccionar los recursos allí. Aquí hay un ejemplo para seleccionar un recurso de Google Drive.
Figura 16. Selector de recursos de prueba - Google Drive
Además de solo seleccionar archivos, los caracteres comodín también se admiten en el campo Nombre de archivo. La documentación se puede encontrar aquí .
Figura 17. Selector de recursos de prueba: soporte de patrón comodín
También puede seleccionar un archivo del almacenamiento de archivos local de Android Test Station. Puede cargar archivos en este almacenamiento o usar directamente archivos y directorios locales .
Figura 18. Selector de recursos de prueba - Almacén de archivos local
Agregar configuraciones de repetición
Puede programar repeticiones que comenzarán después de que se complete la ejecución principal y cargue sus resultados, pero puede usar diferentes dispositivos, acciones o recursos.
Figura 19. Adición de configuraciones de repetición
Inicio de 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 la prueba y se le redirige a una página para ver los detalles y el progreso de la ejecución de la prueba.
Figura 20. Inicio de una ejecución de prueba
Creación de un plan de prueba
Los planes de prueba se utilizan para crear ejecuciones de prueba en un programa 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 .
Figura 21. Creación de un plan de prueba
Configurar plan de prueba
Ingrese el nombre del plan de prueba y cualquier etiqueta que desee agregar. Luego seleccione un horario para usar.
- Manual : el plan de prueba solo creará ejecuciones de prueba cuando un usuario haga clic en Ejecutar plan de prueba en la página de lista de planes de prueba.
- Periódico : el plan de prueba programará automáticamente ejecuciones de prueba en 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 programará automáticamente ejecuciones de prueba en función de 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 sería
0 17 * * *.
Figura 22. Configuración de un plan de prueba
Agregar conjuntos de pruebas
Agregue conjuntos de pruebas que desea programar mediante el plan de prueba haciendo clic en + Agregar configuración de ejecución de prueba . Seleccione un conjunto de pruebas del menú desplegable Nombre y haga clic en Siguiente paso . Luego, seleccione los dispositivos en los que le gustaría ejecutar la prueba y haga clic en Agregar configuración . Puede agregar múltiples configuraciones para cada plan de prueba.
Figura 23. Configuración de una ejecución de prueba
Agregar acciones del dispositivo
Agregue las acciones del dispositivo que desea que se ejecuten antes de cada ejecución de prueba. Consulte Agregar acciones del dispositivo para obtener más detalles.
Figura 24. Adición de acciones de dispositivo
Establecer recursos de prueba
Agregar recursos de prueba a 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.
Figura 25. Configuración de recursos de prueba
Visualización de 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 subcadena) en cualquier columna, excepto Estado y Creado .
Un filtro vacío devuelve todas las filas. Actualmente no hay forma de filtrar filas con valores vacíos.
Figura 26. Lista de ejecución de prueba
Detalles de la ejecución de la prueba
Puede ver los detalles de una ejecución de prueba aquí, como el estado, los registros y los resultados.
Figura 27. Detalles de la ejecución de la 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í.
Figura 28. Estado de ejecución de prueba
Los estados de ejecución de la 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.
- Completed (Completado): la prueba ha finalizado y ha informado de sus resultados.
- Cancelado : el usuario canceló la prueba o se agotó el tiempo de espera mientras intentaba encontrar dispositivos disponibles.
- Error : se produjo un error que impidió que se ejecutara la prueba.
Cancelación de una ejecución de prueba
Si la ejecución de la prueba no se completó, puede cancelarla haciendo clic en Cancelar y luego en Sí 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 más tiempo que el campo queue_timeout_seconds . La cancelación de una ejecución de prueba mientras se encuentra en estado En ejecución puede tardar unos minutos en surtir efecto.
Figura 29. Cancelación de una ejecución de prueba
Resultados de la ejecución de prueba
Una vez finalizada la ejecución de una prueba, se recopilarán y mostrarán los resultados. 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 .
Figura 30. Resultados de la ejecución de la prueba
Puede ver los registros de host en vivo y de Tradefed en la pestaña Registros.
Figura 31. Pestaña Registros
Los resultados de los módulos individuales se encuentran en la pestaña 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.
Figura 33. Pestaña Recursos de prueba
Para ver los detalles de la ejecución de la prueba, como create_time , vaya a la pestaña Configuración.
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 compilación y acciones de dispositivos. 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.
Figura 35. Gestión de archivos de configuración
Después de descargar su archivo de configuración, comparta el archivo 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.
Creación de una nueva acción de dispositivo
Las acciones del dispositivo se utilizan para automatizar el proceso de configuración del dispositivo. Las acciones son scripts que se ejecutan 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 las 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.
Figura 36. Pestaña Acciones del dispositivo
Adición de una nueva acción de dispositivo
Haga clic en Nueva acción de dispositivo .
Figura 37. Botón de acción Nuevo dispositivo
Introduzca un nombre y una descripción.
Figura 38. Nombre de la acción del dispositivo
Haga clic en Agregar preparador de destino .
Ingrese el nombre completo de la clase de Trade Federation Target Preparer, por ejemplo,
com.android.tradefed.targetprep.RunHostCommandTargetPreparer.
Figura 39. Adición de un preparador de destino
Puede encontrar una lista de preparadores de objetivos disponibles en la referencia com.android.tradefed.targetprep .
Figura 40. Lista de preparados de destino
Agregue cualquier opción para usar con el preparador de destino. Para ver las opciones disponibles, consulte targetprep para obtener el código fuente de cada preparador de objetivos en AOSP:
Figura 41. Ejemplo de opción de acción
Para agregar una opción, haga clic en Agregar opción de preparador de destino e ingrese los valores requeridos.
Figura 42. Ejemplo de comando de acción
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 . A continuación, especifique el directorio de destino relativo en el directorio de trabajo temporal y los nombres de archivo que se descomprimirán. Si no se dan nombres de archivo, todos los archivos se descomprimen del recurso de prueba.
Figura 43. Recursos de prueba de acción
Haga clic en Actualizar .
Figura 44. Acción guardar cambios
Gestión de pruebas
Edición de 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 .
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 adecuada y haga clic en Crear .
Figura 46. Creación de una prueba
Figura 47. Copia de una prueba
Exportación de 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.
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.
Figura 49. Importación de una configuración de host
Uso de 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 puede seleccionarlo desde la pestaña Archivo local al programar una ejecución de prueba.
cp /path/to/file $HOME/.ats_storage
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
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 solo host controlador ATS para administrar los dispositivos y las pruebas en múltiples hosts trabajadores ATS.
Figura 52. Arquitectura de modo multi-host
Para iniciar el controlador ATS, use el siguiente comando:
mtt start --operation_mode=ON_PREMISEVerifique que el controlador sea accesible en http://controller:8000.
Para iniciar los trabajadores, use el siguiente comando:
mtt start --control_server_url=http://controller.com:8000 --operation_mode=ON_PREMISE
Si su red no permite que los hosts se comuniquen entre sí, deberá seguir las instrucciones de configuración más avanzadas a continuación en el trabajador ATS.
Conecte los dos hosts mediante túneles SSH. Seleccione 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_HOSTNAMEConfigure 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=${DOCKER_GATEWAY_IP_ADDRESS}:ATS_PORT \ --control_file_server_url=${DOCKER_GATEWAY_IP_ADDRESS}:FS_PORT \ --operation_mode=ON_PREMISE
Apoyo
Informe 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 errores . Los socios deben informar errores o sugerencias a través de sus canales de socios.