Guida ACTS avanzata

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

Ottenere il codice

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

Per dettagli su come sincronizzare il codice, consulta Download del codice sorgente e del codelab per sviluppatori Android . Quando sincronizzi il codice, sincronizza il ramo principale. Non sincronizzare una build contrassegnata.

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

ACTS può essere trovato in <repo>/tools/test/connectivity/acts/ .

Configurazione dell'ambiente

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

Installazione di ACTS

Lo script setup.py trovato in <repo>/tools/test/connectivity/acts/framework installa il resto delle dipendenze e ACTS stesso.

Per lo sviluppo continuo su o con ACTS, esegui il comando seguente:

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

Se desideri eseguire solo test, esegui invece questo comando:

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

Verifica dell'installazione

Dopo la configurazione, assicurati di poter utilizzare act.py nel tuo terminale e importare i moduli ACTS in Python. Per esempio:

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

In esecuzione senza installazione

Gli utenti possono eseguire ACTS senza installare direttamente il pacchetto. L'unico passaggio che deve essere eseguito è modificare il percorso Python da importare 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 installare ACTS. Se sul tuo computer è presente una versione esistente di ACTS, esegui sudo setup.py uninstall .

Per eseguire ACTS, utilizzare 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 emette messaggi che richiedono i flag -c e -tc . Per ulteriori informazioni, vedere Configurazione dei test ACTS .

Configurazione di ACTS in un ambiente virtuale

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

  1. Ottieni ATTI.

    Le build vengono pubblicate. Per ulteriori informazioni, consulta Integrazione continua 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 Artifact. Per questo esempio, presupponiamo che acts_test.zip sia stato scaricato in /tmp/acts_test.zip .

    Se hai accesso al codice sorgente, puoi invece usarlo.

  2. Installa virtualenv sul tuo computer.

    Se non lo hai già, puoi installare virtualenv usando:

    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 vengano installati nella directory virtualenv .

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

  4. Installa ACTS. Esegui il comando seguente.

    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 la decompressione:

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

  5. Esegui ACTS da qualsiasi luogo.

    act.py -c <config> ...

  6. Lasciare l'ambiente virtuale una volta terminata l'esecuzione dei test.

    deactivate

Flashare il dispositivo Android (facoltativo)

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

Per eseguire il flashing del dispositivo, utilizzare Android Flash Tool (flash.android.com/) . Per ulteriori dettagli, consultare la documentazione su Android Flash Tool .

Installazione di SL4A (opzionale, consigliata)

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

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

Per ottenere l'APK SL4A, seguire le istruzioni in Scripting Layer per Android .