Android Test Station de OmniLab

OmniLab ATS es una herramienta de pruebas que pueden usar los desarrolladores de Android y los ingenieros de pruebas una interfaz de usuario para ejecutar conjuntos de pruebas estándar de Android, como Conjunto de pruebas de compatibilidad (CTS) de Android. Esta herramienta funciona como una interfaz web para varios frameworks de prueba, como Federación de Comercio (TF) y Google Mobly, que te permite ejecutar CTS y pruebas multidispositivo en un conjunto de dispositivos de prueba con una configuración mínima, así como establecer un programa para ejecutar pruebas de forma continua.

Configurar OmniLab ATS

En esta sección, se explica cómo instalar y configurar la ATS de OmniLab.

OmniLab ATS usa el código fuente de las siguientes ubicaciones:

Instalar la ATS de OmniLab

Sigue los requisitos de hardware y software de los paquetes de pruebas que ejecutes.

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

No hay requisitos adicionales de hardware para OmniLab ATS, pero recomendamos Con el requisito de host de CTS como punto de partida.

Existen dos formas de instalar OmniLab ATS:

Cómo realizar la instalación con el programa de instalación

En Ubuntu 20.04 y versiones posteriores, el programa de instalación instala y configura todos los programas. y los recursos necesarios para ejecutar OmniLab ATS.

Para usar el programa de instalación, haz lo siguiente:

  1. Ejecuta el programa instalador:

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

Instalación manual

Instala Docker
  1. Sigue el instrucciones para instalar Docker Community Edition (CE) en tu máquina Linux.

  2. Sigue el pasos posteriores a la instalación para administrar Docker como un usuario no raíz.

  3. Es posible que debas reiniciar la ventana de la terminal o salir y volver a acceder para que se apliquen los cambios en los permisos.

Instala Python 3

La CLI de ATS de OmniLab se verifica con las versiones 3.7 a 3.11 de Python.

Para Ubuntu 16.04 o versiones anteriores, primero debes agregar el repositorio de Python 3 mediante una de las siguientes opciones:

  • Ejecuta este comando:

    sudo add-apt-repository ppa:deadsnakes/ppa
    
  • Compila e instala el repositorio de la fuente.

Para instalar Python 3, ejecuta los siguientes 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), ejecuta los siguientes comandos: en su lugar:

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

Obtener la CLI de ATS de OmniLab

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

Iniciar OmniLab ATS

Inicia OmniLab ATS con el siguiente comando:

mtt start

La primera vez que se inicie la IU, es posible que tarde unos minutos en aparecer. La CLI muestra una URL web para acceder a la IU en un navegador. De forma predeterminada, la URL web es localhost:8000 Si es necesario, puedes cambiar el puerto predeterminado al inicio con la marca --port.

Si hay una versión más reciente disponible, puedes actualizarla a la versión actual. Puedes consulta las Notas de la versión para conocer los lanzamientos más recientes.

Para actualizar a la versión actual, ejecuta el siguiente comando:

mtt start --force_update

Para detener la app, ejecuta lo siguiente:

mtt stop

Para ver una lista de otros comandos, usa:

mtt --help

Crea una copia de seguridad de la base de datos y restablécela

Para crear una copia de seguridad de la base de datos de ATS de OmniLab, detén la app y ejecuta el siguiente comando: que crea una copia de seguridad de la base de datos actual en un archivo TAR llamado mtt-backup.tar en tu directorio principal:

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

Para restablecer, ejecuta el siguiente comando antes de iniciar la app:

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

Luego de que instales y ejecutes OmniLab ATS por primera vez, el asistente de configuración tomará algunos pasos que te ayudarán a personalizar la herramienta según tu entorno. Cualquiera los cambios que realices aquí se pueden reconfigurar más adelante a través de la página Configuración.

Restablece una copia de seguridad de configuración

Si tienes una copia de seguridad de un archivo de configuración de con otro host de ATS de OmniLab, puedes subir el archivo para copiar las configuraciones modificado desde ese host haciendo clic en el botón Subir archivo.

Restablecer la copia de seguridad de la configuración

Figura 1: Restablecer una copia de seguridad de configuración

Configura la cuenta de servicio predeterminada

Puedes configurar una cuenta de servicio que OmniLab ATS usa de forma predeterminada cuando accede a sus recursos (por ejemplo, Google Cloud Storage o Google Drive). Para autenticar tu cuenta de servicio, haz clic Sube la clave de la cuenta de servicio y selecciona el archivo de claves JSON de tu cuenta de servicio.

