Zaawansowany przewodnik po programach ACTS

Ten przewodnik zawiera instrukcje wykonywania testów Android Comms Test Suite (ACTS).

Pobierz kod

Najnowszą wersję ACTS znajdziesz w repozytorium Gerrit w ramach Projektu Android Open Source (AOSP) pod adresem /platform/tools/test/connectivity/.

Szczegółowe informacje o synchronizowaniu kodu znajdziesz w artykule Pobieranie kodu źródłowego i Codelab dla deweloperów aplikacji na Androida. Podczas synchronizowania kodu zsynchronizuj gałąź główną. Nie synchronizuj otagowanej kompilacji.

Podczas pobierania ACTS nie musisz synchronizować całego repozytorium Androida. Aby zsynchronizować tylko ACTS, po uruchomieniu polecenia repo init uruchom polecenie:

repo sync platform/tools/test/connectivity

Aktywność ACTS znajdziesz w sekcji <repo>/tools/test/connectivity/acts/.

Konfiguracja środowiska

Aby mieć pewność, że ACTS ma zależności wymagane do konfiguracji, zainstaluj te narzędzia do konfiguracji w Pythonie 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

Zainstaluj ACTS

Skrypt setup.py znajdujący się w <repo>/tools/test/connectivity/acts/framework instaluje pozostałe zależności i sam ACTS.

Aby zapewnić ciągłe programowanie w usłudze ACTS lub z nią, uruchom to polecenie:

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

Jeśli chcesz uruchomić tylko testy, uruchom to polecenie:

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

Sprawdzanie instalacji

Po zakończeniu konfiguracji sprawdź, czy możesz używać act.py w terminalu i zaimportuj moduły ATS w Pythonie. Na przykład:

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

Uruchom bez instalowania

Użytkownicy mogą uruchamiać ACTS bez instalowania pakietu bezpośrednio. Jedynym krokiem, który trzeba wykonać, jest zmodyfikowanie ścieżki Pythona na potrzeby importu z instancji <repo>/tools/test/connectivity/acts/framework. Zanim uruchomisz ACTS, uruchom setup.py install_deps, aby zainstalować wszystkie wymagane zależności przez ACTS bez instalowania ACTS. Jeśli na komputerze jest już zainstalowana wersja ACTS, uruchom sudo setup.py uninstall.

Aby uruchomić ACTS, użyj jednego z tych poleceń:

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

ACTS generuje komunikaty z flagami -c i -tc. Więcej informacji znajdziesz w artykule Konfigurowanie testów ACTS.

Konfigurowanie ACTS w środowisku wirtualnym

Aby odizolować instalację od innych instalacji ACTS, zainstaluj ACTS w środowisku wirtualnym. W poniższych krokach przyjęto, że masz acts_test.zip z aosp-main na ci.android.com lub masz bezpośredni dostęp do źródła.

  1. Pobierz ACTS.

    Wersje są publikowane. Więcej informacji znajdziesz w artykule o ciągłej integracji Androida. Pliki ZIP możesz pobrać z kompilacji na stronie ci.android.com. Poszukaj celu test_suites_x86_64.

    Plik acts_test.zip znajduje się na karcie Artefakty. W tym przykładzie zakładamy, że plik acts_test.zip został pobrany do folderu /tmp/acts_test.zip.

    Jeśli masz dostęp do kodu źródłowego, możesz go użyć.

  2. Zainstaluj virtualenv na komputerze.

    Jeśli jeszcze nie masz aplikacji virtualenv, możesz ją zainstalować za pomocą:

    python3 -m pip install -U --user virtualenv

  3. Utwórz i aktywuj środowisko wirtualne (w tym przykładzie /tmp/my_virtualenv). Dzięki temu nowe pakiety są instalowane w katalogu virtualenv.

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

  4. Zainstaluj ACTS. Uruchom podane niżej polecenie.

    unzip /tmp/acts_test.zip -d /tmp/my_virtualenv/acts
cd /tmp/my_virtualenv/acts/tools/test/connectivity/acts/framework/
python3 setup.py install

    Jeśli masz bezpośredni dostęp do kodu, możesz pominąć jego rozpakowywanie:

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

  5. Uruchamiaj ACTS z dowolnego miejsca.

    act.py -c <config> ...

  6. Po zakończeniu testów opuść środowisko wirtualne.

    deactivate

Flash urządzenia z Androidem (opcjonalnie)

Jeśli chcesz uzyskać kontrolę nad uprawnieniami systemowymi urządzenia, przeflashuj je za pomocą wersji userdebug.

Aby przeflashować urządzenie, użyj narzędzia Android Flash Tool (flash.android.com/). Więcej informacji znajdziesz w dokumentacji Android Flash Tool.

Zainstaluj SL4A (opcjonalnie, zalecane)

Jeśli używasz urządzenia z wersją userdebug, możesz uzyskać kontrolę nad uprawnieniami systemowymi za pomocą SL4A. Jeśli test nie używa SL4A na urządzeniu, możesz ustawić flagę skip_sl4a w konfiguracji ACTS, aby wyłączyć tę funkcję.

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

Aby pobrać plik APK SL4A, wykonaj instrukcje opisane w artykule Warstwa skryptów na Androida.