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

Đây là hướng dẫn về cách chạy các chương trình kiểm thử Bộ kiểm thử giao tiếp Android (ACTS).

Lấy mã

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

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

Lưu ý rằng khi tải ACTS xuống, bạn không cần đồng bộ hoá toàn bộ kho lưu trữ Android. Để chỉ đồng bộ hoá ACTS, sau khi chạy lệnh repo init, hãy chạy:

repo sync platform/tools/test/connectivity

Bạn có thể tìm thấy ACTS trong <repo>/tools/test/connectivity/acts/.

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

Để đảm bảo 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ó trong <repo>/tools/test/connectivity/acts/framework sẽ cài đặt phần phụ thuộc còn lại 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 kiểm thử, hãy chạy lệnh sau:

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

Xác minh quá trình 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 và nhập các mô-đun ACTS trong 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 mà không cần cài đặt

Người dùng có thể chạy ACTS mà không cần trực tiếp cài đặt gói. Bước duy nhất bạn phải 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 bắt buộc của ACTS mà không cần cài đặt ACTS. Nếu máy đang có phiên bản ACTS, 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 sẽ 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 phần Định cấu hình kiểm thử ACTS.

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

Để tách biệt quá trình cài đặt của bạn với các quá trình 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.

    Bản dựng được phát hành. Để biết thêm thông tin, hãy xem phần Tích hợp liên tục trên Android. Bạn có thể lấy tệp zip từ mộ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 thẻ Cấu phần phần mềm. Đối với ví dụ này, giả sử acts_test.zip đã được tải xuống /tmp/acts_test.zip.

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

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

    Nếu chưa có, 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 có quyền truy cập trực tiếp vào mã, bạn có thể bỏ qua bước giải nén:

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

  5. Chạy ACTS từ bất cứ đâu.

    act.py -c <config> ...

  6. Rời khỏi môi trường ảo khi chạy xong các chương trình kiểm thử.

    deactivate

Cài đặt ROM thiết bị Android (không bắt buộc)

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

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

Cài đặt SL4A (không bắt buộc, nhưng nên dùng)

Nếu đang sử dụng thiết bị có bản dựng userdebug, bạn có thể chọn kiểm soát đặc quyền hệ thống của thiết bị bằng SL4A. Nếu kiểm thử 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 tệp APK SL4A, hãy làm theo hướng dẫn tại Lớp tập lệnh cho Android.