Configurar cuenta de servicio

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

Cuando la cuenta de servicio se autentica correctamente, el correo electrónico de la cuenta aparece en la esquina superior derecha de la página. Cómo cambiar el servicio haz clic en el nombre de la cuenta, elimina la cuenta predeterminada actual y sube el una nueva clave de cuenta de servicio.

Cambiar cuenta de servicio

Figura 3: Cambiando la cuenta de servicio.

Importa conjuntos de configuración

Un conjunto de configuraciones es un paquete de parámetros de configuración para ejecutar paquetes de pruebas, incluidos los parámetros las acciones del dispositivo y los canales de compilación. Los conjuntos de configuración se alojan en una cuenta bucket de Cloud Storage (GCS). Después de autenticar el canal de compilación de GCS con tu Cuenta de Google, verás una lista de todos los conjuntos de configuración disponibles.

Selecciona los conjuntos de configuración que quieras agregar al host de Test Station y haz clic en Importar los seleccionados.

Importa conjuntos de configuración

Figura 4: Importar un conjunto de configuración

Incluir la configuración de Wi-Fi

Algunas pruebas del CTS requieren que tu dispositivo se conecte a un hotspot de Wi-Fi. Para seleccionar tu Red Wi-Fi, ingresa el SSID de Wi-Fi y la PSK de Wi-Fi opcional.

Configuración de Wi-Fi

Figura 5: Configuración de hotspot de Wi-Fi.

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

Conectar dispositivo

Debes habilitar la depuración por USB para usar un dispositivo para pruebas. Para habilitar la depuración, haz lo siguiente:

  1. Sigue las instrucciones que se indican en Habilita las opciones para desarrolladores y depuraciones.

  2. Si planeas usar compilaciones de prueba de Android precargadas con claves ADB personalizadas, coloca los archivos .adb_key personalizados en el directorio ~/.android/.

    Los archivos se cargan automáticamente y pasan a adb para habilitar el USB automáticamente. después de la instalación en la memoria flash de los dispositivos que ejecutan esas compilaciones.

  3. Conecta el dispositivo a la máquina anfitrión mediante USB.

    El dispositivo aparecerá en la pestaña Dispositivos de ATS de OmniLab en un plazo de un minuto actualizando la interfaz web. También puedes ver el estado de los dispositivos en esta pestaña.

    Conectar un dispositivo

    Figura 6: Cómo conectar un dispositivo

Los diferentes estados del dispositivo son los siguientes:

  • Disponible: El dispositivo está conectado y listo para ejecutar una prueba.
  • Asignado: El dispositivo está conectado y está ejecutando una prueba. Cada el dispositivo solo puede ejecutar una prueba a la vez, de modo que debe finalizar su prueba actual antes de ejecutar una nueva.

Cómo ejecutar una prueba

Selecciona una prueba

OmniLab ATS incluye un conjunto de configuraciones de CTS integradas previamente. Para ejecutar uno de estas pruebas, ve a la pestaña Paquetes de pruebas y haz clic en Ejecutar prueba para el grupo seleccionado la prueba.

Selecciona una prueba

Figura 7: Selecciona una prueba.

Para editar o agregar pruebas nuevas, consulta Cómo agregar pruebas.

Configura la ejecución de la prueba

Edita los parámetros que se usarán en esta ejecución de prueba específica. La mayoría de los parámetros son prepropagado con valores definidos en la configuración de prueba seleccionada.

Este paso se puede completar con los valores predeterminados, pero puedes cambiar cualquiera de los parámetros, como Max Retry y Command, según tus necesidades.

Configura la ejecución de prueba

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

