Guida avanzata ACTS

Questa è una guida su come eseguire i test della suite di test ACTS (Android Comms Test Suite).

Ottieni il codice

La versione più aggiornata di ACTS è disponibile nel repository Android Open Source Project (AOSP) Gerrit in /platform/tools/test/connectivity/.

Per maggiori dettagli su come sincronizzare il codice, consulta Scaricare il codice sorgente e il Codelab per sviluppatori Android. Quando sincronizzi il codice, sincronizza il ramo principale. Non sincronizzare una build con tag.

Tieni presente che quando scarichi ACTS, non è necessario sincronizzare l'intero repository Android. Per sincronizzare solo ACTS, dopo aver eseguito il comando repo init esegui:

repo sync platform/tools/test/connectivity

Gli ACTS sono disponibili in <repo>/tools/test/connectivity/acts/.

Configurazione dell'ambiente

Per assicurarti che ACTS abbia le dipendenze necessarie per la configurazione, installa i seguenti strumenti di configurazione di 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

Installa ACTS

Lo script setup.py presente in <repo>/tools/test/connectivity/acts/framework installa le altre dipendenze e ACTS stesso.

Per lo sviluppo continuo in o con ACTS, esegui questo comando:

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

Se vuoi eseguire solo test, esegui questo comando:

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

Verifica installazione

Dopo la configurazione, assicurati di poter utilizzare act.py nel terminale e importa i moduli ATS in Python. Ecco alcuni esempi:

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()

Esegui senza installazione

Gli utenti possono eseguire ACTS senza installare direttamente il pacchetto. L'unico passaggio che deve essere eseguito è la modifica del percorso Python per l'importazione da <repo>/tools/test/connectivity/acts/framework. Prima di eseguire ACTS, esegui setup.py install_deps per installare tutte le dipendenze richieste da ACTS senza installarlo. Se sulla macchina è installata una versione esistente di ACTS, esegui sudo setup.py uninstall.

Per eseguire ACTS, utilizza uno dei seguenti comandi:

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

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

ACTS restituisce messaggi che richiedono flag -c e -tc. Per ulteriori informazioni, consulta la sezione Configurazione dei test ACTS.

Configurare ACTS in un ambiente virtuale

Per isolare la tua installazione da altre installazioni di ACTS, dovresti installare ACTS in un ambiente virtuale. La procedura seguente presuppone che tu abbia acts_test.zip di aosp-main su ci.android.com o che tu abbia accesso diretto alla fonte.

  1. Scarica ACTS.

    Le build vengono pubblicate. Per maggiori informazioni, vedi Integrazione continua di Android. Puoi estrarre file ZIP da una build su ci.android.com. Cerca il target test_suites_x86_64.

    Il file acts_test.zip si trova nella scheda Artefatti. Per questo esempio, supponiamo che acts_test.zip sia stato scaricato in /tmp/acts_test.zip.

    Se hai accesso al codice sorgente, puoi utilizzare quello.

  2. Installa virtualenv sulla macchina.

    Se non l'hai già fatto, puoi installare virtualenv utilizzando:

    python3 -m pip install -U --user virtualenv

  3. Crea e attiva l'ambiente virtuale (in /tmp/my_virtualenv per questo esempio). Ciò garantisce che i nuovi pacchetti siano installati nella directory virtualenv.

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

  4. Installa ACTS. Esegui questo 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

    Se hai accesso direttamente al codice, puoi saltare il processo di decompressione:

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

  5. Esegui ACTS ovunque ti trovi.

    act.py -c <config> ...

  6. Al termine dei test, esci dall'ambiente virtuale.

    deactivate

Esegui il flashing del dispositivo Android (facoltativo)

Se vuoi ottenere il controllo privilegiato di sistema del dispositivo, esegui il flashing del dispositivo con una build userdebug.

Per eseguire il flashing del dispositivo, utilizza lo strumento Android Flash (flash.android.com/). Per ulteriori dettagli, consulta la documentazione di Android Flash Tool.

Installa SL4A (facoltativo, consigliato)

Se utilizzi un dispositivo con una build userdebug, hai la possibilità di controllare i privilegi di sistema del dispositivo utilizzando SL4A. Se il test non utilizza SL4A sul dispositivo, puoi impostare il flag skip_sl4a nella configurazione di ACTS per disabilitare la funzionalità.

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

Per ottenere l'APK SL4A, segui le istruzioni riportate nella pagina relativa allo Scripting Layer per Android.