Liên đoàn Thương mại là một khung thử nghiệm liên tục để chạy thử nghiệm trên thiết bị Android. Để chạy Bộ kiểm tra khả năng tương thích (CTS), trước tiên hãy đọc Tổng quan về Liên đoàn Thương mại để biết giải thích về khung kiểm tra Tradefed.
Để chạy một kế hoạch kiểm tra:
- Thiết lập Thiết bị đang được kiểm tra (DUT) theo thiết lập thiết bị Android .
- Đảm bảo rằng bạn đã cài đặt các phiên bản gần đây của cả Cầu gỡ lỗi Android (adb) và Công cụ đóng gói tài sản Android (AAPT) và thêm vị trí của các công cụ đó vào đường dẫn hệ thống trên máy của bạn. Để biết thông tin về cách cài đặt các công cụ đó, hãy xem Thiết lập CTS: ADB và AAPT.
- Tải xuống bản dựng CTS đã phát hành xuống máy chủ Linux của bạn và giải nén bản dựng vào vị trí máy chủ.
- Kết nối ít nhất một thiết bị. Để chuẩn bị DUT:
- Nhấn nút home để đặt thiết bị về màn hình chính.
- Không sử dụng DUT cho bất kỳ nhiệm vụ nào khác.
- Giữ DUT ở vị trí cố định để tránh kích hoạt hoạt động của cảm biến.
- Hướng camera của thiết bị vào một vật thể có thể lấy nét.
- Không nhấn bất kỳ phím nào trên thiết bị khi CTS đang chạy. Việc nhấn phím hoặc chạm vào màn hình của DUT sẽ cản trở quá trình chạy thử nghiệm và có thể dẫn đến thử nghiệm thất bại.
Khởi chạy tập lệnh cts-tradefed của bảng điều khiển CTS từ thư mục nơi gói CTS đã được giải nén. Trên shell dòng lệnh của máy chủ, hãy chạy:
./android-cts/tools/cts-tradefed
Chạy gói kiểm tra mặc định (chứa tất cả các gói kiểm tra):
cts-tradefed > run cts
Nếu muốn cải thiện thời gian thực hiện kiểm thử, bạn có thể phân chia các bài kiểm thử trên nhiều thiết bị. Sharding yêu cầu máy chủ kết nối ít nhất hai thiết bị, nhưng nên sử dụng sáu thiết bị trở lên để đạt hiệu quả. Khi phân chia nhiều hơn 1 thiết bị:
Đối với Android 9 trở lên, hãy sử dụng tùy chọn lệnh
--shard-count number_of_shards
Đối với Android 8.1 trở xuống, hãy sử dụng tùy chọn lệnh
--shards number_of_shards
Nếu không muốn chạy toàn bộ bộ thử nghiệm, bạn có thể chạy gói CTS mà bạn chọn từ dòng lệnh:
run cts --plan test_plan_name
Để tìm tên kế hoạch kiểm tra:
Đối với Android 7.0 trở lên, để xem danh sách các mô-đun thử nghiệm, hãy nhập
list modules
Đối với Android 6.0 trở xuống, để xem danh sách các kế hoạch kiểm tra trong kho lưu trữ, hãy nhập
list plans
Đối với Android 6.0 trở xuống, để xem danh sách các gói thử nghiệm trong kho, hãy nhập
list packages
Để biết các tùy chọn lệnh bổ sung tùy thuộc vào phiên bản CTS, hãy tham khảo tham chiếu lệnh của bàn điều khiển hoặc trong phần "trợ giúp tất cả" trong bảng điều khiển Tradefed.
Chạy nhiều phiên Thử lại cho đến khi tất cả các mô-đun kiểm tra được hoàn thành và số lỗi kiểm tra giống nhau trong hai phiên thử lại gần nhất.
Đối với Android 9 trở lên, hãy sử dụng
run retry --retry session_number --shard-count number_of_shards
Đối với Android 7.0–8.1, hãy sử dụng
run cts --retry session_number --shards number_of_shards
Để biết thêm các tùy chọn lệnh Thử lại tùy thuộc vào phiên bản CTS, hãy xem Bảng điều khiển lệnh CTS v2 .
Để hiểu chi tiết việc triển khai thử lại CTS, hãy xem Thử lại Bộ Liên đoàn Thương mại .
Chỉ chạy phiên thử lại trên các bài kiểm tra tham số hóa không thành công. Các bài kiểm tra tham số đã vượt qua sẽ không được thử lại.
Đối với Android 11 trở lên, tùy chọn lệnh thử lại sau được bật theo mặc định trong lệnh
run cts:run retry --retry
--new-parameterized-handling
Xem tiến trình kiểm tra và kết quả được báo cáo trên bảng điều khiển.
Chạy CTS bằng Trạm kiểm tra Android
Trạm thử nghiệm Android là một công cụ tự động hóa thử nghiệm mà các nhà phát triển và kỹ sư thử nghiệm Android có thể sử dụng để sử dụng giao diện người dùng để chạy các bộ thử nghiệm tiêu chuẩn. Nó hoạt động với Bộ kiểm tra tương thích Android (CTS) .
Công cụ này được cung cấp công khai thông qua Hướng dẫn sử dụng ATS và mã của nó có nguồn mở trong AOSP ( multitest_transport , tradefed_cluster ).
Chạy CTS cho các chế độ thay thế
Bản phát hành CTS 10 R4 bổ sung kế hoạch thử nghiệm cho các thiết bị có chế độ thay thế hoặc cho các thiết bị có nhiều màn hình. Thực hiện kế hoạch kiểm tra các chế độ thay thế bằng cách sử dụng run cts-foldable .
Các trường hợp kiểm thử đạt hoặc không đạt đối với chế độ màn hình thay thế sẽ được thêm giá trị từ display_mode , ví dụ: testcase1[display_mode=0] .
Trong CTS 13, API DeviceStateManager cho phép chạy các mô-đun thử nghiệm có tùy chọn cấu hình sau trên các trạng thái thiết bị khác nhau của thiết bị có thể gập lại. Việc thực hiện kiểm tra được thực hiện tự động trong CTS dựa trên trạng thái gập màn hình được xác định trong thiết bị mà không cần chạy kế hoạch kiểm tra cts-foldable .
<option name="config-descriptor:metadata" key="parameter" value="all_foldable_states" />
Kiểm tra đa thiết bị trong CTS
Android 13 trở lên hỗ trợ thử nghiệm trên nhiều thiết bị. Các thử nghiệm yêu cầu nhiều thiết bị sẽ tự động thực hiện trong quá trình chạy CTS. CTS 13 bao gồm một số thử nghiệm trên nhiều thiết bị tự động kích hoạt khi sử dụng phân đoạn. Mặc dù thử nghiệm không yêu cầu thay đổi bổ sung đối với thiết lập vật lý, nhưng virtualenv cần được cài đặt để thử nghiệm chạy chính xác. Để biết chi tiết, hãy xem Bộ đa thiết bị .
Chạy thử nghiệm trên nhiều thiết bị
Để chạy thử nghiệm nhiều thiết bị một cách độc lập, hãy sử dụng mã sau:
cts-tradefed > run cts-multidevice
Tất cả các tùy chọn thông thường đều được hỗ trợ. Để nhắm mục tiêu các thiết bị cụ thể, hãy thêm --serial <serial1> --serial <serial2> , v.v. cho số lượng thiết bị được nhắm mục tiêu.
Để tự động kích hoạt kiểm tra nhiều thiết bị, hãy sử dụng sharding, như trong --shard-count 2 .