Los parámetros de la ejecución de pruebas son los siguientes:

  • Nombre: Es el nombre del conjunto de pruebas que deseas ejecutar.
  • Recuento de ejecuciones: Indica la cantidad de veces que debe ejecutarse esta prueba cuando programado. Las ejecuciones de prueba se programan Federación de Comercio, que ejecuta hasta 20 si hay capacidad para hacerlo.
  • Reintento máximo: Cantidad máxima de veces que se puede reintentar la ejecución de una prueba, si se realiza al menos una la prueba falla. Por lo general, se establece en 4 o 6 reintentos para que una ejecución completa del CTS sea manejar pruebas inestables.
  • Tiempo de espera de la cola: Si una ejecución de prueba permanece en el estado En cola por mucho tiempo, se cancela automáticamente. Especifica el tiempo que se debe esperar antes Cancelar. El valor predeterminado es 24 horas.
  • Comando: Es el comando para ejecutar el conjunto de pruebas. Puedes ingresar los argumentos de línea de comandos. Por ejemplo, ejecuta un módulo específico en CTS 8.1 con:

    cts-suite -m ShortModuleName
    
  • Comando Reintentar: Es el comando para reintentar un conjunto de pruebas. Puedes agregar argumentos de línea de comandos adicionales. Por ejemplo, para reintentar solo un módulo específico en CTS 8.1, usa:

    cts --retry 0 -m ShortModuleName
    

    Los argumentos de reintento pueden diferir de los disponibles en el comando inicial así que verifica los parámetros admitidos en el sitio oficial para la prueba seleccionada suite.

  • Ejecución de prueba anterior: Si deseas volver a ejecutar una prueba anterior, haz lo siguiente:

    • Local: Si la ejecución se inició en el host actual, ingresa la ejecución de prueba. Es el ID que se ve cuando se visualizan los detalles de la ejecución de prueba.

      Ejecución de prueba anterior local

      Figura 9: Ejecución de prueba local anterior.

    • Remoto: Si la ejecución se inició en un host diferente, sube la prueba. el archivo de resultados. Para ello, selecciona Remoto y haz clic en Subir resultados de la prueba. Archivo y selecciona un archivo de tu almacenamiento local.

      Ejecución de prueba anterior anterior

      Figura 10: Ejecución de prueba anterior remota.

Elegir dispositivos

Haz clic en las casillas de verificación para seleccionar los dispositivos que asignarás para ejecutar la prueba. suite. El recuento de fragmentos debe cambiar automáticamente para coincidir con el dispositivos seleccionados.

Selecciona los dispositivos

Figura 11: Selección de dispositivos.

Para seleccionar dispositivos por atributos que no sean el número de serie, puedes ingresa "Especificaciones del dispositivo". Por ejemplo, para seleccionar 3 dispositivos cuyo nombre de producto sea "bramble", ingresa lo siguiente:

product:bramble;product:bramble;product:bramble

Los atributos admitidos son los siguientes:

  • id_compilación
  • número_de_dispositivo
  • tipo_dispositivo
  • nombre de host
  • producto
  • variante_producto
  • estado_sim

Todos los dispositivos seleccionados deben tener el estado Disponible para ejecutar la prueba. y todas cambian al estado Asignada cuando se ejecuta la ejecución de la prueba. R la ejecución de la prueba se encuentra en el estado En cola mientras espera que los dispositivos se disponibles.

Agregar acciones del dispositivo

Las acciones del dispositivo son secuencias de comandos que se pueden ejecutar antes de cada ejecución de prueba. Algunos las acciones del dispositivo ya están configuradas, como la instalación y el reinicio. Para crear nuevas acciones de dispositivos, consulta Crea una nueva acción del dispositivo.

Acciones del dispositivo

Figura 12: Acciones del dispositivo.

Para agregar una acción del dispositivo a una ejecución de prueba, haz clic en Add new action, selecciona casillas de verificación para las acciones que desea agregar y haga clic en Agregar acciones. Acciones del dispositivo se realizan de forma secuencial. Puedes reordenar las acciones arrastrándolas.

Agregar acciones

Figura 13: Se están reordenando las acciones.

Configura recursos de prueba

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

La URL de descarga del archivo ZIP del paquete de pruebas debería ser la de Google Drive de forma predeterminada vínculos proporcionados a los socios. Para seleccionar otro archivo, haz clic en Explorar. En la ventana emergente, puedes ingresar un vínculo para descargar un archivo, usar un archivo de un canal de compilación autenticado o subir un archivo para usarlo desde el almacenamiento local.

Recursos de prueba

Figura 14: Recursos de prueba

A continuación, se muestra una ventana emergente para seleccionar un recurso de prueba mediante una URL web. Puedes ingrese el vínculo de la URL de descarga y haga clic en el botón Seleccionar para confirmar selección.

Selector de recursos de prueba: URL web

Figura 15: Selector de recursos de prueba: URL web

Si subiste recursos a Google Grive, Google Cloud Storage (GCS) o otros canales, también puedes navegar a la pestaña del canal específico y seleccionar en ellos. Este es un ejemplo de cómo seleccionar un recurso en Google Drive.

Selector de recursos de prueba - Google Drive

Figura 16: Selector de recursos de pruebas - Google Drive.

Además de seleccionar archivos, los caracteres comodín también se admiten en Filename. Puedes encontrar la documentación aquí.

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

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

