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

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_CARDSECURE_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ể.
--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.

--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ị.
--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ệ.