Google cam kết thúc đẩy công bằng chủng tộc cho Cộng đồng người da đen. Xem cách thực hiện.

Trang này được dịch bởi Cloud Translation API.

Bảng điều khiển lệnh CTS v2

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 gói kiểm thử hiện có bao gồm:

cts – Chạy CTS từ một bản cài đặt CTS có sẵn.
cts-camera – Chạy camera CTS từ một bản cài đặt CTS có sẵn.
cts-java – Chạy các bài kiểm thử Java cốt lõi từ một bản cài đặt CTS có sẵn.
cts- Kotlin – Chạy các chương trình kiểm thử hữu ích cho 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:

người báo cáo cơ bản – Cấu hình với trình báo cáo CTS cơ bản.
collect-tests-only (chỉ kiểm thử thu thập) – Chạy CTS từ một bản cài đặt CTS có sẵn.
common-compatibility-config – Cấu hình phổ biến cho các bộ công cụ tương thích.
cts-filters-sample – Cấu hình phổ biến cho bộ tương thích.
cts-known-failures – Cấu hình có các lỗi đã biết CTS.
cts-preconditions – Cấu hình điều kiện tiên quyết CTS.
host – Chạy một chương trình kiểm thử dựa trên máy chủ trên một thiết bị hiện có.
Instrument (thiết bị) – Chạy một chương trình kiểm thử đo lường Android trên một thiết bị hiện có.
native-benchmark – Chạy quy trình kiểm thử nghiêm ngặt gốc trên một thiết bị hiện có.
native-stress (tình trạng căng thẳng bản địa) – Chạy quy trình kiểm tra mức độ căng thẳng riêng trên một thiết bị hiện có.
sạc pin – Một bài kiểm tra giả chờ thiết bị gần hết pin và giữ thiết bị để sạc.
testdef – Chạy các chương trình kiểm thử trong tệp test_def.xml trên một 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/wipe – Xoá dữ liệu người dùng trên thiết bị.

Bạn có thể thực thi tất cả các gói và cấu hình này bằng lệnh run cts.

Tài liệu tham khảo về lệnh trong bảng điều khiển CTS v2

Bảng này tóm tắt các lệnh trong bảng điều khiển CTS v2 cho mục đích sử dụng khác nhau.

