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.
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 queacts_test.zip
se descargó en/tmp/acts_test.zip
.Si tiene acceso al código fuente, puede usarlo en su lugar.
Instale
virtualenv
en su máquina.Si aún no lo tiene, puede instalar
virtualenv
usando:python3 -m pip install -U --user virtualenv
Cree y active el entorno virtual (en
/tmp/my_virtualenv
para este ejemplo). Esto asegura que se instalen nuevos paquetes en el directoriovirtualenv
.python3 -m virtualenv /tmp/my_virtualenv
source /tmp/my_virtualenv/bin/activate
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
Ejecute ACTS desde cualquier lugar.
act.py -c <config> ...
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 .