Mỗi mô-đun thử nghiệm mới phải có tệp cấu hình để điều khiển hệ thống xây dựng bằng siêu dữ liệu mô-đun, các phần phụ thuộc tại thời điểm 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 như JSON về các mô-đun cần xây dựng. Định dạng này thay thế hệ thống dựa trên Make được sử dụng trong các bản phát hành trước. Xem tệp tham chiếu Soong trên Bảng điều khiển tích hợp liên tục để biết chi tiết đầy đủ.
Để phù hợp với thử nghiệm tùy chỉnh hoặc sử dụng Bộ thử nghiệm tương thích Android (CTS), thay vào đó hãy làm theo Cấu hình thử nghiệm phức tạp .
Ví dụ
Các mục bên dưới lấy từ tệp cấu hình Blueprint ví dụ 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: ["androidx.test.runner"],
certificate: "platform",
test_suites: ["device-tests"],
}
Lưu ý khai báo android_test
ở đầu cho biết đây là bản thử nghiệm. Việc bao gồm android_app
ngược lại sẽ chỉ ra rằng đây thay vào đó là gói xây dựng.
Cài đặt
Các cài đặt sau đây thu hút lời giải thích:
name: "HelloWorldTests",
Cần phải đặt name
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 mục tiêu make 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 mình và tất cả các phần phụ thuộc của nó.
static_libs: ["androidx.test.runner"],
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 dự kiến sẽ tạo ra một tệp .jar
và nội dung của nó sẽ được sử dụng để giải quyết các tham chiếu đường dẫn lớp trong thời gian biên dịch, cũng như được tích hợp vào apk kết quả.
Mô-đun androidx.test.runner
là mô-đun dựng sẵn cho Thư viện AndroidX Test Runner, bao gồm trình chạy thử nghiệm AndroidJUnitRunner
. AndroidJUnitRunner
hỗ trợ khung thử nghiệm JUnit4 và thay thế InstrumentationTestRunner
trong Android 10. Đọc thêm về thử nghiệm ứng dụng Android tại Thử nghiệm ứng dụng trên Android .
Nếu đang xây dựng một mô-đun thiết bị đo lường mới, bạn phải luôn bắt đầu với thư viện androidx.test.runner
làm người chạy thử nghiệm của mình. Cây nguồn nền tảng cũng bao gồm các khung thử nghiệm hữu ích khác như ub-uiautomator
, mockito-target
, easymock
, v.v.
certificate: "platform",
Cài đặt certificate
chỉ 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 quyền hoặc API được bảo vệ bằng chữ ký. Lưu ý rằng điều này phù hợp cho thử nghiệm liên tục nền tảng, nhưng không nên sử dụng trong 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ụ không thực sự cần apk thử nghiệm được ký bằng chứng chỉ nền tảng đặc biệt.
Nếu bạn đang viết một công cụ đo lường cho thành phần nằm bên ngoài máy chủ hệ thống, nghĩa 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ể công cụ đo lường 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ề bảng kê khai) của thành phần của bạn. Trong trường hợp này, tệp tạo ứng dụng của bạn có thể có cài đặt certificate
riêng và mô-đun công cụ của bạn sẽ 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 vào ứng dụng đang được thử nghiệm, gói ứng dụng và gói ứng dụng thử nghiệm 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ỉ ký nó bằng chứng chỉ tích hợp mặc định, dựa trên biến thể bản dựng và nó thường được gọi là dev-keys
.
test_suites: ["device-tests"],
Cài đặt test_suites
giúp dễ dàng phát hiện bài kiểm tra bằng khai thác kiểm tra của Liên đoàn Thương mại. Các bộ khác có thể được thêm vào đây như CTS để bài kiểm tra này có thể được chia sẻ.
${ANDROID_PRODUCT_OUT}/testcases/HelloWorldTests/HelloWorldTests.apk
Cài đặt tùy chọn
Giải thích về các cài đặt tùy chọn sau đây:
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, 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 kiểm tra 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 thử nghiệm được tạo tự động. Điều này đảm bảo quá trình kiểm thử sẽ 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 thử nghiệm được tạo tự động. Khi Liên đoàn Thương mại chạy cấu hình thử nghiệm, thử nghiệm sẽ bị bỏ qua nếu thuộc tính thiết bị của ro.product.first_api_level
< test_min_api_level
.