Kể từ ngày 27 tháng 3 năm 2025, bạn nên sử dụng android-latest-release thay vì aosp-main để xây dựng và đóng góp cho AOSP. Để biết thêm thông tin, hãy xem phần Thay đổi đối với AOSP.

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ộ sưu tập để sắp xếp ngăn nắp các trang Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.

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

Sau đây là các kế hoạch kiểm thử hiện có:

cts – Chạy CTS từ một bản cài đặt CTS có sẵn.
cts-camera – Chạy CTS-camera từ một quá trình cài đặt CTS hiện có.
cts-java – Chạy các chương trình kiểm thử Core Java từ một bản cài đặt CTS hiện có.
cts-pdk – Chạy các kiểm thử hữu ích để xác thực bản dựng hợp nhất PDK.
everything – Cấu hình chung cho các bộ Khả năng tương thích.

Các cấu hình khác có sẵn bao gồm:

basic-reporters – Cấu hình với trình báo cáo CTS cơ bản.
collect-tests-only – Chạy CTS từ một bản cài đặt CTS hiện có.
common-compatibility-config – Cấu hình chung cho các bộ Khả năng tương thích.
cts-filtered-sample – Cấu hình phổ biến cho các bộ Khả năng tương thích.
cts-known-failures – Cấu hình có các lỗi đã biết của CTS.
cts-preconditions – Cấu hình điều kiện tiên quyết của CTS.
máy chủ – Chạy một kiểm thử dựa trên máy chủ trên một thiết bị hiện có.
instrument (thiết bị đo lường) – Chạy một kiểm thử đo lường Android trên một thiết bị hiện có.
native-benchmark – Chạy kiểm thử căng thẳng gốc trên một thiết bị hiện có.
native-stress – Chạy kiểm thử căng thẳng gốc trên một thiết bị hiện có.
recharge (sạc lại) – Một thử nghiệm giả mạo chờ các thiết bị gần hết pin và giữ lại để sạc.
testdef – Chạy các chương trình kiểm thử có 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 kế hoạch 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 của bảng điều khiển CTS v2 cho nhiều mục đích sử dụng.

