Guía avanzada de actos

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

Obtener 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 de la fuente y el Codelab del desarrollador de Android . Al sincronizar el código, sincronice la rama principal. No sincronizar 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 el 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, use 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 las banderas -c y -tc . Para obtener más información, consulte Configuración de pruebas ACTS .

Configuración de 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 asumen que tiene acts_test.zip de aosp-master en ci.android.com o tiene acceso directo a la fuente.

  1. Obtener ACTOS.

    Las compilaciones se publican. 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, suponga que acts_test.zip se descargó 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 tiene, puede 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 asegura 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. Abandone el entorno virtual cuando termine de ejecutar las pruebas.

    deactivate

Flashear el dispositivo Android (opcional)

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

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 de userdebug de usuario, tiene la opción de obtener el 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 de SL4A, siga las instrucciones en Scripting Layer para Android .