Hướng dẫn ACTS nâng cao

Đây là hướng dẫn về cách chạy thử nghiệm Bộ kiểm tra Android Comms (ACTS) .

Lấy mã

Bạn có thể tìm thấy phiên bản ACTS cập nhật nhất trong kho lưu trữ Gerrit của Dự án mã nguồn mở Android (AOSP) trong /platform/tools/test/connectivity/ .

Để biết chi tiết về cách đồng bộ hóa mã, hãy xem Tải xuống nguồn và Lớp học lập trình dành cho nhà phát triển Android . Khi đồng bộ mã, hãy đồng bộ nhánh chính. Không đồng bộ hóa bản dựng được gắn thẻ.

Lưu ý khi tải ACTS, bạn không cần phải đồng bộ toàn bộ kho Android. Để chỉ đồng bộ hóa ACTS, sau khi chạy lệnh repo init , hãy chạy:

repo sync platform/tools/test/connectivity

ACTS có thể được tìm thấy trong <repo>/tools/test/connectivity/acts/ .

Thiết lập môi trường

Để đảm bảo rằng ACTS có các phần phụ thuộc cần thiết để thiết lập, hãy cài đặt các công cụ thiết lập Python 3 sau:

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

Cài đặt ACTS

Tập lệnh setup.py được tìm thấy trong <repo>/tools/test/connectivity/acts/framework sẽ cài đặt phần còn lại của các phần phụ thuộc và chính ACTS.

Để phát triển liên tục trên hoặc với ACTS, hãy chạy lệnh sau:

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

Nếu bạn chỉ muốn chạy thử nghiệm, thay vào đó hãy chạy lệnh này:

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

Xác minh cài đặt

Sau khi thiết lập, hãy đảm bảo rằng bạn có thể sử dụng act.py trong thiết bị đầu cuối của mình và nhập mô-đun ACTS bằng Python. Ví dụ:

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

Chạy không cần cài đặt

Người dùng có thể chạy ACTS mà không cần cài đặt gói trực tiếp. Bước duy nhất phải được thực hiện là sửa đổi đường dẫn Python để nhập từ <repo>/tools/test/connectivity/acts/framework . Trước khi chạy ACTS, hãy chạy setup.py install_deps để cài đặt tất cả các phần phụ thuộc cần thiết của ACTS mà không cần cài đặt ACTS. Nếu máy của bạn có phiên bản ACTS hiện có, hãy chạy sudo setup.py uninstall .

Để chạy ACTS, hãy sử dụng một trong các lệnh sau:

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

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

ACTS xuất ra các thông báo yêu cầu cờ -c và -tc . Để biết thêm thông tin, hãy xem Định cấu hình Kiểm tra ACTS .

Thiết lập ACTS trong môi trường ảo

Để tách biệt cài đặt của bạn với các cài đặt ACTS khác, bạn nên cài đặt ACTS trong môi trường ảo. Các bước sau đây giả định rằng bạn có acts_test.zip từ aosp-main trên ci.android.com hoặc có quyền truy cập trực tiếp vào nguồn.

  1. Nhận ACTS.

    Các bản dựng được xuất bản. Để biết thêm thông tin, hãy xem Tích hợp liên tục của Android . Bạn có thể kéo các tệp zip từ bản dựng trên ci.android.com . Tìm mục tiêu test_suites_x86_64 .

    Tệp acts_test.zip nằm trong tab Hiện vật. Trong ví dụ này, giả sử rằng acts_test.zip đã được tải xuống /tmp/acts_test.zip .

    Nếu bạn có quyền truy cập vào mã nguồn, bạn có thể sử dụng mã đó để thay thế.

  2. Cài đặt virtualenv trên máy của bạn.

    Nếu bạn chưa có nó, bạn có thể cài đặt virtualenv bằng cách sử dụng:

    python3 -m pip install -U --user virtualenv

  3. Tạo và kích hoạt môi trường ảo (trong /tmp/my_virtualenv cho ví dụ này). Điều này đảm bảo rằng các gói mới được cài đặt trong thư mục virtualenv .

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

  4. Cài đặt ACTS. Chạy lệnh sau.

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

    Nếu bạn có quyền truy cập trực tiếp vào mã, bạn có thể bỏ qua phần giải nén:

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

  5. Chạy ACTS từ mọi nơi.

    act.py -c <config> ...

  6. Rời khỏi môi trường ảo khi chạy thử nghiệm xong.

    deactivate

Nhấp nháy thiết bị Android (tùy chọn)

Nếu bạn muốn có được quyền kiểm soát đặc quyền của hệ thống đối với thiết bị, hãy flash thiết bị bằng bản dựng userdebug .

Để flash thiết bị, hãy sử dụng Android Flash Tool (flash.android.com/) . Để biết thêm chi tiết, hãy xem tài liệu tại Android Flash Tool .

Cài đặt SL4A (tùy chọn, khuyến nghị)

Nếu bạn đang sử dụng thiết bị có bản dựng userdebug , bạn có tùy chọn nhận quyền kiểm soát đặc quyền hệ thống đối với thiết bị của mình bằng SL4A. Nếu bài kiểm tra của bạn không sử dụng SL4A trên thiết bị, bạn có thể đặt cờ skip_sl4a trong cấu hình ACTS để tắt tính năng này.

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

Để tải APK SL4A, hãy làm theo hướng dẫn tại Lớp tập lệnh cho Android .