Guía ACTS avanzada

Esta es una guía sobre cómo ejecutar pruebas de Android Comms Test Suite (ACTS) .

Obteniendo el código

La versión más actualizada de ACTS se puede encontrar en el repositorio Gerrit del Proyecto de código abierto de Android (AOSP) en /platform/tools/test/connectivity/ .

Para obtener detalles sobre cómo sincronizar el código, consulte Descarga del código fuente y el Codelab para desarrolladores de Android . Al sincronizar el código, sincronice la rama principal. No sincronices una compilación etiquetada.

Tenga en cuenta que al descargar ACTS, no necesita sincronizar todo el repositorio de Android. Para sincronizar solo ACTS, después de ejecutar el comando repo init , ejecute:

repo sync platform/tools/test/connectivity

ACTS se puede encontrar en <repo>/tools/test/connectivity/acts/ .

Configuración del entorno

Para asegurarse de que ACTS tenga las dependencias necesarias para la configuración, instale las siguientes herramientas de configuración de Python 3:

sudo apt-get install python3-setuptools
sudo apt-get install python3-pip
sudo apt-get install adb fastboot
sudo pip3 install --upgrade pip setuptools
# Needed due to an on-going bug.
sudo apt-get install protobuf-compiler

Instalación de ACTOS

El script setup.py que se encuentra en <repo>/tools/test/connectivity/acts/framework instala el resto de las dependencias y el propio ACTS.

Para un desarrollo continuo en o con ACTS, ejecute el siguiente comando:

cd <repo>/tools/test/connectivity/acts/framework/
sudo python3 setup.py develop
cd -

Si desea ejecutar solo pruebas, ejecute este comando en su lugar:

cd <repo>/tools/test/connectivity/acts/framework/
sudo python3 setup.py install
cd -

Verificando instalación

Después de la configuración, asegúrese de poder usar act.py en su terminal e importar módulos ACTS en Python. Por ejemplo:

act.py -h
usage: act.py [-h] -c <PATH> [--test_args Arg1 Arg2 ... ]
python3
>>> from acts.controllers import android_device
>>> device_list = android_device.get_all_instances()

Ejecutando sin instalar

Los usuarios pueden ejecutar ACTS sin instalar el paquete directamente. El único paso que se debe realizar es modificar la ruta de Python para importar desde <repo>/tools/test/connectivity/acts/framework . Antes de ejecutar ACTS, ejecute setup.py install_deps para instalar todas las dependencias requeridas por ACTS sin instalar ACTS. Si hay una versión existente de ACTS en su máquina, ejecute sudo setup.py uninstall .

Para ejecutar ACTS, utilice uno de los siguientes comandos:

  • cd <repo>/tools/test/connectivity/acts/framework; acts/bin/act.py

  • export PYTHONPATH=<repo>/tools/test/connectivity/acts/framework; acts/bin/act.py

ACTS genera mensajes que solicitan los indicadores -c y -tc . Para obtener más información, consulte Configuración de pruebas ACTS .

Configurar ACTS en un entorno virtual

Para aislar su instalación de otras instalaciones de ACTS, debe instalar ACTS en un entorno virtual. Los siguientes pasos suponen que tiene acts_test.zip de aosp-main en ci.android.com o que tiene acceso directo a la fuente.

  1. Obtenga ACTOS.

    Las compilaciones están publicadas. Para obtener más información, consulte Integración continua de Android . Puede extraer archivos zip de una compilación en ci.android.com . Busque el objetivo test_suites_x86_64 .

    El archivo acts_test.zip se encuentra en la pestaña Artefactos. Para este ejemplo, supongamos que acts_test.zip se ha descargado en /tmp/acts_test.zip .

    Si tiene acceso al código fuente, puede usarlo en su lugar.

  2. Instale virtualenv en su máquina.

    Si aún no lo tienes, puedes instalar virtualenv usando:

    python3 -m pip install -U --user virtualenv

  3. Cree y active el entorno virtual (en /tmp/my_virtualenv para este ejemplo). Esto garantiza que se instalen nuevos paquetes en el directorio virtualenv .

    python3 -m virtualenv /tmp/my_virtualenv
source /tmp/my_virtualenv/bin/activate

  4. Instalar ACTOS. Ejecute el siguiente comando.

    unzip /tmp/acts_test.zip -d /tmp/my_virtualenv/acts
cd /tmp/my_virtualenv/acts/tools/test/connectivity/acts/framework/
python3 setup.py install

    Si tiene acceso al código directamente, puede omitir la descompresión:

    cd /path/to/acts/framework
python3 setup.py install

  5. Ejecute ACTS desde cualquier lugar.

    act.py -c <config> ...

  6. Salga del entorno virtual cuando termine de ejecutar las pruebas.

    deactivate

Flashear el dispositivo Android (opcional)

Si desea obtener control privilegiado del sistema del dispositivo, actualice el dispositivo con una compilación userdebug .

Para actualizar el dispositivo, utilice la herramienta Flash de Android (flash.android.com/) . Para obtener más detalles, consulte la documentación en Android Flash Tool .

Instalación de SL4A (opcional, recomendado)

Si está utilizando un dispositivo con una compilación userdebug , tiene la opción de obtener control de privilegios del sistema de su dispositivo mediante SL4A. Si su prueba no usa SL4A en el dispositivo, puede configurar el indicador skip_sl4a en la configuración de ACTS para deshabilitar la función.

"AndroidDevice": [{"serial": "standardized serial number reference", "skip_sl4a": true}, ...]

Para obtener el APK SL4A, siga las instrucciones en Scripting Layer para Android .