Esta es una guía sobre cómo ejecutar pruebas del Conjunto de pruebas de comunicaciones de Android (ACTS).
Obtén el código
La versión más actualizada de ACTS se encuentra en el repositorio de Gerrit del Proyecto de código abierto de Android (AOSP), en /platform/tools/test/connectivity/
.
Si deseas obtener detalles para sincronizar el código, consulta Descarga el código fuente y el Codelab para desarrolladores de Android. Cuando sincronices el código, sincroniza la rama principal. No sincronices una compilación etiquetada.
Ten en cuenta que, cuando descargas ACTS, no necesitas sincronizar todo el repositorio de Android. Para sincronizar solo ACTS, después de ejecutar el comando repo init
, ejecuta lo siguiente:
repo sync platform/tools/test/connectivity
Puedes encontrar ACTS en <repo>/tools/test/connectivity/acts/
.
Configuración del entorno
A fin de asegurarte de que ACTS tenga las dependencias necesarias para la configuración, instala 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
Instala ACTS
La secuencia de comandos setup.py
que se encuentra en <repo>/tools/test/connectivity/acts/framework
instala el resto de las dependencias y el ACTS.
Para el desarrollo continuo con ACTS, ejecuta el siguiente comando:
cd <repo>/tools/test/connectivity/acts/framework/
sudo python3 setup.py develop
cd -
Si solo quieres ejecutar pruebas, ejecuta este comando:
cd <repo>/tools/test/connectivity/acts/framework/
sudo python3 setup.py install
cd -
Verifica la instalación
Después de la configuración, asegúrate de que puedas usar act.py
en la terminal y, luego, importa los módulos de 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()
Ejecutar sin instalar
Los usuarios pueden ejecutar ACTS sin instalar el paquete directamente. El único paso que debe realizarse es modificar la ruta de Python para importar desde <repo>/tools/test/connectivity/acts/framework
. Antes de ejecutar el ACTS, ejecuta setup.py install_deps
para instalar todas las dependencias requeridas por el ACTS sin instalarlo. Si hay una versión existente de ACTS en tu máquina, ejecuta sudo setup.py uninstall
.
Para ejecutar ACTS, usa 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 envía mensajes que solicitan las marcas -c
y -tc
. Para obtener más información, consulta Cómo configurar pruebas de ACTS.
Configurar ACTS en un entorno virtual
Para aislar la instalación de otras instalaciones de ACTS, debes instalarlas en un entorno virtual. En los siguientes pasos, se supone que tienes acts_test.zip
de aosp-main
en ci.android.com o que tienes acceso directo a la fuente.
Obtenga información sobre ACTS.
Las compilaciones se publican. Para obtener más información, consulta Integración continua de Android. Puedes extraer archivos ZIP de una compilación en ci.android.com. Busca el destino
test_suites_x86_64
.El archivo
acts_test.zip
se encuentra en la pestaña Artefactos. Para este ejemplo, supongamos que se descargóacts_test.zip
en/tmp/acts_test.zip
.Si tienes acceso al código fuente, puedes usarlo.
Instala
virtualenv
en tu máquina.Si aún no lo tienes, puedes instalar
virtualenv
con el siguiente comando:python3 -m pip install -U --user virtualenv
Crea y activa el entorno virtual (en
/tmp/my_virtualenv
para este ejemplo). Esto garantiza que se instalen paquetes nuevos en el directoriovirtualenv
.python3 -m virtualenv /tmp/my_virtualenv
source /tmp/my_virtualenv/bin/activate
Instala ACTS. Ejecuta 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 tienes acceso al código directamente, puedes omitir la descompresión:
cd /path/to/acts/framework
python3 setup.py install
Ejecuta ACTS desde cualquier lugar.
act.py -c <config> ...
Abandona el entorno virtual cuando termines de ejecutar las pruebas.
deactivate
Escribe en la memoria flash del dispositivo Android (opcional)
Si deseas obtener un control privilegiado del sistema del dispositivo, escribe en la memoria flash del dispositivo una compilación userdebug
.
Para escribir en la memoria flash del dispositivo, usa Android Flash Tool (flash.android.com/). Para obtener más información, consulta la documentación en Android Flash Tool.
Instala SL4A (opcional, recomendado)
Si usas un dispositivo con una compilación userdebug
, tienes la opción de obtener el control de privilegio del sistema de tu dispositivo mediante SL4A. Si la prueba no usa SL4A en el dispositivo, puedes establecer la marca skip_sl4a
en la configuración de ACTS para inhabilitar la función.
"AndroidDevice": [{"serial": "standardized serial number reference", "skip_sl4a": true}, ...]
Para obtener el APK de SL4A, sigue las instrucciones en Capa de secuencias de comandos para Android.