Mỗi mô-đun thử nghiệm mới phải có một tệp cấu hình để chỉ đạo hệ thống xây dựng với siêu dữ liệu mô-đun, phụ thuộc thời gian biên dịch và hướng dẫn đóng gói. Android hiện sử dụng hệ thống xây dựng Soong để cấu hình thử nghiệm đơn giản hơn.
Soong sử dụng các tệp Blueprint hoặc .bp
, là các mô tả khai báo đơn giản giống JSON của các mô-đun để xây dựng. Định dạng này thay thế hệ thống Make-based được sử dụng trong các bản phát hành trước. Xem các tệp tham chiếu Soong trên Trang tổng quan tích hợp liên tục để biết đầy đủ chi tiết.
Để phù hợp với thử nghiệm tùy chỉnh hoặc sử dụng Bộ kiểm tra tính tương thích của Android (CTS), hãy làm theo Cấu hình kiểm tra phức tạp để thay thế.
Thí dụ
Các mục bên dưới đến từ tệp cấu hình Blueprint mẫu này: /platform_testing/tests/example/instrumentation/Android.bp
Một ảnh chụp nhanh được bao gồm ở đây để thuận tiện:
android_test {
name: "HelloWorldTests",
srcs: ["src/**/*.java"],
sdk_version: "current",
static_libs: ["android-support-test"],
certificate: "platform",
test_suites: ["device-tests"],
}
Lưu ý rằng khai báo android_test
ở đầu cho biết đây là một thử nghiệm. Ngược lại, bao gồm android_app
sẽ chỉ ra rằng đây là một gói xây dựng.
Cài đặt
Các cài đặt sau đây thu được lời giải thích:
name: "HelloWorldTests",
Cài đặt name
là bắt buộc khi loại mô-đun android_test
được chỉ định (ở đầu khối). Nó đặt tên cho mô-đun của bạn và APK kết quả sẽ được đặt tên giống nhau và có hậu tố .apk
, ví dụ: trong trường hợp này, apk thử nghiệm kết quả được đặt tên là HelloWorldTests.apk
. Ngoài ra, điều này cũng xác định tên đích tạo cho mô-đun của bạn, để bạn có thể sử dụng make [options] <HelloWorldTests>
để xây dựng mô-đun thử nghiệm của bạn và tất cả các phụ thuộc của nó.
static_libs: ["android-support-test"],
Cài đặt static_libs
hướng dẫn hệ thống xây dựng kết hợp nội dung của các mô-đun được đặt tên vào apk kết quả của mô-đun hiện tại. Điều này có nghĩa là mỗi mô-đun được đặt tên sẽ tạo ra một .jar
và nội dung của nó sẽ được sử dụng để giải quyết các tham chiếu classpath trong thời gian biên dịch, cũng như được tích hợp vào apk kết quả.
Trong ví dụ này, những thứ thường có thể hữu ích cho các thử nghiệm:
android-support-test
là bản dựng sẵn cho Thư viện hỗ trợ thử nghiệm Android, bao gồm trình chạy thử nghiệm mới AndroidJUnitRunner
: một sự thay thế cho InstrumentationTestRunner
tích hợp hiện không được dùng nữa, với sự hỗ trợ cho khung thử nghiệm JUnit4. Đọc thêm tại Thử nghiệm ứng dụng trên Android .
Nếu bạn đang xây dựng một mô-đun thiết bị đo mới, bạn phải luôn bắt đầu với thư viện android-support-test
với tư cách là người chạy thử nghiệm của bạn. Cây nguồn nền tảng cũng bao gồm các khuôn khổ thử nghiệm hữu ích khác như ub-uiautomator
, mockito-target
, easymock
và hơn thế nữa.
certificate: "platform",
Cài đặt certificate
hướng dẫn hệ thống xây dựng ký gói ứng dụng có cùng chứng chỉ với nền tảng cốt lõi. Điều này là cần thiết nếu thử nghiệm của bạn sử dụng API hoặc quyền được bảo vệ bằng chữ ký. Lưu ý rằng điều này phù hợp với thử nghiệm liên tục nền tảng, nhưng không nên được sử dụng trong các mô-đun thử nghiệm CTS. Lưu ý rằng ví dụ này chỉ sử dụng cài đặt chứng chỉ này cho mục đích minh họa: mã kiểm tra của ví dụ thực tế không cần apk kiểm tra được ký bằng chứng chỉ nền tảng đặc biệt.
Nếu bạn đang viết một thiết bị đo đạc cho thành phần của mình sống bên ngoài máy chủ hệ thống, tức là nó được đóng gói ít nhiều giống như một apk ứng dụng thông thường, ngoại trừ việc nó được tích hợp vào hình ảnh hệ thống và có thể là một ứng dụng đặc quyền, rất có thể thiết bị của bạn sẽ đang nhắm mục tiêu gói ứng dụng (xem phần bên dưới về tệp kê khai) của thành phần của bạn. Trong trường hợp này, makefile ứng dụng của bạn có thể có cài đặt certificate
riêng và mô-đun thiết bị đo của bạn phải giữ nguyên cài đặt đó. Điều này là do để nhắm mục tiêu thiết bị của bạn trên ứng dụng đang thử nghiệm, apk thử nghiệm và apk ứng dụng của bạn phải được ký bằng cùng một chứng chỉ.
Trong các trường hợp khác, bạn hoàn toàn không cần phải có cài đặt này: hệ thống xây dựng sẽ chỉ cần ký nó bằng chứng chỉ cài sẵn mặc định, dựa trên biến thể xây dựng và nó thường được gọi là dev-keys
.
test_suites: ["device-tests"],
Cài đặt test_suites
giúp kiểm tra có thể dễ dàng phát hiện bằng dây kiểm tra Trade Federation. Các bộ khác có thể được thêm vào đây chẳng hạn như CTS để có thể chia sẻ bài kiểm tra này.
${ANDROID_PRODUCT_OUT}/testcases/HelloWorldTests/HelloWorldTests.apk
Cài đặt tùy chọn
Giải thích về cài đặt tùy chọn sau:
test_config: "path/to/hello_world_test.xml"
Cài đặt test_config
hướng dẫn hệ thống xây dựng mà mục tiêu thử nghiệm của bạn cần một cấu hình cụ thể. Theo mặc định, một AndroidTest.xml
bên cạnh Android.bp
được liên kết với cấu hình.
auto_gen_config: true
Cài đặt auto_gen_config
cho biết có tự động tạo cấu hình thử nghiệm hay không. Nếu AndroidTest.xml
không tồn tại bên cạnh Android.bp
, thì thuộc tính này không cần phải được đặt thành true một cách rõ ràng.
require_root: true
Cài đặt require_root
hướng dẫn hệ thống xây dựng thêm RootTargetPreparer vào cấu hình kiểm tra được tạo tự động. Điều này đảm bảo thử nghiệm chạy với quyền root.
test_min_api_level: 29
Cài đặt test_min_api_level
hướng dẫn hệ thống xây dựng thêm MinApiLevelModuleController vào cấu hình kiểm tra được tạo tự động. Khi Trade Federation chạy cấu hình kiểm tra, kiểm tra sẽ bị bỏ qua nếu thuộc tính thiết bị của ro.product.first_api_level
< test_min_api_level
.