Máy chủ	Mô tả
`help`	Hiển thị thông tin tóm tắt về các lệnh thường dùng 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 bảng điều khiển CTS một cách mượt mà. Bảng điều khiển sẽ đóng khi tất cả các chương trình kiểm thử đang chạy hoàn tất.
`extdir`	Tệp tải xuống được nén được giải nén thành `extdir`. Nếu bạn muốn loại bỏ đầu ra 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 cùng lúc kế hoạch CTS mặc định và CTS-Instant (tức là lệnh gọi CTS đầy đủ). Đối với Android 9 trở xuống, chỉ chạy kế hoạch CTS mặc định. Sử dụng tuỳ chọ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ị. Xem cts.xml để biết nội dung 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 khi đang 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ủ) CTS sẽ đợi một thiết bị được kết nối trước khi bắt đầu kiểm thử. 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 kế hoạch CTS-Instant mặc định.
`run cts --module-parameter INSTANT_APP`	Trong Android 10, hãy chạy kế hoạch 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 mô-đun kiểm thử CTS-Instant được chỉ định.
`run retry`	Chỉ dành cho Android 9 trở lên. Thử lại tất cả các bài 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. Không được phép dùng `run cts --retry` cho Android 9 trở lên.
`run cts-sim`	Đối với các phiên bản Android 11 trở lên. Chạy một tập hợp con các chương trình 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ị nhất định có mã thông báo nhất định. 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 quy trình kiểm thử yêu cầu loại SIM tương ứng. Bạn 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. Các loại 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 quá trình phát triển lặp lại của một chương trình kiểm thử mới. Thao tác này bỏ qua quá trình xác minh và thiết lập cấu hình của thiết bị, chẳng hạn như đẩy tệp phương tiện hoặc kiểm tra kết nối Wi-Fi, như được thực hiện khi sử dụng tuỳ chọn `--skip-preconditions`. Lệnh 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. Công cụ này cũng chỉ chạy các bài kiểm thử trên một ABI duy nhất. Để xác thực thiết bị, hãy tránh tối ưu hoá này và đưa vào tất cả các điều kiện tiên quyết và quy trình kiểm tra. Xem cts-dev.xml để biết các trường hợp ngoại lệ. Bảng điều khiển CTS có thể chấp nhận các lệnh khác trong khi đang 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ủ) CTS sẽ đợi một thiết bị được kết nối trước khi bắt đầu kiểm thử. 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 phụ đã chỉ định.
`--module/-m test_module_name --test/-t test_name`	Chạy mô-đun và kiểm thử được chỉ định. Ví dụ: `run cts -m Gesture --test android.gesture.cts.GestureTest#testGetStrokes` chạy một gói, lớp hoặc kiểm thử cụ thể. Thận trọng: Không sử dụng tuỳ chọn này khi sử dụng tuỳ chọn `--include-filter`.
`--retry`	Thử lại tất cả các bài 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 bài 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 một quá trình chạy CTS thành một số lượng mảnh độc lập nhất định để chạy song song trên nhiều thiết bị.
`--shard-count number_of_shards`	Đối với Android 9. Phân đoạn một lần chạy CTS thành một số phân đoạn độ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 bằng các mô-đun, gói kiểm thử, lớp và trường hợp được chỉ định. Ví dụ: `run cts --include-filter "CtsCalendarcommon2TestCases android.calendarcommon2.cts.Calendarcommon2Test#testStaticLinking"` bao gồm mô-đun đã chỉ định. Tuỳ chọn lệnh này không được hỗ trợ khi chạy lại. Thận trọng: Đừng sử dụng tuỳ chọn này khi sử dụng tuỳ chọn `--module/-m`.
`--exclude-filter "test_module_name test_name"`	Loại trừ các mô-đun, 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 đã chỉ định.
`--log-level-display/-l log_level`	Chạy với cấp độ nhật ký tối thiểu được chỉ định 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 một lần kiểm thử cho mỗi ABI mà thiết bị hỗ trợ.
`--logcat-on-failure`, `--bugreport-on-failure`, `--screenshoot-on-failure`	Cho thấy rõ hơn 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ị. Thận trọng: Đừng sử dụng tuỳ chọn này khi chạy CTS để được phê duyệt.
`--skip-preconditions`	Bỏ qua các điều kiện tiên quyết để tiết kiệm thời gian chạy cho quá trình phát triển lặp lại của một kiểm thử mới. Thao tác này bỏ qua quy trình xác minh và thiết lập cấu hình của thiết bị, chẳng hạn như đẩy tệp phương tiện hoặc kiểm tra kết nối Wi-Fi.
Danh sách	Mô tả
`list modules`	Liệt kê tất cả các mô-đun kiểm thử có sẵn trong kho lưu trữ.
`list plans` hoặc `list configs`	Liệt kê tất cả các kế hoạch kiểm thử (cấu hình) có sẵn trong kho lưu trữ.
`list subplans`	Liệt kê tất cả kế hoạch phụ 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ả lệnh chạy hiện đang trong hàng đợi chờ được 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 đang kết nối và trạng thái của các thiết bị đó. Thiết bị có sẵn là những thiết bị đang hoạt động, thiết bị rảnh, có thể chạy kiểm thử. Thiết bị Không sử dụng được là những thiết bị hiển thị thông qua adb nhưng không phản hồi các lệnh adb và sẽ không được phân bổ cho các chương trình kiểm thử. Thiết bị Đã phân bổ là những thiết bị hiện đang chạy kiểm thử.
Dump	Mô tả
`dump logs`	Kết xuất nhật ký tradefed cho tất 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 một kế hoạch phụ bắt nguồn từ phiên trước; tuỳ chọn này sẽ tạo một kế hoạch phụ có thể dùng để chạy một tập hợp con kiểm thử. Tuỳ chọn bắt buộc duy nhất là `--session`. Các thuộc tính khác là không bắt buộc, nhưng khi được đưa vào, phải theo sau là một giá trị. 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ệ.