También puedes seleccionar un archivo del almacenamiento de archivos local de OmniLab ATS. Puedes subir en este almacenamiento, o Usar archivos y directorios locales directamente.

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

Figura 18: Selector de recursos de prueba: Almacén de archivos local

Agregar parámetros de configuración para volver a ejecutar

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

Agregar configuraciones de repetición

Figura 19: Agregar configuraciones de volver a ejecutar

Cómo iniciar una ejecución de prueba

Después de ingresar la información necesaria para la ejecución de prueba, haz clic en Comenzar prueba. Ejecutar (Run). Si toda la información es válida, comienza la ejecución de prueba y Se te redireccionará a una página para ver los detalles y el progreso de la ejecución de la prueba.

Iniciar ejecución de prueba

Figura 20: Iniciando una ejecución de prueba.

Crea un plan de prueba

Los planes de prueba se usan para crear ejecuciones de prueba de forma periódica. Por ejemplo: con CTS 9.0 todos los días a las 5 p.m. Para crear un nuevo plan de prueba, haz clic en Crear un nuevo plan de prueba.

Crear plan de prueba

Figura 21: Crear un plan de prueba

Configura el plan de prueba

Ingresa el nombre del plan de prueba y las etiquetas que quieras agregar. Luego, selecciona un el cronograma de uso.

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

Configurar el plan de prueba

Figura 22: Configurar un plan de prueba

Agrega paquetes de pruebas

Para agregar los paquetes de pruebas que deseas programar en el plan de prueba, haz clic en + Agregar configuración de ejecución de prueba. Selecciona un paquete de pruebas del menú desplegable Nombre y haz clic en Paso siguiente. Luego, selecciona los dispositivos en los que quieres ejecutar la prueba y Haz clic en Add Configuration. Puedes agregar varias configuraciones para cada prueba de recuperación ante desastres.

Configura la ejecución de prueba

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

Agregar acciones del dispositivo

Agrega las acciones del dispositivo que quieras que se ejecuten antes de cada ejecución de prueba. Consulta Cómo agregar acciones del dispositivo para obtener más detalles.

Agregar acciones del dispositivo

Figura 24: Agregar acciones del dispositivo.

Configura recursos de prueba

Agregar recursos de prueba a los planes de prueba es lo mismo que agregarlos a pruebas individuales o en cualquier plataforma que ejecute Knative. Consulta Cómo configurar los recursos de prueba para obtener más detalles.

Configurar recursos de prueba

Figura 25: Configuración de recursos de prueba

Cómo ver las ejecuciones de pruebas

Lista de ejecuciones de pruebas

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

También puedes filtrar la lista ingresando una cadena en la barra de filtros y presiona la tecla Intro. Puedes usar varios filtros separándolos con una coma. El filtro devuelve todas las filas que contienen el texto exacto (sin subcadena coincidentes) en cualquier columna, excepto Status y Created.

Un filtro vacío muestra todas las filas. En este momento, no hay forma de filtrar las filas con valores vacíos.

Lista de ejecuciones de pruebas

Figura 26: Lista de ejecuciones de pruebas.

Detalles de la ejecución de prueba

Aquí puedes ver los detalles de la ejecución de una prueba, como el estado, los registros y resultados.

Detalles de la ejecución de prueba

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

Estado de la ejecución de prueba

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

Estado de la ejecución de prueba

Figura 28: Estado de la ejecución de prueba.

Los estados de ejecución de la prueba son los siguientes:

  • Pendiente: Los recursos necesarios se están descargando.
  • En cola: La prueba está lista para ejecutarse cuando un dispositivo está disponible.
  • Running: La prueba se está ejecutando en un dispositivo asignado.
  • Completada: La prueba se completó y informó sus resultados.
  • Cancelada: el usuario canceló la prueba o se agotó el tiempo de espera mientras intentaba realizar encontrar dispositivos disponibles.
  • Error: Se produjo un error que impidió que se ejecutara la prueba.

Cómo cancelar una ejecución de prueba

Si no se completó la ejecución de prueba, puedes cancelarla haciendo clic en Cancelar y y, luego, haz clic en en el diálogo de confirmación. Las ejecuciones de prueba cancelen automáticamente si permanecen en el estado En cola más tiempo que el queue_timeout_seconds. Cómo cancelar una ejecución de prueba en estado Running puede tardar unos minutos en aplicarse.

Cancelar la ejecución de prueba

