Расширенное руководство по ACTS

Это руководство по запуску тестов Android Comms Test Suite (ACTS) .

Получить код

Самую последнюю версию ACTS можно найти в репозитории Gerrit Android Open Source Project (AOSP) в /platform/tools/test/connectivity/ .

Подробные сведения о синхронизации кода см. в разделах «Загрузка исходного кода» и «Код для разработчиков Android» . При синхронизации кода синхронизируйте основную ветку. Не синхронизируйте сборку с тегами.

Обратите внимание: при загрузке ACTS вам не нужно синхронизировать весь репозиторий Android. Чтобы синхронизировать только ACTS, после запуска команды repo init выполните:

repo sync platform/tools/test/connectivity

ACTS можно найти в <repo>/tools/test/connectivity/acts/ .

Настройка среды

Чтобы убедиться, что ACTS имеет необходимые зависимости для установки, установите следующие инструменты установки 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

Установить АКТС

Сценарий setup.py найденный в <repo>/tools/test/connectivity/acts/framework устанавливает остальные зависимости и сам ACTS.

Для непрерывной разработки в ACTS или с его помощью выполните следующую команду:

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

Если вы хотите запускать только тесты, вместо этого запустите эту команду:

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

Проверка установки

После установки убедитесь, что вы можете использовать act.py в своем терминале и импортировать модули ACTS в Python. Например:

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

Запустить без установки

Пользователи могут запускать ACTS без установки пакета напрямую. Единственный шаг, который необходимо выполнить, — это изменить путь Python для импорта из <repo>/tools/test/connectivity/acts/framework . Перед запуском ACTS запустите setup.py install_deps , чтобы установить все необходимые зависимости с помощью ACTS без установки ACTS. Если на вашем компьютере установлена ​​существующая версия ACTS, запустите sudo setup.py uninstall .

Чтобы запустить ACTS, используйте одну из следующих команд: 

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

ACTS выводит сообщения с запросом флагов -c и -tc . Дополнительные сведения см. в разделе Настройка тестов ACTS .

Настройка ACTS в виртуальной среде

Чтобы изолировать вашу установку от других установок ACTS, вам следует установить ACTS в виртуальной среде. Следующие шаги предполагают, что у вас есть acts_test.zip из aosp-main на ci.android.com или у вас есть прямой доступ к исходному коду.

  1. Получите АКТЫ.

    Сборки опубликованы. Дополнительные сведения см. в разделе Непрерывная интеграция Android . Вы можете извлечь zip-файлы из сборки на ci.android.com . Найдите цель test_suites_x86_64 .

    Файл acts_test.zip находится на вкладке «Артефакты». В этом примере предположим, что acts_test.zip загружен в /tmp/acts_test.zip .

    Если у вас есть доступ к исходному коду, вы можете использовать его.

  2. Установите virtualenv на свой компьютер.

    Если у вас его еще нет, вы можете установить virtualenv используя:

    python3 -m pip install -U --user virtualenv

  3. Создайте и активируйте виртуальную среду (в данном примере в /tmp/my_virtualenv ). Это гарантирует, что новые пакеты будут установлены в каталог virtualenv .

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

  4. Установите АКТС. Выполните следующую команду. 

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

    Если у вас есть доступ к коду напрямую, вы можете пропустить распаковку: 

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

  5. Запускайте ACTS из любого места. 

    act.py -c <config> ...

  6. Покиньте виртуальную среду после завершения тестов. 

    deactivate

Прошить Android-устройство (необязательно)

Если вы хотите получить системный привилегированный контроль над устройством, прошейте устройство сборкой userdebug .

Для прошивки устройства используйте Android Flash Tool (flash.android.com/) . Более подробную информацию можно найти в документации Android Flash Tool .

Установите SL4A (необязательно, рекомендуется)

Если вы используете устройство со сборкой userdebug , у вас есть возможность получить контроль над системными привилегиями вашего устройства с помощью SL4A. Если ваш тест не использует SL4A на устройстве, вы можете установить флаг skip_sl4a в конфигурации ACTS, чтобы отключить эту функцию. 

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

Чтобы получить APK-файл SL4A, следуйте инструкциям на странице Scripting Layer для Android .