Sử dụng bảng điều khiển CTS v2
Đối với Android 7.0 trở lên, hãy sử dụng CTS v2.
Chọn gói
Các kế hoạch kiểm tra có sẵn bao gồm:
- cts —Chạy CTS từ bản cài đặt CTS có sẵn.
- cts-Camera - Chạy CTS-Camera từ bản cài đặt CTS có sẵn.
- cts-java — Chạy thử nghiệm Java cốt lõi từ bản cài đặt CTS có sẵn.
- cts-pdk - Chạy các thử nghiệm hữu ích trong việc xác thực bản dựng hợp nhất PDK.
- mọi thứ — Cấu hình chung cho bộ Tương thích.
Các cấu hình có sẵn khác bao gồm:
- phóng viên cơ bản - Cấu hình với các phóng viên CTS cơ bản.
- chỉ thu thập thử nghiệm —Chạy CTS từ bản cài đặt CTS có sẵn.
- common-compatibility-config - Cấu hình chung cho bộ Tương thích.
- cts-filtered-sample — Cấu hình chung cho bộ Tương thích.
- cts-known-failures — Cấu hình với các lỗi đã biết của CTS.
- cts-preconditions - Cấu hình điều kiện tiên quyết CTS.
- máy chủ - Chạy thử nghiệm dựa trên máy chủ duy nhất trên thiết bị hiện có.
- cụ — Chạy một thử nghiệm đo lường Android duy nhất trên thiết bị hiện có.
- điểm chuẩn gốc - Chạy bài kiểm tra căng thẳng gốc trên thiết bị hiện có.
- căng thẳng bản địa - Chạy bài kiểm tra căng thẳng gốc trên thiết bị hiện có.
- nạp tiền - Một thử nghiệm giả chờ các thiết bị gần như đã xả điện và giữ chúng để sạc.
- testdef — Chạy các bài kiểm tra có trong tệp test_def.xml trên thiết bị hiện có.
- util/wifi - Cấu hình tiện ích để định cấu hình Wi-Fi trên thiết bị.
- util/lau - Xóa dữ liệu người dùng trên thiết bị.
Tất cả các kế hoạch và cấu hình này có thể được thực thi bằng lệnh run cts .
Tham khảo lệnh bảng điều khiển CTS v2
Bảng này tóm tắt các lệnh của bảng điều khiển CTS v2 cho nhiều mục đích sử dụng khác nhau.
| Chủ nhà | Sự miêu tả |
|---|---|
help | Hiển thị tóm tắt các lệnh được sử dụng phổ biến nhất |
help all | Hiển thị danh sách đầy đủ các lệnh có sẵn |
version | Hiển thị phiên bản. |
exit | Thoát khỏi bảng điều khiển CTS một cách duyên dáng. Bảng điều khiển sẽ đóng khi tất cả các bài kiểm tra hiện đang chạy hoàn tất. |
extdir | Tệp tải xuống đã nén được giải nén thành Nếu bạn muốn giải nén vào thư mục hiện tại, đừng sử dụng tùy chọn |
| Chạy | Sự miêu tả |
run cts | Trong Android 10, hãy chạy gói CTS mặc định và CTS-Instant cùng nhau (nghĩa là lệnh gọi CTS đầy đủ). Đối với Android 9 trở xuống, chỉ chạy gói CTS mặc định. Sử dụng tùy chọn toàn diện này (bao gồm các điều kiện tiên quyết) để xác thực thiết bị. Xem cts.xml để biết thông tin bao gồm. Bảng điều khiển CTS có thể chấp nhận các lệnh khác trong khi đang tiến hành kiểm tra. Nếu không có thiết bị nào được kết nối, máy tính để bàn CTS (hoặc máy chủ) sẽ đợi thiết bị được kết nối trước khi bắt đầu kiểm tra. Nếu có nhiều thiết bị được kết nối, máy chủ CTS sẽ tự động chọn một thiết bị. |
run cts-instant | Đối với Android 9, hãy chạy gói CTS-Instant mặc định. |
run cts --module-parameter INSTANT_APP | Trong Android 10, hãy chạy gói CTS-Instant mặc định. |
run cts --module-parameter INSTANT_APP --module/-m test_module_name | Trong Android 10, hãy chạy mô-đun hoặc các mô-đun thử nghiệm CTS-Instant được chỉ định. |
run retry | Chỉ dành cho Android 9 trở lên. Hãy thử lại tất cả các bài kiểm tra không thành công hoặc không được thực hiện từ các phiên trước. Ví dụ: |
run cts-sim | Đối với phiên bản Android 11 trở lên. Chạy tập hợp con các bài kiểm tra trên thiết bị có thẻ SIM. |
--device-token | Đối với phiên bản Android 8.1 trở xuống. Chỉ định rằng một thiết bị nhất định có mã thông báo nhất định. Ví dụ: |
--enable-token-sharding | Chỉ dành cho Android 10 trở lên . Tự động khớp bài kiểm tra yêu cầu loại SIM tương ứng. Không cần cung cấp số sê-ri thiết bị để thực hiện các trường hợp kiểm tra liên quan đến SIM. Các SIM được hỗ trợ: |
run cts-dev | Chạy gói CTS mặc định (nghĩa là lệnh gọi CTS đầy đủ) nhưng bỏ qua các điều kiện tiên quyết để tiết kiệm thời gian chạy cho việc phát triển lặp lại một thử nghiệm mới. Điều này bỏ qua việc xác minh và thiết lập cấu hình của thiết bị, chẳng hạn như đẩy các tệp phương tiện hoặc kiểm tra kết nối Wi-Fi, như được thực hiện khi tùy chọn Bảng điều khiển CTS có thể chấp nhận các lệnh khác trong khi đang tiến hành kiểm tra. Nếu không có thiết bị nào được kết nối, máy tính để bàn CTS (hoặc máy chủ) sẽ đợi thiết bị được kết nối trước khi bắt đầu kiểm tra. Nếu có nhiều thiết bị được kết nối, máy chủ CTS sẽ tự động chọn một thiết bị. |
--subplan subplan_name | Chạy kế hoạch con được chỉ định. |
--module/-m test_module_name --test/-t test_name | Chạy mô-đun được chỉ định và kiểm tra. Ví dụ: run cts -m Gesture --test android.gesture.cts.GestureTest#testGetStrokes chạy gói, lớp hoặc thử nghiệm cụ thể. |
--retry | Thử lại tất cả các bài kiểm tra không thành công hoặc không được thực hiện từ các phiên trước. Sử dụng list results để lấy id phiên. |
--retry-type NOT_EXECUTED | Chỉ thử lại các bài kiểm tra chưa được thực hiện từ các phiên trước. Sử dụng list results để lấy id phiên. |
--shards number_of_shards | Đối với phiên bản Android 8.1 trở xuống . Phân chia một CTS chạy thành một số khối độc lập nhất định để chạy song song trên nhiều thiết bị. |
--shard-count number_of_shards | Dành cho Android 9 . Phân chia một CTS chạy thành một số khối độc lập nhất định để chạy song song trên nhiều thiết bị. |
--serial/-s deviceID | Chạy CTS trên thiết bị cụ thể. |
--include-filter "test_module_name test_name" | Chạy với các mô-đun được chỉ định hoặc các gói, lớp và trường hợp thử nghiệm. Ví dụ: run cts --include-filter "CtsCalendarcommon2TestCases android.calendarcommon2.cts.Calendarcommon2Test#testStaticLinking" bao gồm mô-đun được chỉ định.Tùy chọn lệnh này không được hỗ trợ khi chạy thử lại. |
--exclude-filter "test_module_name test_name" | Loại trừ các mô-đun hoặc gói thử nghiệm, lớp và trường hợp được chỉ định khỏi quá trình chạy. Ví dụ: run cts --exclude-filter "CtsCalendarcommon2Test android.calendarcommon2.cts.Calendarcommon2Test#testStaticLinking" loại trừ mô-đun được chỉ định. |
--log-level-display/-l log_level | Chạy với mức nhật ký được chỉ định tối thiểu được hiển thị ở STDOUT . Các giá trị hợp lệ: [ VERBOSE , DEBUG , INFO , WARN , ERROR , ASSERT ]. |
--abi abi_name | Buộc chạy thử nghiệm trên ABI nhất định, 32 hoặc 64. Theo mặc định, CTS chạy thử nghiệm một lần cho mỗi ABI mà thiết bị hỗ trợ. |
--logcat-on-failure ,--bugreport-on-failure ,--screenshoot-on-failure | Cung cấp thêm thông tin chi tiết về các lỗi và có thể giúp chẩn đoán. |
--device-token | Chỉ định một thiết bị nhất định có mã thông báo nhất định, chẳng hạn như --device-token 1a2b3c4d:sim-card . |
--skip-device-info | Bỏ qua việc thu thập thông tin về thiết bị. |
--skip-preconditions | Bỏ qua các điều kiện tiên quyết để tiết kiệm thời gian chạy cho việc phát triển lặp lại một thử nghiệm mới. Điều này bỏ qua việc xác minh và thiết lập cấu hình của thiết bị, chẳng hạn như đẩy các tệp phương tiện hoặc kiểm tra kết nối Wi-Fi. |
| Danh sách | Sự miêu tả |
list modules | Liệt kê tất cả các mô-đun thử nghiệm có sẵn trong kho. |
list plans hoặc list configs | Liệt kê tất cả các kế hoạch kiểm tra (cấu hình) có sẵn trong kho lưu trữ. |
list subplans | Liệt kê tất cả các kế hoạch con có sẵn trong kho lưu trữ. |
list invocations | Liệt kê các lệnh 'chạy' hiện đang được thực thi trên thiết bị. |
list commands | Liệt kê tất cả các lệnh 'chạy' hiện có trong hàng chờ được gán cho thiết bị. |
list results | Liệt kê các kết quả CTS hiện được lưu trữ trong kho lưu trữ. |
list devices | Liệt kê các thiết bị hiện được kết nối và trạng thái của chúng. Các thiết bị 'có sẵn' đang hoạt động, các thiết bị không hoạt động, có sẵn để chạy thử nghiệm. Thiết bị 'Không khả dụng' là thiết bị hiển thị qua adb nhưng không phản hồi với lệnh adb và sẽ không được phân bổ để kiểm tra. Thiết bị 'được phân bổ' là thiết bị hiện đang chạy thử nghiệm. |
| Bãi rác | Sự miêu tả |
dump logs | Kết xuất nhật ký giao dịch cho tất cả các yêu cầu đang chạy. |
| Thêm vào | Sự miêu tả |
add subplan --name/-n subplan_name | Tạo một kế hoạch con bắt nguồn từ phiên trước; tùy chọn này tạo ra một kế hoạch con có thể được sử dụng để chạy một tập hợp con các thử nghiệm. Tùy chọn bắt buộc duy nhất là --session . Các giá trị khác là tùy chọn nhưng khi được đưa vào thì phải có giá trị theo sau. Tùy chọn --result-type có thể lặp lại; ví dụ add subplan --session 0 --result-type passed --result-type failed là hợp lệ. |