Figura 29: Cancelar una ejecución de prueba.

Resultados de la ejecución de prueba

Cuando finaliza una ejecución de prueba, se recopilan los resultados y se muestran. Puedes y ver detalles adicionales haciendo clic en la flecha de cada ejecución. Haz clic en Ver resultado. Files 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.

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

Registros de ejecución de pruebas

Figura 31: Pestaña Registros.

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

Pestaña Resultados de la prueba

Figura 32: Pestaña Resultados de la prueba.

Puedes descargar los archivos usados como recursos de prueba haciendo clic en Abrir en Pestaña Test Resources.

Pestaña Recursos de prueba

Figura 33: Pestaña Test Resources.

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

Pestaña Test Config

Figura 34: Configuración.

Funciones avanzadas

Administra los archivos de configuración

OmniLab ATS utiliza archivos de configuración escritos en YAML para cargar opciones predefinidas como pruebas, canales de compilación y acciones de dispositivos. Este es un archivo de configuración de ejemplo:

// 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 configuras tu instancia de ATS de OmniLab, puedes compartir la configuración con otros usuarios exportándolo como un archivo. Para ello, ve a la página Configuración y Haz clic en Exportar en la parte superior derecha.

Administración de archivos de configuración

Figura 35: Administración de archivos de configuración.

Después de descargar el archivo de configuración, compártelo con otros usuarios. Puede agregar el archivo de configuración a su instancia de ATS de OmniLab haciendo clic Importa y selecciona el archivo de configuración.

Crea una nueva acción del dispositivo

Las acciones del dispositivo se utilizan para automatizar el proceso de configuración del dispositivo. Las acciones son de comandos que se ejecutan en cada dispositivo donde se ejecuta la prueba antes de cada ejecución de prueba incluso antes de los reintentos. Para ver una lista de las acciones disponibles del dispositivo, ve a la Configuración y haz clic en la pestaña Device Actions. Varias acciones del dispositivo configurados, como reinicio y escritura en la memoria flash.

Pestaña Device Actions

Figura 36: Pestaña Device Actions

Cómo agregar una nueva acción del dispositivo

  1. Haz clic en Acción de dispositivo nuevo.

    Botón de acción del dispositivo nuevo

    Figura 37: Botón de acción Dispositivo nuevo.

  2. Ingresa un nombre y una descripción.

    Nombre de la acción del dispositivo

    Figura 38: Es el nombre de la acción del dispositivo.

  3. Haz clic en Add Target Preparer.

  4. Ingresa el objetivo de la Federación de Comercio. Es el nombre completo de la clase del preparador, por ejemplo, com.android.tradefed.targetprep.RunHostCommandTargetPreparer

    Agregar preparador de destino

    Figura 39: Cómo agregar un preparador de destino

    Puedes encontrar una lista de los preparadores de objetivos disponibles en el com.android.tradefed.targetprep referencia.

    Lista de preparadores de destino

    Figura 40: Lista de preparadores de destino.

  5. Agrega cualquier opción para usar con el preparador de objetivos. Para ver las opciones disponibles, verificar targetprep del código fuente de cada preparador de destino en AOSP:

    Ejemplo de la opción de acción

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

  6. Para agregar una opción, haz clic en Add Target Preparer Option y, luego, ingresa el los valores requeridos.

    Ejemplo de comando de acción

    Figura 42: Ejemplo de comando de acción.

  7. Define los recursos de prueba necesarios para ejecutar la acción del dispositivo. por ejemplo, compilar imágenes para la escritura en la memoria flash. Para agregar una definición de recurso, haz clic en Agrega el recurso de prueba y completa los campos obligatorios. Si sabes dónde se encuentran tus archivos, puedes proporcionar una URL de descarga predeterminada haciendo clic navegar. Si los preparadores de destino aceptan un directorio como recurso de prueba, Selecciona Descomprimir. Luego, especifica el directorio Destination relativo en el directorio de trabajo temporal y en los File Names sin comprimir. Si no se proporcionan nombres de archivo, se descomprimen todos los archivos de el recurso de prueba.

    Recursos de prueba de acción

    Figura 43: Recursos de prueba de acciones.

  8. Haz clic en Actualizar.

    Acción para guardar cambios

    Figura 44: Acción para guardar cambios

Administra las pruebas

Cómo editar una prueba

Para editar una prueba guardada, ve a la página Pruebas y haz clic en Editar en la fila de la la prueba que quieres modificar. Luego de cambiar la configuración de prueba, haz clic en Actualizar.

