Dies ist eine Anleitung zum Ausführen von Android Comms Test Suite (ACTS) -Tests.
Den Code erhalten
Die aktuellste Version von ACTS finden Sie im Gerrit-Repository des Android Open Source Project (AOSP) unter /platform/tools/test/connectivity/
.
Einzelheiten zum Synchronisieren des Codes finden Sie unter Herunterladen der Quelle und im Android Developer Codelab . Synchronisieren Sie beim Synchronisieren des Codes den Hauptzweig. Synchronisieren Sie keinen getaggten Build.
Beachten Sie, dass Sie beim Herunterladen von ACTS nicht das gesamte Android-Repository synchronisieren müssen. Um nur ACTS zu synchronisieren, führen Sie nach dem Ausführen des repo init
Befehls Folgendes aus:
repo sync platform/tools/test/connectivity
ACTS finden Sie unter <repo>/tools/test/connectivity/acts/
.
Umgebungseinrichtung
Um sicherzustellen, dass ACTS über die erforderlichen Abhängigkeiten für die Einrichtung verfügt, installieren Sie die folgenden Python 3-Setup-Tools:
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
ACTS installieren
Das setup.py
Skript in <repo>/tools/test/connectivity/acts/framework
installiert die restlichen Abhängigkeiten und ACTS selbst.
Führen Sie für die kontinuierliche Entwicklung auf oder mit ACTS den folgenden Befehl aus:
cd <repo>/tools/test/connectivity/acts/framework/
sudo python3 setup.py develop
cd -
Wenn Sie nur Tests ausführen möchten, führen Sie stattdessen diesen Befehl aus:
cd <repo>/tools/test/connectivity/acts/framework/
sudo python3 setup.py install
cd -
Überprüfen der Installation
Stellen Sie nach der Einrichtung sicher, dass Sie act.py
in Ihrem Terminal verwenden und ACTS-Module in Python importieren können. Zum Beispiel:
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()
Läuft ohne Installation
Benutzer können ACTS ausführen, ohne das Paket direkt zu installieren. Der einzige Schritt, der ausgeführt werden muss, ist die Änderung des Python-Pfads für den Import aus <repo>/tools/test/connectivity/acts/framework
. Führen Sie vor dem Ausführen von ACTS setup.py install_deps
aus, um alle erforderlichen Abhängigkeiten von ACTS zu installieren, ohne ACTS zu installieren. Wenn sich auf Ihrem Computer eine vorhandene Version von ACTS befindet, führen Sie sudo setup.py uninstall
aus.
Um ACTS auszuführen, verwenden Sie einen der folgenden Befehle:
cd <repo>/tools/test/connectivity/acts/framework; acts/bin/act.py
export PYTHONPATH=<repo>/tools/test/connectivity/acts/framework; acts/bin/act.py
ACTS gibt Nachrichten aus, die die Flags -c
und -tc
anfordern. Weitere Informationen finden Sie unter Konfigurieren von ACTS-Tests .
Einrichten von ACTS in einer virtuellen Umgebung
Um Ihre Installation von anderen Installationen von ACTS zu isolieren, sollten Sie ACTS in einer virtuellen Umgebung installieren. Bei den folgenden Schritten wird davon ausgegangen, dass Sie acts_test.zip
von aosp-main
auf ci.android.com haben oder direkten Zugriff auf die Quelle haben.
Holen Sie sich ACTS.
Builds werden veröffentlicht. Weitere Informationen finden Sie unter Android Continuous Integration . Sie können ZIP-Dateien von einem Build auf ci.android.com abrufen. Suchen Sie nach dem Ziel
test_suites_x86_64
.Die Datei
acts_test.zip
befindet sich auf der Registerkarte „Artefakte“. Gehen Sie für dieses Beispiel davon aus, dassacts_test.zip
nach/tmp/acts_test.zip
heruntergeladen wurde.Wenn Sie Zugriff auf den Quellcode haben, können Sie diesen stattdessen verwenden.
Installieren Sie
virtualenv
auf Ihrem Computer.Wenn Sie es noch nicht haben, können Sie
virtualenv
mit folgendem Befehl installieren:python3 -m pip install -U --user virtualenv
Erstellen und aktivieren Sie die virtuelle Umgebung (in diesem Beispiel in
/tmp/my_virtualenv
). Dadurch wird sichergestellt, dass neue Pakete imvirtualenv
Verzeichnis installiert werden.python3 -m virtualenv /tmp/my_virtualenv
source /tmp/my_virtualenv/bin/activate
Installieren Sie ACTS. Führen Sie den folgenden Befehl aus.
unzip /tmp/acts_test.zip -d /tmp/my_virtualenv/acts
cd /tmp/my_virtualenv/acts/tools/test/connectivity/acts/framework/
python3 setup.py install
Wenn Sie direkten Zugriff auf den Code haben, können Sie das Entpacken überspringen:
cd /path/to/acts/framework
python3 setup.py install
Führen Sie ACTS von überall aus aus.
act.py -c <config> ...
Verlassen Sie die virtuelle Umgebung, wenn Sie mit der Ausführung der Tests fertig sind.
deactivate
Flashen des Android-Geräts (optional)
Wenn Sie systemprivilegierte Kontrolle über das Gerät erhalten möchten, flashen Sie das Gerät mit einem userdebug
Build.
Um das Gerät zu flashen, verwenden Sie das Android Flash Tool (flash.android.com/) . Weitere Einzelheiten finden Sie in der Dokumentation unter Android Flash Tool .
SL4A installieren (optional, empfohlen)
Wenn Sie ein Gerät mit einem userdebug
Build verwenden, haben Sie die Möglichkeit, mithilfe von SL4A die Systemberechtigungskontrolle für Ihr Gerät zu erhalten. Wenn Ihr Test SL4A auf dem Gerät nicht verwendet, können Sie das Flag skip_sl4a
in der ACTS-Konfiguration setzen, um die Funktion zu deaktivieren.
"AndroidDevice": [{"serial": "standardized serial number reference", "skip_sl4a": true}, ...]
Um das SL4A APK zu erhalten, befolgen Sie die Anweisungen unter Scripting Layer für Android .