高級 ACTS 指南

這是有關如何運行Android Comms Test Suite (ACTS)測試的指南。

取得程式碼

最新版本的 ACTS 可以在/platform/tools/test/connectivity/中的 Android 開源專案 (AOSP) Gerrit 儲存庫中找到。

有關如何同步程式碼的詳細信息，請參閱下載原始程式碼和Android 開發者 Codelab 。同步程式碼時，同步主分支。不要同步標記的建置。

請注意，下載 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

安裝 ACTS

<repo>/tools/test/connectivity/acts/framework中的setup.py腳本會安裝其餘依賴項和 ACTS 本身。

若要在 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 ，並在 Python 中匯入 ACTS 模組。例如：

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。以下步驟假設您有ci.android.com上aosp-main的acts_test.zip或可以直接存取原始程式碼。

  1. 獲取行動。

    版本已發布。有關更多信息，請參閱Android 持續整合。您可以從ci.android.com上的建置中提取 zip 檔案。找出test_suites_x86_64目標。

    acts_test.zip檔案位於 Artifacts 標籤下。對於此範例，假設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. 安裝 ACTS。運行以下命令。

    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，您可以在 ACTS 配置中設定skip_sl4a標誌來停用該功能。

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

若要取得 SL4A APK，請依照Android 腳本層中的說明進行操作。