Cómo editar una prueba

Figura 45: Edita una prueba.

Cómo agregar una prueba nueva

Para agregar una prueba nueva, ve a la página Pruebas y haz clic en Crear una prueba nueva. Ingresar la información adecuada y haz clic en Crear.

Crea una prueba

Figura 46: Se está creando una prueba.

Copia una prueba

Figura 47: Copiando una prueba.

Exporta configuraciones de host

Después de configurar un host, puedes exportar su configuración a un archivo. Puedes subir este archivo a otros hosts para copiar las configuraciones guardadas.

Para exportar la configuración de un host, ve a la página Configuración y haz clic en Exportar. en la esquina superior derecha.

Exporta la configuración del host

Figura 48: Exportar una configuración de host

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

Importa los parámetros de configuración de host

Figura 49: Importar una configuración de host

Cómo usar archivos y directorios locales

A partir de la versión R11, los archivos del directorio $HOME/.ats_storage se se puede acceder automáticamente en OmniLab ATS. Copiar o mover un archivo a ese directorio, podrás seleccionarlo desde la pestaña Local File cuando programes una en la ejecución de prueba.

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

Selecciona un archivo local

Figura 50: Selecciona un archivo del directorio $HOME/.ats_storage.

Puedes activar directorios adicionales en el almacén de archivos local con el --mount_local_path.

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

Directorios activados adicionales

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

Habilitar el modo para varios hosts

Con el modo para varios hosts, los usuarios pueden usar un único host de controlador ATS para administrar la y pruebas en varios hosts trabajadores de ATS.

Arquitectura del modo multihost

Figura 52: Arquitectura del modo de múltiples hosts.

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

    mtt start --operation_mode=ON_PREMISE
    
  2. Se puede acceder al control desde http://${CONTROLLER_HOSTNAME}:8000.

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

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

Si la red no permite que los hosts se comuniquen entre sí, debes seguir las instrucciones de configuración más avanzadas que aparecen a continuación sobre el trabajador ATS.

  1. Conectar los dos hosts a través de túneles SSH Selecciona puertos para el puertos principales y de servidor de archivos, como 9000 y 9006.

    ssh -L ATS_PORT:localhost:8000 -L FS_PORT:localhost:8006 CONTROLLER_HOSTNAME
    
  2. Configurar e iniciar 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
    

Limpieza de archivos

El limpiador de archivos es un trabajo cron que se ejecuta cada hora para limpiar archivos según parámetros de configuración definidos por el usuario. ATS tiene dos configuraciones predeterminadas para archivar pruebas ejecutar resultados y borrar archivos temporales. En esta guía, se explica cómo personalizar las políticas y los parámetros de configuración para administrar tus archivos de forma eficaz.

Políticas

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

Tipo de operaciónParámetros
ARCHIVEremove_file: Si es true, quita el archivo después de archivarlo.
DELETE

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

Tipo de criterioDescripciónParámetros
LAST_MODIFIED_TIMEFiltrar archivos en función de su última fecha y hora de modificación.ttl: Se admiten varios tipos de expresiones de tiempo, por ejemplo, 10m, 2h, 7 days y 4w. Consulta pytimeparse para conocer los formatos compatibles.
LAST_ACCESS_TIMEFiltrar archivos según la fecha y hora de su último acceso.Es igual que LAST_MODIFIED_TIME.
NAME_MATCHFiltra los archivos según su nombre mediante una expresión regular.pattern: Es la expresión regular, por ejemplo, [a-f0-9]{8}-([a-f0-9]{4}-){3}[a-f0-9]{12}\.zip para que coincida con los ZIP de resultados.
SYSTEM_AVAILABLE_SPACEActiva acciones según 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 para limpiar archivos

Figura 53: Agrega una nueva política para limpiar 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 el definidas por el usuario. 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 el config especifica el directorio de destino como logs, se interpreta como /data/logs

Editar la configuración del limpiador de archivos

Figura 54: Edita la configuración del limpiador de archivos.

Restablecer

Si haces clic en Reset Settings, se revierte la configuración del limpiador de archivos a su estado el 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

Asistencia

Informes de errores

Tu contribución a la ATS de OmniLab ayuda a mejorar el desarrollo de la herramienta. queremos tu opinión. Consulta la Notas de la versión de ATS de OmniLab para obtener detalles sobre la versión más reciente. Para informar errores o ofrecer sugerencias, presentar un informe de errores. Los socios deben informar errores o sugerencias a través de sus canales de socios.