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ữ 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 bắt buộc để thiết lập, hãy cài đặt các công cụ thiết lập Python 3 sau đây:

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 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 bằng 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 việc 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 dòng lệnh và nhập các 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 mà không cần cài đặt

Người dùng có thể chạy ACTS mà không cần cài đặt trực tiếp 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 mọi 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 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 lượt cài đặt của bạn với các lượt cài đặt ACTS khác, bạn nên cài đặt ACTS trong một môi trường ảo. Các bước sau 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ông trình được xuất bản. Để biết thêm thông tin, hãy xem bài viết Tích hợp liên tục với Android. Bạn có thể kéo tệp zip từ một bản dựng trên ci.android.com. Hãy 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. Trong ví dụ này, giả sử rằng 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ã đó.

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

    Nếu chưa có ứng dụng này, bạn có thể cài đặt virtualenv bằ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). Thao tác này đảm bảo rằng các gói mới sẽ đượ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 quá trình 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 hoàn tất quá 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 thiết bị bằng một 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 (nên dùng, không bắt buộc)

Nếu đang sử dụng một thiết bị có bản dựng userdebug, bạn có thể yêu cầu 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 chương trình kiểm thử của bạn không sử dụng SL4A trên thiết bị, thì 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 trong bài viết Scripting Layer for Android (Lớp tập lệnh dành cho Android).