Máy chủ	Mô tả
`help`	Hiển thị bản tóm tắt các lệnh thường dùng nhất
`help all`	Hiển thị danh sách đầy đủ các lệnh hiện có
`version`	Hiển thị phiên bản.
`exit`	Thoát khỏi bảng điều khiển CTS một cách nhẹ nhàng. Bảng điều khiển đóng khi tất cả các thử nghiệm 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 `extdir`. Nếu bạn muốn loại bỏ kết quả tăng cường, hãy sử dụng tuỳ chọn `-q`: `unzip -q android-cts-9.0_r15-linux_x86-arm.zip -d extdir` Nếu bạn muốn giải nén vào thư mục hiện tại, đừng sử dụng tuỳ chọn `-d`, chỉ cần chạy: `unzip -q android-cts-9.0_r15-linux_x86-arm.zip`
Chạy	Mô tả
`run cts`	Trong Android 10, hãy chạy gói CTS mặc định và CTS- Instant với nhau (tức là lệnh gọi CTS đầy đủ). Đối với Android 9 trở xuống, hãy chạy chế độ mặc định Chỉ dành cho gói CTS. Sử dụng phương án toàn diện này (bao gồm cả các điều kiện tiên quyết) để xác thực thiết bị. Hãy xem cts.xml để biết các yêu cầu cần đưa vào. Bảng điều khiển CTS có thể chấp nhận các lệnh khác trong quá trình kiểm thử. Nếu không có thiết bị nào được kết nối, máy tính (hoặc máy chủ lưu trữ CTS) sẽ đợi để kết nối một thiết bị trước khi bắt đầu thử nghiệm. Nếu có nhiều hơn một thiết bị đã được kết nối, thì máy chủ lưu trữ CTS sẽ chọn một thiết bị tự động.
`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 kiểm thử CTS- Instant được chỉ định hoặc mô-đun.
`run retry`	Chỉ dành cho Android 9 trở lên. Thử lại tất cả các chương trình kiểm thử không thành công hoặc không được thực thi từ các phiên trước. Ví dụ: `run retry --retry -s` hoặc `run retry --retry --shard-count` với tính năng phân đoạn TF. `run cts --retry` không được phép sử dụng trên Android 9 trở lên.
`run cts-sim`	Đối với phiên bản Android 11 trở lên. Chạy một tập hợp con các bài kiểm thử trên một 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ị cụ thể có mã thông báo. Ví dụ: `--device-token 1a2b3c4d:sim-card`.
`--enable-token-sharding`	Chỉ dành cho Android 10 trở lên. Tự động khớp với thử nghiệm yêu cầu loại SIM tương ứng. Không cần cung cấp số sê-ri của thiết bị để thực thi Các trường hợp kiểm thử liên quan đến SIM. SIM được hỗ trợ: `SIM_CARD`, `UICC_SIM_CARD`, và `SECURE_ELEMENT_SIM_CARD`.
`run cts-dev`	Chạy kế hoạch CTS mặc định (tức 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. Thao tác này sẽ bỏ qua bước xác minh và thiết lập thông tin đăng nhập cấu hình, chẳng hạn như đẩy các tệp đa phương tiện hoặc kiểm tra Wi-Fi kết nối, như được thực hiện khi tuỳ chọn `--skip-preconditions` được sử dụng. Chiến dịch này cũng bỏ qua việc thu thập thông tin thiết bị và tất cả trình kiểm tra trạng thái hệ thống. Điều này cũng chỉ chạy kiểm thử trên một ABI. Để xác thực thiết bị, hãy tránh tối ưu hoá này và bao gồm mọi điều kiện tiên quyết và bước kiểm tra. Xem cts-dev.xml để biết các trường hợp loại trừ. Bảng điều khiển CTS có thể chấp nhận các lệnh khác trong quá trình kiểm thử. Nếu không có thiết bị nào được kết nối, máy tính (hoặc máy chủ lưu trữ CTS) sẽ đợi để kết nối một thiết bị trước khi bắt đầu thử nghiệm. Nếu có nhiều hơn một thiết bị đã được kết nối, thì máy chủ lưu trữ CTS sẽ chọn một thiết bị tự động.
`--subplan subplan_name`	Chạy kế hoạch phụ được chỉ định.
`--module/-m test_module_name --test/-t test_name`	Chạy mô-đun đã chỉ định và kiểm thử. Ví dụ: `run cts -m Gesture --test android.gesture.cts.GestureTest#testGetStrokes` chạy gói, lớp hoặc bài kiểm thử cụ thể. Thận trọng: Không sử dụng tuỳ chọn này khi dùng tuỳ chọn `--include-filter`.
`--retry`	Thử lại tất cả các lượt kiểm thử không thành công hoặc không được thực thi từ các phiên trước đó. Sử dụng `list results` để lấy mã phiên.
`--retry-type NOT_EXECUTED`	Chỉ thử lại các chương trình kiểm thử không được thực thi từ các phiên trước đó. Sử dụng `list results` để lấy mã phiên.
`--shards number_of_shards`	Đối với phiên bản Android 8.1 trở xuống. Phân đoạn CTS chạy vào số lượng phân đoạn độc lập nhất định để chạy trên nhiều thiết bị song song.
`--shard-count number_of_shards`	Đối với Android 9. Phân đoạn CTS gặp phải số lượng các đoạn độc lập để 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 kiểm thử gói, lớp và trường hợp. Ví dụ: `run cts --include-filter "CtsCalendarcommon2TestCases android.calendarcommon2.cts.Calendarcommon2Test#testStaticLinking"` bao gồm mô-đun được chỉ định. Tuỳ chọn lệnh này không được hỗ trợ khi chạy thử lại. Thận trọng: Không sử dụng tuỳ chọn này khi dùng tuỳ chọn `--module/-m`.
`--exclude-filter "test_module_name test_name"`	Loại trừ các mô-đun hoặc gói kiểm thử, 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 cấp độ nhật ký tối thiểu được chỉ định được hiển thị cho `STDOUT`. Giá trị hợp lệ: [`VERBOSE`, `DEBUG`, `INFO`, `WARN` `ERROR`, `ASSERT`].
`--abi abi_name`	Buộc kiểm thử chạy trên ABI đã cho, 32 hoặc 64. Theo mặc định, CTS chạy kiểm thử một lần cho mỗi ABI mà thiết bị hỗ trợ.
`--logcat-on-failure`, `--bugreport-on-failure`, `--screenshoot-on-failure`	Giúp bạn hiểu rõ hơn về các lỗi và có thể giúp đưa ra thông tin chẩn đoán.
`--device-token`	Chỉ định một thiết bị cụ thể có mã thông báo nhất định, chẳng hạn như `--device-token 1a2b3c4d:sim-card`.
`--skip-device-info`	Bỏ qua hoạt động thu thập thông tin về thiết bị. Thận trọng: Không sử dụng tuỳ chọn này khi chạy CTS để phê duyệt.
`--skip-preconditions`	Bỏ qua đ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 của thử nghiệm mới. Thao tác này sẽ bỏ qua bước xác minh và thiết lập thông tin đăng nhập cấu hình, chẳng hạn như đẩy các tệp đa phương tiện hoặc kiểm tra Wi-Fi kết nối.
Danh sách	Mô tả
`list modules`	Liệt kê tất cả mô-đun kiểm thử hiện có trong kho lưu trữ.
`list plans` hoặc `list configs`	Liệt kê tất cả kế hoạch kiểm thử (cấu hình) hiện có trong kho lưu trữ.
`list subplans`	Liệt kê tất cả kế hoạch con có sẵn trong kho lưu trữ.
`list invocations`	Liệt kê các lệnh run hiện đang được thực thi trên thiết bị.
`list commands`	Liệt kê tất cả lệnh chạy hiện có trong hàng đợi đang chờ chỉ định 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 các thiết bị đó. Các thiết bị có sẵn đang hoạt động, ở trạng thái rảnh, có thể chạy thử nghiệm. Thiết bị không có sẵn là các thiết bị hiển thị qua adb nhưng không phản hồi với adb và sẽ không được phân bổ cho các lượt kiểm thử. Thiết bị được phân bổ là các thiết bị hiện đang chạy kiểm thử.
Dump	Mô tả
`dump logs`	Kết xuất nhật ký được trao đổi cho tất cả các lệnh gọi đang chạy.
Thêm	Mô tả
`add subplan --name/-n subplan_name --result-type [passed \| failed \| not_executed] [--session session_id]`	Tạo kế hoạch phụ từ phiên trước đó; tùy chọn này tạo ra một kế hoạch phụ có thể dùng để chạy một tập hợp con kiểm thử cụ thể. Gói duy nhất lựa chọn bắt buộc là `--session`. Một số khác là không bắt buộc, nhưng khi phải có một giá trị theo sau. Chiến lược phát hành đĩa đơn Tuỳ 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ệ.