Cấu hình xây dựng đơn giản

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 .