Trang này được dịch bởi Cloud Translation API.

Quy tắc Android

Quy tắc

android_binary
aar_import
android_library
android_instrumentation_test
android_local_test
android_device
android_ndk_repository
android_sdk_repository

android_binary

android_binary(name, deps, srcs, assets, assets_dir, compatible_with, crunch_png, custom_package, debug_key, debug_signing_keys, debug_signing_lineage_file, densities, deprecation, dex_shards, dexopts, distribs, enable_data_binding, exec_compatible_with, exec_properties, features, incremental_dexing, instruments, javacopts, key_rotation_min_sdk, licenses, main_dex_list, main_dex_list_opts, main_dex_proguard_specs, manifest, manifest_values, multidex, nocompress_extensions, package_id, plugins, proguard_apply_dictionary, proguard_apply_mapping, proguard_generate_mapping, proguard_specs, resource_configuration_filters, resource_files, restricted_to, shrink_resources, tags, target_compatible_with, testonly, visibility)

Tạo các tệp gói ứng dụng Android (.apk).

Các mục tiêu đầu ra ngầm ẩn

name.apk: Bạn có thể dùng một tệp gói ứng dụng Android đã ký bằng các khoá gỡ lỗi và zipaligned để phát triển và gỡ lỗi ứng dụng. Bạn không thể phát hành ứng dụng của mình khi được ký bằng khoá gỡ lỗi.
name_unsigned.apk: Một phiên bản chưa ký của tệp trên, có thể được ký bằng các khoá phát hành trước khi phát hành công khai.
name_deploy.jar: Một tệp lưu trữ Java có chứa đóng bắc cầu của mục tiêu này.
Tệp triển khai chứa tất cả các lớp mà một trình tải lớp sẽ tìm thấy từ đầu đến cuối trong đường dẫn lớp thời gian chạy của mục tiêu này.
name_proguard.jar: Một kho lưu trữ Java chứa kết quả của việc chạy ProGuard trên name_deploy.jar. Kết quả này chỉ được tạo nếu thuộc tính proguard_specs được chỉ định.
name_proguard.map: Kết quả về tệp ánh xạ khi chạy ProGuard trên name_deploy.jar. Kết quả này chỉ được tạo nếu bạn chỉ định thuộc tính proguard_specs và đặt proguard_generate_mapping hoặc shrink_resources.

Ví dụ

Bạn có thể xem ví dụ về các quy tắc của Android trong thư mục examples/android của cây nguồn Bazel.

Đối số

Thuộc tính
`name`	Tên; bắt buộc Tên duy nhất cho mục tiêu này.
`deps`	Danh sách nhãn; mặc định là `[]` Danh sách các thư viện khác được liên kết đến mục tiêu nhị phân. Các loại thư viện được phép là: `android_library`, `java_library` có quy tắc ràng buộc `android` và `cc_library` gói hoặc tạo thư viện gốc `.so` cho nền tảng mục tiêu của Android.
`srcs`	Danh sách nhãn; mặc định là `[]` Danh sách tệp nguồn được xử lý để tạo mục tiêu. Hệ thống biên dịch các tệp `srcs` thuộc loại `.java`. Để dễ đọc, bạn không nên đưa tên của tệp nguồn `.java` đã tạo vào `srcs`. Thay vào đó, hãy đặt tên quy tắc phụ thuộc vào `srcs`, như mô tả dưới đây. Tệp `srcs` thuộc loại `.srcjar` được giải nén và biên dịch. (Cách này rất hữu ích nếu bạn cần tạo một tập hợp các tệp .java bằng gen quy tắc hoặc tiện ích bản dựng.)
`assets`	Danh sách nhãn; mặc định là `[]` Danh sách tài sản cần đóng gói. Đây thường là `glob` của mọi tệp trong thư mục `assets`. Bạn cũng có thể tham chiếu các quy tắc khác (mọi quy tắc tạo ra tệp) hoặc tệp đã xuất trong các gói khác, miễn là tất cả các tệp đó đều nằm trong thư mục `assets_dir` trong gói tương ứng.
`assets_dir`	Chuỗi; giá trị mặc định là `""` Chuỗi cung cấp đường dẫn đến các tệp trong `assets`. Cặp `assets` và `assets_dir` mô tả tài sản đóng gói và cả hai đều phải được cung cấp hoặc không cung cấp thuộc tính nào.
`crunch_png`	Boolean; giá trị mặc định là `True` Xử lý PNG (hoặc không nén). Hoạt động này độc lập với quá trình xử lý 9-patch, vốn luôn được thực hiện. Đây là giải pháp không dùng nữa đối với lỗi aapt đã được khắc phục trong aapt2.
`custom_package`	Chuỗi; giá trị mặc định là `""` Gói Java mà nguồn java sẽ được tạo. Theo mặc định, gói này được dự đoán từ thư mục có chứa tệp BUILD chứa quy tắc. Bạn có thể chỉ định một gói khác nhưng bạn không nên làm như vậy vì việc này có thể gây ra xung đột đường dẫn lớp với các thư viện khác sẽ chỉ được phát hiện trong thời gian chạy.
`debug_key`	Nhãn; mặc định là `"@bazel_tools//tools/android:debug_keystore"` Tệp chứa kho khoá gỡ lỗi được dùng để ký tệp APK gỡ lỗi. Thông thường, bạn không muốn sử dụng một khoá khác với khoá mặc định, vì vậy bạn nên bỏ qua thuộc tính này. CẢNH BÁO: Không sử dụng khoá sản xuất. Bạn phải bảo vệ nghiêm ngặt và không giữ các khoá đó trong cây nguồn.
`debug_signing_keys`	Danh sách nhãn; mặc định là `[]` Danh sách tệp, kho khoá gỡ lỗi được dùng để ký tệp APK gỡ lỗi. Thông thường, bạn không muốn sử dụng các khoá khác với khoá mặc định, vì vậy, bạn nên bỏ qua thuộc tính này. CẢNH BÁO: Không sử dụng khoá sản xuất. Bạn phải bảo vệ nghiêm ngặt và không giữ các khoá đó trong cây nguồn.
`debug_signing_lineage_file`	Nhãn; mặc định là `None` Tệp chứa dòng ký ứng dụng cho debug_Signed_keys. Thông thường, bạn không muốn sử dụng các khoá khác với khoá mặc định, vì vậy, bạn nên bỏ qua thuộc tính này. CẢNH BÁO: Không sử dụng khoá sản xuất. Bạn phải bảo vệ nghiêm ngặt và không giữ các khoá đó trong cây nguồn.
`densities`	Danh sách chuỗi; mặc định là `[]` Mật độ cần lọc khi tạo APK. Thao tác này sẽ loại bỏ các tài nguyên có thể vẽ của đường quét mà một thiết bị có mật độ màn hình đã chỉ định không tải được, để giảm kích thước tệp APK. Phần màn hình tương thích tương ứng cũng sẽ được thêm vào tệp kê khai nếu phần đó chưa chứa danh sách tập mẹ.
`dex_shards`	Số nguyên; giá trị mặc định là `1` Số lượng phân đoạn dex cần được phân tách thành. Điều này giúp việc tạo tệp dex nhanh hơn nhiều nhưng lại ảnh hưởng đến thời gian khởi động và cài đặt ứng dụng. Tệp nhị phân càng lớn thì càng nên sử dụng nhiều phân đoạn. 25 là mức giá tốt để bắt đầu thử nghiệm. Lưu ý rằng mỗi phân đoạn sẽ dẫn đến ít nhất một tệp dex trong ứng dụng hoàn thiện. Vì lý do này, bạn không nên đặt giá trị này thành nhiều hơn 1 cho tệp nhị phân của bản phát hành.
`dexopts`	Danh sách chuỗi; mặc định là `[]` Các cờ dòng lệnh bổ sung cho công cụ dx khi tạo classes.dex. Áp dụng tuỳ chọn thay thế "Tạo biến" và tạo mã thông báo shell Bourne.
`enable_data_binding`	Boolean; giá trị mặc định là `False` Nếu đúng, quy tắc này sẽ xử lý các biểu thức liên kết dữ liệu trong tài nguyên bố cục có trong thuộc tính resource_files. Nếu không có chế độ cài đặt này, biểu thức liên kết dữ liệu sẽ gây ra lỗi bản dựng. Để tạo một ứng dụng Android có liên kết dữ liệu, bạn cũng phải làm như sau: Đặt thuộc tính này cho tất cả các quy tắc Android phụ thuộc bắc cầu vào thuộc tính này. Điều này là do các phần phụ thuộc kế thừa biểu thức liên kết dữ liệu của quy tắc thông qua việc hợp nhất tài nguyên. Vì vậy, các em cũng cần xây dựng bằng liên kết dữ liệu để phân tích cú pháp các biểu thức đó. Thêm một mục `deps =` cho thư viện thời gian chạy liên kết dữ liệu vào tất cả các mục tiêu đã đặt thuộc tính này. Vị trí của thư viện này tuỳ thuộc vào cách thiết lập kho chứa của bạn.
`incremental_dexing`	Số nguyên; không thể định cấu hình; giá trị mặc định là `-1` Buộc tạo mục tiêu có hoặc không có tính năng tạo tệp dex tăng dần, ghi đè giá trị mặc định và cờ --rise_dexing.
`instruments`	Nhãn; mặc định là `None` Mục tiêu `android_binary` để đo lường. Nếu bạn đặt thuộc tính này, `android_binary` này sẽ được coi là một ứng dụng kiểm thử cho các kiểm thử đo lường. Sau đó, mục tiêu `android_instrumentation_test` có thể chỉ định mục tiêu này trong thuộc tính test_app.
`javacopts`	Danh sách chuỗi; mặc định là `[]` Các tuỳ chọn bổ sung của trình biên dịch cho mục tiêu này. Áp dụng tuỳ chọn thay thế "Tạo biến" và tạo mã thông báo shell Bourne. Các tuỳ chọn trình biên dịch này được chuyển đến javac sau các tuỳ chọn của trình biên dịch chung.
`key_rotation_min_sdk`	Chuỗi; giá trị mặc định là `""` Thiết lập phiên bản nền tảng Android tối thiểu (Cấp độ API) mà khoá ký xoay vòng của APK sẽ được dùng để tạo chữ ký của APK. Khoá ký gốc cho APK sẽ được dùng cho tất cả phiên bản nền tảng trước đó.
`main_dex_list`	Nhãn; mặc định là `None` Tệp văn bản chứa danh sách tên tệp lớp. Các lớp do tệp lớp đó xác định sẽ được đưa vào classes.dex chính. ví dụ: android/support/multidex/MultiDex$V19.class android/support/multidex/MultiDex.class android/support/multidex/MultiDexApplication.class com/google/common/base/Objects.class Phải được sử dụng với `multidex="manual_main_dex"`.
`main_dex_list_opts`	Danh sách chuỗi; mặc định là `[]` Các tuỳ chọn dòng lệnh để chuyển đến trình tạo danh sách dex chính. Sử dụng tuỳ chọn này để tác động đến các lớp có trong danh sách dex chính.
`main_dex_proguard_specs`	Danh sách nhãn; mặc định là `[]` Các tệp được dùng làm thông số kỹ thuật Proguard để xác định các lớp phải được giữ trong tệp dex chính. Chỉ cho phép nếu thuộc tính `multidex` được đặt thành `legacy`.
`manifest`	Nhãn; bắt buộc Tên của tệp kê khai Android, thường là `AndroidManifest.xml`. Phải được xác định nếu tệp resource_file hoặc nội dung đã được xác định.
`manifest_values`	Từ điển: Chuỗi -> Chuỗi; mặc định là `{}` Từ điển các giá trị sẽ được ghi đè trong tệp kê khai. Mọi thực thể của `${name}` trong tệp kê khai sẽ được thay thế bằng giá trị tương ứng với tên trong từ điển này. `applicationId`, `versionCode`, `versionName`, `minSdkVersion`, `targetSdkVersion` và `maxSdkVersion` cũng sẽ ghi đè các thuộc tính tương ứng trong tệp kê khai và thẻ `uses-sdk`. `packageName` sẽ bị bỏ qua và được thiết lập từ `applicationId` nếu được chỉ định hoặc gói trong tệp kê khai. Khi bạn đặt `manifest_merger` thành `legacy` thì chỉ `applicationId`, `versionCode` và `versionName` mới có hiệu lực.
`multidex`	Chuỗi; giá trị mặc định là `"native"` Liệu có chia mã thành nhiều tệp dex hay không. Có thể dùng các giá trị sau: `native`: Phân tách mã thành nhiều tệp dex khi vượt quá giới hạn chỉ mục dex 64K. Giả định rằng nền tảng gốc hỗ trợ việc tải các lớp multidex trong thời gian chạy. Tính năng này chỉ hoạt động với Android L trở lên. `legacy`: Phân tách mã thành nhiều tệp dex khi vượt quá giới hạn chỉ mục dex 64K. Giả sử các lớp multidex được tải thông qua mã xử lý ứng dụng (tức là không hỗ trợ nền tảng gốc). `manual_main_dex`: Phân tách mã thành nhiều tệp dex khi vượt quá giới hạn chỉ mục dex 64K. Bạn cần chỉ định nội dung của tệp dex chính bằng cách cung cấp danh sách các lớp trong một tệp văn bản sử dụng thuộc tính main_dex_list. `off`: Biên dịch tất cả mã thành một tệp dex, ngay cả khi tệp đó vượt quá giới hạn chỉ mục.
`nocompress_extensions`	Danh sách chuỗi; mặc định là `[]` Danh sách đuôi tệp không nén trong APK.
`package_id`	Số nguyên; giá trị mặc định là `0` Mã gói được gán cho các tài nguyên trong tệp nhị phân này. Xem đối số `--package-id` của AAPT2 để biết thêm thông tin. Bạn thường có thể (và nên) không đặt chính sách này, dẫn đến giá trị mặc định là 127 (`0x7F`).
`plugins`	Danh sách nhãn; mặc định là `[]` Các trình bổ trợ trình biên dịch Java để chạy vào thời gian biên dịch. Mọi `java_plugin` được chỉ định trong thuộc tính trình bổ trợ sẽ chạy bất cứ khi nào mục tiêu này được tạo. Các tài nguyên do trình bổ trợ tạo ra sẽ được đưa vào tệp kết quả của mục tiêu.
`proguard_apply_dictionary`	Nhãn; mặc định là `None` Tệp được dùng làm bản đồ ánh xạ cho Proguard. Một tệp phân tách bằng dòng chứa "từ" để lấy khi đổi tên lớp và thành viên trong quá trình làm rối mã nguồn.
`proguard_apply_mapping`	Nhãn; mặc định là `None` Tệp được dùng làm bản đồ ánh xạ cho Proguard. Tệp ánh xạ do `proguard_generate_mapping` tạo sẽ được dùng lại để áp dụng cùng một mối liên kết cho bản dựng mới.
`proguard_generate_mapping`	Boolean; không thể định cấu hình; giá trị mặc định là `False` Liệu có tạo tệp ánh xạ Proguard hay không. Tệp ánh xạ sẽ chỉ được tạo nếu bạn chỉ định `proguard_specs`. Tệp này sẽ liệt kê mối liên kết giữa lớp, phương thức và tên trường ban đầu và bị làm rối mã nguồn. CẢNH BÁO: Nếu bạn sử dụng thuộc tính này, thì thông số kỹ thuật Proguard không được chứa `-dontobfuscate` hoặc `-printmapping`.
`proguard_specs`	Danh sách nhãn; mặc định là `[]` Các tệp dùng làm thông số kỹ thuật Proguard. Tệp này sẽ mô tả tập hợp thông số kỹ thuật mà Proguard sử dụng.
`resource_configuration_filters`	Danh sách chuỗi; mặc định là `[]` Danh sách bộ lọc cấu hình tài nguyên, chẳng hạn như "en" sẽ giới hạn các tài nguyên trong tệp APK chỉ còn những tài nguyên trong cấu hình "en". Để bật tính năng giả lập, hãy thêm các ngôn ngữ giả lập `en_XA` và/hoặc `ar_XB`.
`resource_files`	Danh sách nhãn; mặc định là `[]` Danh sách tài nguyên cần đóng gói. Đây thường là `glob` của mọi tệp trong thư mục `res`. Các tệp đã tạo (từ genrules) cũng có thể được tham chiếu bằng Label (Nhãn) tại đây. Hạn chế duy nhất là các dữ liệu đầu ra được tạo phải nằm trong cùng một thư mục "`res`" với mọi tệp tài nguyên khác đi kèm.
`shrink_resources`	Số nguyên; giá trị mặc định là `-1` Liệu có thực hiện rút gọn tài nguyên hay không. Các tài nguyên không được tệp nhị phân sử dụng sẽ bị xoá khỏi APK. Tính năng này chỉ được hỗ trợ cho các quy tắc sử dụng tài nguyên cục bộ (ví dụ: các thuộc tính `manifest` và `resource_files`) và yêu cầu ProGuard. Công cụ này hoạt động gần như theo cách tương tự như trình thu gọn tài nguyên Gradle (https://developer.android.com/studio/build/shrink-code.html#shrink-resources). Điểm khác biệt đáng chú ý: tài nguyên trong `values/` cũng sẽ bị xoá cũng như tài nguyên dựa trên tệp sử dụng `strict mode` theo mặc định Tính năng xoá các tài nguyên mã nhận dạng không dùng đến chỉ được hỗ trợ với aapt2 Nếu bạn bật tính năng rút gọn tài nguyên, `name_files/resource_shrinker.log` cũng sẽ được tạo để trình bày chi tiết quá trình phân tích và xoá. Các loại tệp có thể được thu thập dữ liệu bao gồm: `shrink_resources = 1`: Bật tính năng rút gọn tài nguyên Android `shrink_resources = 0`: Tắt tính năng rút gọn tài nguyên Android `shrink_resources = -1`: Hoạt động thu hẹp do cờ --android_resource_shrinking kiểm soát.

aar_import

Xem nguồn quy tắc

aar_import(name, deps, data, aar, compatible_with, deprecation, distribs, exec_compatible_with, exec_properties, exports, features, licenses, restricted_to, srcjar, tags, target_compatible_with, testonly, visibility)

Quy tắc này cho phép sử dụng tệp .aar làm thư viện cho các quy tắc android_library và android_binary.

Ví dụ

    aar_import(
        name = "google-vr-sdk",
        aar = "gvr-android-sdk/libraries/sdk-common-1.10.0.aar",
    )

    android_binary(
        name = "app",
        manifest = "AndroidManifest.xml",
        srcs = glob(["**.java"]),
        deps = [":google-vr-sdk"],
    )

Đối số

Thuộc tính
`name`	Tên; bắt buộc Tên duy nhất cho mục tiêu này.
`aar`	Nhãn; bắt buộc Tệp `.aar` để cung cấp cho các mục tiêu Android phụ thuộc vào mục tiêu này.
`exports`	Danh sách nhãn; mặc định là `[]` Các mục tiêu để xuất sang các quy tắc phụ thuộc vào quy tắc này. Hãy xem java_library.exports.
`srcjar`	Nhãn; mặc định là `None` Tệp JAR chứa mã nguồn cho các tệp JAR được biên dịch trong AAR.

android_library

Xem nguồn quy tắc

android_library(name, deps, srcs, data, assets, assets_dir, compatible_with, custom_package, deprecation, distribs, enable_data_binding, exec_compatible_with, exec_properties, exported_plugins, exports, exports_manifest, features, idl_import_root, idl_parcelables, idl_preprocessed, idl_srcs, javacopts, licenses, manifest, neverlink, plugins, proguard_specs, resource_files, restricted_to, tags, target_compatible_with, testonly, visibility)

Quy tắc này biên dịch và lưu trữ các nguồn vào một tệp .jar. Thư viện Android Runtime android.jar được ngầm đưa vào đường dẫn lớp biên dịch.

Các mục tiêu đầu ra ngầm ẩn

libname.jar: Một tệp lưu trữ Java.
libname-src.jar: Một tệp lưu trữ chứa các nguồn ("tệp nguồn").
name.aar: Gói Android "aar" chứa kho lưu trữ java và các tài nguyên của mục tiêu này. Tham số này không chứa đóng bắt buộc.

Ví dụ

Bạn có thể xem ví dụ về các quy tắc của Android trong thư mục examples/android của cây nguồn Bazel.

Ví dụ sau cho thấy cách đặt idl_import_root. Cho phép //java/bazel/helloandroid/BUILD chứa:

android_library(
    name = "parcelable",
    srcs = ["MyParcelable.java"], # bazel.helloandroid.MyParcelable

    # MyParcelable.aidl will be used as import for other .aidl
    # files that depend on it, but will not be compiled.
    idl_parcelables = ["MyParcelable.aidl"] # bazel.helloandroid.MyParcelable

    # We don't need to specify idl_import_root since the aidl file
    # which declares bazel.helloandroid.MyParcelable
    # is present at java/bazel/helloandroid/MyParcelable.aidl
    # underneath a java root (java/).
)

android_library(
    name = "foreign_parcelable",
    srcs = ["src/android/helloandroid/OtherParcelable.java"], # android.helloandroid.OtherParcelable
    idl_parcelables = [
        "src/android/helloandroid/OtherParcelable.aidl" # android.helloandroid.OtherParcelable
    ],

    # We need to specify idl_import_root because the aidl file which
    # declares android.helloandroid.OtherParcelable is not positioned
    # at android/helloandroid/OtherParcelable.aidl under a normal java root.
    # Setting idl_import_root to "src" in //java/bazel/helloandroid
    # adds java/bazel/helloandroid/src to the list of roots
    # the aidl compiler will search for imported types.
    idl_import_root = "src",
)

# Here, OtherInterface.aidl has an "import android.helloandroid.CallbackInterface;" statement.
android_library(
    name = "foreign_interface",
    idl_srcs = [
        "src/android/helloandroid/OtherInterface.aidl" # android.helloandroid.OtherInterface
        "src/android/helloandroid/CallbackInterface.aidl" # android.helloandroid.CallbackInterface
    ],

    # As above, idl_srcs which are not correctly positioned under a java root
    # must have idl_import_root set. Otherwise, OtherInterface (or any other
    # interface in a library which depends on this one) will not be able
    # to find CallbackInterface when it is imported.
    idl_import_root = "src",
)

# MyParcelable.aidl is imported by MyInterface.aidl, so the generated
# MyInterface.java requires MyParcelable.class at compile time.
# Depending on :parcelable ensures that aidl compilation of MyInterface.aidl
# specifies the correct import roots and can access MyParcelable.aidl, and
# makes MyParcelable.class available to Java compilation of MyInterface.java
# as usual.
android_library(
    name = "idl",
    idl_srcs = ["MyInterface.aidl"],
    deps = [":parcelable"],
)

# Here, ServiceParcelable uses and thus depends on ParcelableService,
# when it's compiled, but ParcelableService also uses ServiceParcelable,
# which creates a circular dependency.
# As a result, these files must be compiled together, in the same android_library.
android_library(
    name = "circular_dependencies",
    srcs = ["ServiceParcelable.java"],
    idl_srcs = ["ParcelableService.aidl"],
    idl_parcelables = ["ServiceParcelable.aidl"],
)

Đối số

Thuộc tính
`name`	Tên; bắt buộc Tên duy nhất cho mục tiêu này.
`deps`	Danh sách nhãn; mặc định là `[]` Danh sách các thư viện khác để liên kết. Các loại thư viện được phép là: `android_library`, `java_library` có quy tắc ràng buộc `android` và `cc_library` gói hoặc tạo thư viện gốc `.so` cho nền tảng mục tiêu Android.
`srcs`	Danh sách nhãn; mặc định là `[]` Danh sách các tệp `.java` hoặc `.srcjar` được xử lý để tạo mục tiêu. Hệ thống biên dịch các tệp `srcs` thuộc loại `.java`. Để dễ đọc, bạn không nên đưa tên của tệp nguồn `.java` đã tạo vào `srcs`. Thay vào đó, hãy đặt tên quy tắc phụ thuộc vào `srcs`, như mô tả dưới đây. Tệp `srcs` thuộc loại `.srcjar` được giải nén và biên dịch. (Cách này rất hữu ích nếu bạn cần tạo một tập hợp các tệp .java bằng gen quy tắc hoặc tiện ích bản dựng.) Nếu bạn bỏ qua `srcs`, thì mọi phần phụ thuộc được chỉ định trong `deps` sẽ được xuất từ quy tắc này (xem phần dữ liệu xuất của java_library để biết thêm thông tin về cách xuất các phần phụ thuộc). Tuy nhiên, hành vi này sắp không được dùng nữa; hãy cố gắng đừng dựa vào nó.
`assets`	Danh sách nhãn; mặc định là `[]` Danh sách tài sản cần đóng gói. Đây thường là `glob` của mọi tệp trong thư mục `assets`. Bạn cũng có thể tham chiếu các quy tắc khác (mọi quy tắc tạo ra tệp) hoặc tệp đã xuất trong các gói khác, miễn là tất cả các tệp đó đều nằm trong thư mục `assets_dir` trong gói tương ứng.
`assets_dir`	Chuỗi; giá trị mặc định là `""` Chuỗi cung cấp đường dẫn đến các tệp trong `assets`. Cặp `assets` và `assets_dir` mô tả tài sản đóng gói và cả hai đều phải được cung cấp hoặc không cung cấp thuộc tính nào.
`custom_package`	Chuỗi; giá trị mặc định là `""` Gói Java mà nguồn java sẽ được tạo. Theo mặc định, gói này được dự đoán từ thư mục có chứa tệp BUILD chứa quy tắc. Bạn có thể chỉ định một gói khác nhưng bạn không nên làm như vậy vì việc này có thể gây ra xung đột đường dẫn lớp với các thư viện khác sẽ chỉ được phát hiện trong thời gian chạy.
`enable_data_binding`	Boolean; giá trị mặc định là `False` Nếu đúng, quy tắc này sẽ xử lý các biểu thức liên kết dữ liệu trong tài nguyên bố cục có trong thuộc tính resource_files. Nếu không có chế độ cài đặt này, biểu thức liên kết dữ liệu sẽ gây ra lỗi bản dựng. Để tạo một ứng dụng Android có liên kết dữ liệu, bạn cũng phải làm như sau: Đặt thuộc tính này cho tất cả các quy tắc Android phụ thuộc bắc cầu vào thuộc tính này. Điều này là do các phần phụ thuộc kế thừa biểu thức liên kết dữ liệu của quy tắc thông qua việc hợp nhất tài nguyên. Vì vậy, các em cũng cần xây dựng bằng liên kết dữ liệu để phân tích cú pháp các biểu thức đó. Thêm một mục `deps =` cho thư viện thời gian chạy liên kết dữ liệu vào tất cả các mục tiêu đã đặt thuộc tính này. Vị trí của thư viện này tuỳ thuộc vào cách thiết lập kho chứa của bạn.
`exported_plugins`	Danh sách nhãn; mặc định là `[]` Danh sách các `java_plugin` (ví dụ: trình xử lý chú giải) để xuất sang các thư viện phụ thuộc trực tiếp vào thư viện này. Danh sách `java_plugin` được chỉ định sẽ được áp dụng cho mọi thư viện trực tiếp phụ thuộc vào thư viện này, giống như khi thư viện đó đã khai báo rõ ràng các nhãn này trong `plugins`.
`exports`	Danh sách nhãn; mặc định là `[]` Việc đóng tất cả các quy tắc truy cập được thông qua thuộc tính `exports` đều được coi là phần phụ thuộc trực tiếp của mọi quy tắc phụ thuộc trực tiếp vào mục tiêu có `exports`. `exports` không phải là phần phụ thuộc trực tiếp của quy tắc mà chúng thuộc về.
`exports_manifest`	Số nguyên; giá trị mặc định là `1` Liệu có xuất các mục nhập tệp kê khai sang các mục tiêu `android_binary` phụ thuộc vào mục tiêu này hay không. Thuộc tính `uses-permissions` không bao giờ được xuất.
`idl_import_root`	Chuỗi; giá trị mặc định là `""` Đường dẫn tương đối theo gói đến gốc của cây gói java chứa các nguồn idl có trong thư viện này. Đường dẫn này sẽ được dùng làm gốc nhập khi xử lý các nguồn idl phụ thuộc vào thư viện này. Khi bạn chỉ định `idl_import_root`, cả `idl_parcelables` và `idl_srcs` đều phải nằm tại đường dẫn được gói java của đối tượng mà chúng đại diện trong `idl_import_root` chỉ định. Khi không chỉ định `idl_import_root`, cả `idl_parcelables` và `idl_srcs` đều phải ở đường dẫn do gói chỉ định trong một gốc Java. Xem ví dụ.
`idl_parcelables`	Danh sách nhãn; mặc định là `[]` Danh sách định nghĩa IDL Android để cung cấp dưới dạng nhập. Các tệp này sẽ được cung cấp dưới dạng tệp nhập cho mọi mục tiêu `android_library` phụ thuộc vào thư viện này, trực tiếp hoặc thông qua quá trình đóng bắc cầu, nhưng sẽ không được dịch sang Java hoặc được biên dịch. Bạn chỉ nên bao gồm các tệp `.aidl` tương ứng trực tiếp với các nguồn `.java` trong thư viện này (ví dụ: các phương thức triển khai tuỳ chỉnh của Parcelable), nếu không thì bạn nên sử dụng `idl_srcs`. Bạn phải đặt các tệp này ở vị trí phù hợp để trình biên dịch AIdl tìm được tệp. Hãy xem nội dung mô tả về idl_import_root để biết thông tin về ý nghĩa của lệnh này.
`idl_preprocessed`	Danh sách nhãn; mặc định là `[]` Danh sách các định nghĩa IDL Android đã xử lý trước để cung cấp dưới dạng dữ liệu nhập. Các tệp này sẽ được cung cấp dưới dạng tệp nhập cho mọi mục tiêu `android_library` phụ thuộc vào thư viện này, trực tiếp hoặc thông qua quá trình đóng bắc cầu, nhưng sẽ không được dịch sang Java hoặc được biên dịch. Bạn chỉ nên đưa vào các tệp `.aidl` đã xử lý trước tương ứng trực tiếp với các nguồn `.java` trong thư viện này (ví dụ: cách triển khai tuỳ chỉnh của Parcelable), nếu không, hãy sử dụng `idl_srcs` cho các định nghĩa Android IDL cần được dịch sang giao diện Java và sử dụng `idl_parcelable` cho các tệp AIDL chưa được xử lý trước.
`idl_srcs`	Danh sách nhãn; mặc định là `[]` Danh sách các định nghĩa IDL của Android cần dịch sang giao diện Java. Sau khi giao diện Java được tạo, các giao diện đó sẽ được biên dịch cùng với nội dung của `srcs`. Các tệp này sẽ được cung cấp dưới dạng tệp nhập cho mọi mục tiêu `android_library` phụ thuộc vào thư viện này, trực tiếp hoặc qua phương thức đóng bắc cầu. Bạn phải đặt các tệp này ở vị trí phù hợp để trình biên dịch AIdl tìm được tệp. Hãy xem nội dung mô tả về idl_import_root để biết thông tin về ý nghĩa của lệnh này.
`javacopts`	Danh sách chuỗi; mặc định là `[]` Các tuỳ chọn bổ sung của trình biên dịch cho mục tiêu này. Áp dụng tuỳ chọn thay thế "Tạo biến" và tạo mã thông báo shell Bourne. Các tuỳ chọn trình biên dịch này được chuyển đến javac sau các tuỳ chọn của trình biên dịch chung.
`manifest`	Nhãn; mặc định là `None` Tên của tệp kê khai Android, thường là `AndroidManifest.xml`. Phải được xác định nếu tệp resource_file hoặc nội dung đã được xác định.
`neverlink`	Boolean; giá trị mặc định là `False` Chỉ dùng thư viện này để biên dịch chứ không dùng trong thời gian chạy. Kết quả của một quy tắc được đánh dấu là `neverlink` sẽ không được dùng trong quá trình tạo `.apk`. Hữu ích nếu môi trường thời gian chạy cung cấp thư viện trong quá trình thực thi.
`plugins`	Danh sách nhãn; mặc định là `[]` Các trình bổ trợ trình biên dịch Java để chạy vào thời gian biên dịch. Mọi `java_plugin` được chỉ định trong thuộc tính trình bổ trợ sẽ chạy bất cứ khi nào mục tiêu này được tạo. Các tài nguyên do trình bổ trợ tạo ra sẽ được đưa vào tệp kết quả của mục tiêu.
`proguard_specs`	Danh sách nhãn; mặc định là `[]` Các tệp dùng làm thông số kỹ thuật Proguard. Phần này mô tả tập hợp thông số kỹ thuật mà Proguard sử dụng. Nếu được chỉ định, các mục này sẽ được thêm vào bất kỳ mục tiêu `android_binary` nào tuỳ thuộc vào thư viện này. Các tệp được đưa vào đây chỉ được có các quy tắc giá trị không thay đổi, cụ thể là -dontnote, -dontwarn, giả định và các quy tắc bắt đầu bằng -keep. Các tuỳ chọn khác chỉ có thể xuất hiện trong proguard_specs của `android_binary` để đảm bảo hợp nhất không tự động hoá.
`resource_files`	Danh sách nhãn; mặc định là `[]` Danh sách tài nguyên cần đóng gói. Đây thường là `glob` của mọi tệp trong thư mục `res`. Các tệp đã tạo (từ genrules) cũng có thể được tham chiếu bằng Label (Nhãn) tại đây. Hạn chế duy nhất là các dữ liệu đầu ra được tạo phải nằm trong cùng một thư mục "`res`" với mọi tệp tài nguyên khác đi kèm.

android_instrumentation_test

Xem nguồn quy tắc

android_instrumentation_test(name, data, args, compatible_with, deprecation, distribs, env, env_inherit, exec_compatible_with, exec_properties, features, flaky, licenses, local, restricted_to, shard_count, size, support_apks, tags, target_compatible_with, target_device, test_app, testonly, timeout, toolchains, visibility)

Quy tắc android_instrumentation_test chạy kiểm thử đo lường Android. Thao tác này sẽ khởi động một trình mô phỏng, cài đặt ứng dụng đang được kiểm thử, ứng dụng kiểm thử cũng như mọi ứng dụng cần thiết khác, đồng thời chạy các kiểm thử được xác định trong gói kiểm thử.

Thuộc tính test_app chỉ định android_binary chứa hoạt động kiểm thử. Lần lượt android_binary này chỉ định ứng dụng android_binary đang được kiểm thử thông qua thuộc tính Instruments (thiết bị).

Ví dụ:

# java/com/samples/hello_world/BUILD

android_library(
    name = "hello_world_lib",
    srcs = ["Lib.java"],
    manifest = "LibraryManifest.xml",
    resource_files = glob(["res/**"]),
)

# The app under test
android_binary(
    name = "hello_world_app",
    manifest = "AndroidManifest.xml",
    deps = [":hello_world_lib"],
)

# javatests/com/samples/hello_world/BUILD

android_library(
    name = "hello_world_test_lib",
    srcs = ["Tests.java"],
    deps = [
      "//java/com/samples/hello_world:hello_world_lib",
      ...  # test dependencies such as Espresso and Mockito
    ],
)

# The test app
android_binary(
    name = "hello_world_test_app",
    instruments = "//java/com/samples/hello_world:hello_world_app",
    manifest = "AndroidManifest.xml",
    deps = [":hello_world_test_lib"],
)

android_instrumentation_test(
    name = "hello_world_uiinstrumentation_tests",
    target_device = ":some_target_device",
    test_app = ":hello_world_test_app",
)

Đối số

Thuộc tính
`name`	Tên; bắt buộc Tên duy nhất cho mục tiêu này.
`support_apks`	Danh sách nhãn; mặc định là `[]` Các tệp APK khác để cài đặt trên thiết bị trước khi bắt đầu kiểm thử đo lường.
`target_device`	Nhãn; bắt buộc android_device sẽ chạy kiểm thử. Để chạy kiểm thử trên một trình mô phỏng đang chạy hoặc trên thiết bị thực, hãy sử dụng các đối số sau: `--test_output=streamed --test_arg=--device_broker_type=LOCAL_ADB_SERVER --test_arg=--device_serial_number=$device_identifier`
`test_app`	Nhãn; bắt buộc Mục tiêu android_binary chứa các lớp kiểm thử. Mục tiêu `android_binary` phải chỉ định mục tiêu đang được thử nghiệm thông qua thuộc tính `instruments`.

android_local_test

Xem nguồn quy tắc

android_local_test(name, deps, srcs, data, args, compatible_with, custom_package, densities, deprecation, enable_data_binding, env, env_inherit, exec_compatible_with, exec_properties, features, flaky, javacopts, jvm_flags, licenses, local, manifest, manifest_values, nocompress_extensions, plugins, resource_configuration_filters, resource_jars, resource_strip_prefix, restricted_to, runtime_deps, shard_count, size, stamp, tags, target_compatible_with, test_class, testonly, timeout, toolchains, use_launcher, visibility)

Quy tắc này dành cho các quy tắc android_library kiểm thử đơn vị cục bộ (thay vì trên thiết bị). Công cụ này hoạt động với khung kiểm thử Android Robolectric. Hãy xem trang web Android Robolectric để biết thông tin chi tiết về cách viết chương trình kiểm thử Robolectric.

Các mục tiêu đầu ra ngầm ẩn

name.jar: Tệp lưu trữ Java của kiểm thử.
name-src.jar: Một tệp lưu trữ chứa các nguồn ("tệp nguồn").
name_deploy.jar: Bản lưu trữ triển khai Java phù hợp với việc triển khai (chỉ được tạo khi có yêu cầu rõ ràng).

Ví dụ

Để sử dụng Robolectric với android_local_test, hãy thêm kho lưu trữ của Robolectric vào tệp WORKSPACE của bạn:

http_archive(
    name = "robolectric",
    urls = ["https://github.com/robolectric/robolectric-bazel/archive/<COMMIT>.tar.gz"],
    strip_prefix = "robolectric-bazel-<COMMIT>",
    sha256 = "<HASH>",
)
load("@robolectric//bazel:robolectric.bzl", "robolectric_repositories")
robolectric_repositories()

Công cụ này sẽ lấy maven_jar quy tắc cần thiết cho Robolectric. Sau đó, mỗi quy tắc android_local_test sẽ phụ thuộc vào @robolectric//bazel:robolectric. Hãy xem ví dụ bên dưới.

android_local_test(
    name = "SampleTest",
    srcs = [
        "SampleTest.java",
    ],
    manifest = "LibManifest.xml",
    deps = [
        ":sample_test_lib",
        "@robolectric//bazel:android-all",
    ],
)

android_library(
    name = "sample_test_lib",
    srcs = [
         "Lib.java",
    ],
    resource_files = glob(["res/**"]),
    manifest = "AndroidManifest.xml",
)

Đối số

Thuộc tính
`name`	Tên; bắt buộc Tên duy nhất cho mục tiêu này.
`deps`	Danh sách nhãn; mặc định là `[]` Danh sách thư viện cần kiểm thử cũng như các thư viện khác sẽ được liên kết với mục tiêu. Tất cả tài nguyên, tài sản và tệp kê khai được khai báo trong các quy tắc của Android trong quá trình đóng bắc cầu của thuộc tính này đều sẽ được cung cấp trong quá trình kiểm thử. Danh sách các quy tắc được phép trong `deps` là `android_library`, `aar_import`, `java_import`, `java_library` và `java_lite_proto_library`.
`srcs`	Danh sách nhãn; mặc định là `[]` Danh sách tệp nguồn được xử lý để tạo mục tiêu. Bắt buộc ngoại trừ trường hợp đặc biệt được mô tả bên dưới. Hệ thống biên dịch các tệp `srcs` thuộc loại `.java`. Để dễ đọc, bạn không nên đưa tên của tệp nguồn `.java` đã tạo vào `srcs`. Thay vào đó, hãy đặt tên quy tắc phụ thuộc vào `srcs`, như mô tả dưới đây. Tệp `srcs` thuộc loại `.srcjar` được giải nén và biên dịch. (Cách này rất hữu ích nếu bạn cần tạo một tập hợp các tệp .java bằng gen quy tắc hoặc tiện ích bản dựng.) Tất cả các tệp khác sẽ bị bỏ qua, miễn là có ít nhất một tệp thuộc loại tệp được mô tả ở trên. Nếu không, lỗi sẽ xuất hiện. Thuộc tính `srcs` là bắt buộc và không được để trống, trừ phi bạn chỉ định `runtime_deps`.
`custom_package`	Chuỗi; giá trị mặc định là `""` Gói Java trong đó lớp R sẽ được tạo. Theo mặc định, gói này được dự đoán từ thư mục có tệp BUILD chứa quy tắc. Nếu sử dụng thuộc tính này, bạn có thể cũng cần phải sử dụng `test_class`.
`densities`	Danh sách chuỗi; mặc định là `[]` Mật độ cần lọc khi tạo APK. Một phần màn hình tương thích tương ứng cũng sẽ được thêm vào tệp kê khai nếu phần đó chưa chứa tập mẹ StarlarkListing.
`enable_data_binding`	Boolean; giá trị mặc định là `False` Nếu đúng, quy tắc này sẽ xử lý các tệp tham chiếu liên kết dữ liệu dùng trong các phần phụ thuộc có bật tính năng liên kết dữ liệu mà chương trình kiểm thử này sử dụng. Nếu không có chế độ cài đặt này, các phần phụ thuộc liên kết dữ liệu sẽ không tạo ra mã cấp nhị phân cần thiết và có thể gây ra lỗi bản dựng.
`javacopts`	Danh sách chuỗi; mặc định là `[]` Các tuỳ chọn bổ sung của trình biên dịch cho thư viện này. Áp dụng tuỳ chọn thay thế "Tạo biến" và tạo mã thông báo shell Bourne. Các tuỳ chọn trình biên dịch này được chuyển đến javac sau các tuỳ chọn của trình biên dịch chung.
`jvm_flags`	Danh sách chuỗi; mặc định là `[]` Danh sách cờ để nhúng vào tập lệnh trình bao bọc được tạo để chạy tệp nhị phân này. Tuân theo việc thay thế $(location) và "Tạo biến" cũng như mã hoá bằng mã thông báo shell Bourne. Tập lệnh trình bao bọc cho một tệp nhị phân Java bao gồm định nghĩa CLASSPATH (để tìm tất cả các tệp phụ thuộc) và gọi trình thông dịch Java phù hợp. Dòng lệnh do tập lệnh trình bao bọc tạo ra bao gồm tên của lớp chính, theo sau là `"$@"` để bạn có thể truyền các đối số khác sau tên lớp. Tuy nhiên, các đối số dùng để phân tích cú pháp của JVM phải được chỉ định trước tên lớp trên dòng lệnh. Nội dung của `jvm_flags` được thêm vào tập lệnh trình bao bọc trước khi tên lớp được liệt kê. Lưu ý rằng thuộc tính này không ảnh hưởng đến dữ liệu đầu ra `*_deploy.jar`.
`manifest`	Nhãn; mặc định là `None` Tên của tệp kê khai Android, thường là `AndroidManifest.xml`. Bạn phải xác định nếu resource_file hoặc nội dung được xác định hoặc nếu bất kỳ tệp kê khai nào từ thư viện đang được kiểm thử có chứa thẻ `minSdkVersion`.
`manifest_values`	Từ điển: Chuỗi -> Chuỗi; mặc định là `{}` Từ điển các giá trị sẽ được ghi đè trong tệp kê khai. Mọi thực thể của ${name} trong tệp kê khai sẽ được thay thế bằng giá trị tương ứng với tên trong từ điển này. `applicationId`, `versionCode`, `versionName`, `minSdkVersion`, `targetSdkVersion` và `maxSdkVersion` cũng sẽ ghi đè các thuộc tính tương ứng của tệp kê khai và thẻ use-sdk. `packageName` sẽ bị bỏ qua và được thiết lập từ `applicationId` nếu được chỉ định hoặc gói trong tệp kê khai. Bạn không cần phải có tệp kê khai trong quy tắc để sử dụng manifest_values.
`nocompress_extensions`	Danh sách chuỗi; mặc định là `[]` Danh sách đuôi tệp không nén trong tệp APK tài nguyên.
`plugins`	Danh sách nhãn; mặc định là `[]` Các trình bổ trợ trình biên dịch Java để chạy vào thời gian biên dịch. Mọi `java_plugin` được chỉ định trong thuộc tính này sẽ chạy bất cứ khi nào quy tắc này được tạo. Một thư viện cũng có thể kế thừa trình bổ trợ từ các phần phụ thuộc sử dụng `exported_plugins`. Các tài nguyên do trình bổ trợ tạo ra sẽ được đưa vào tệp jar kết quả của quy tắc này.
`resource_configuration_filters`	Danh sách chuỗi; mặc định là `[]` Danh sách bộ lọc cấu hình tài nguyên, chẳng hạn như "en" sẽ giới hạn các tài nguyên trong tệp APK chỉ còn những tài nguyên trong cấu hình "en".
`resource_jars`	Danh sách nhãn; mặc định là `[]` Không dùng nữa: Thay vào đó, hãy sử dụng java_import và deps hoặc hay Runtime_deps.
`resource_strip_prefix`	Chuỗi; giá trị mặc định là `""` Tiền tố đường dẫn để loại bỏ khỏi tài nguyên Java. Nếu được chỉ định, tiền tố đường dẫn này sẽ bị xoá khỏi mọi tệp trong thuộc tính `resources`. Nếu tệp tài nguyên không nằm trong thư mục này thì xảy ra lỗi. Nếu không được chỉ định (mặc định), đường dẫn của tệp tài nguyên sẽ được xác định theo cùng một logic như gói Java của các tệp nguồn. Ví dụ: tệp nguồn tại `stuff/java/foo/bar/a.txt` sẽ nằm ở `foo/bar/a.txt`.
`runtime_deps`	Danh sách nhãn; mặc định là `[]` Các thư viện chỉ cung cấp cho tệp nhị phân cuối cùng hoặc kiểm thử trong thời gian chạy. Giống như `deps` thông thường, các thành phần này sẽ xuất hiện trên đường dẫn lớp thời gian chạy, nhưng không giống như các đường dẫn lớp này, không xuất hiện trên đường dẫn lớp thời gian biên dịch. Bạn phải liệt kê các phần phụ thuộc chỉ cần thiết trong thời gian chạy tại đây. Các công cụ phân tích phần phụ thuộc nên bỏ qua các mục tiêu xuất hiện trong cả `runtime_deps` và `deps`.
`stamp`	Số nguyên; giá trị mặc định là `0` Liệu có mã hoá thông tin bản dựng thành tệp nhị phân hay không. Có thể dùng các giá trị sau: `stamp = 1`: Luôn đóng dấu thông tin bản dựng vào tệp nhị phân, ngay cả trong các bản dựng `--nostamp`. Bạn nên tránh chế độ cài đặt này, vì chế độ này có thể tắt chức năng lưu vào bộ nhớ đệm từ xa đối với tệp nhị phân và mọi thao tác hạ nguồn phụ thuộc vào tệp nhị phân đó. `stamp = 0`: Luôn thay thế thông tin bản dựng bằng các giá trị hằng số. Điều này giúp lưu kết quả bản dựng tốt vào bộ nhớ đệm. `stamp = -1`: Bạn có thể kiểm soát việc nhúng thông tin bản dựng bằng cờ `--[no]stamp`. Tệp nhị phân đã đóng dấu không được tạo lại trừ phi các phần phụ thuộc của chúng thay đổi.
`test_class`	Chuỗi; giá trị mặc định là `""` Lớp Java sẽ được tải bởi trình chạy kiểm thử. Thuộc tính này chỉ định tên của lớp Java mà chương trình kiểm thử này sẽ chạy. Việc thiết lập chế độ này hiếm khi xảy ra. Nếu đối số này bị bỏ qua, thì lớp Java có tên tương ứng với `name` của quy tắc `android_local_test` này sẽ được sử dụng. Bạn cần chú thích cho lớp kiểm thử này bằng `org.junit.runner.RunWith`.
`use_launcher`	Boolean; giá trị mặc định là `True` Liệu tệp nhị phân có sử dụng trình chạy tuỳ chỉnh hay không. Nếu bạn đặt thuộc tính này thành false, thì thuộc tính trình chạy và cờ `--java_launcher` có liên quan sẽ bị bỏ qua đối với mục tiêu này.

android_device

Xem nguồn quy tắc

android_device(name, cache, compatible_with, default_properties, deprecation, distribs, exec_compatible_with, exec_properties, features, horizontal_resolution, licenses, platform_apks, ram, restricted_to, screen_density, system_image, tags, target_compatible_with, testonly, vertical_resolution, visibility, vm_heap)

Quy tắc này sẽ tạo một trình mô phỏng Android được định cấu hình theo các thông số kỹ thuật nhất định. Bạn có thể khởi động trình mô phỏng này thông qua lệnh chạy bazel hoặc bằng cách thực thi trực tiếp tập lệnh đã tạo. Bạn nên phụ thuộc vào các quy tắc android_device hiện có thay vì xác định các quy tắc của riêng mình.

Quy tắc này là mục tiêu phù hợp cho cờ --run_under để kiểm thử bazel và chạy nhanh. Thao tác này sẽ khởi động một trình mô phỏng, sao chép mục tiêu đang được kiểm thử/chạy vào trình mô phỏng rồi kiểm thử hoặc chạy mục tiêu đó khi thích hợp.

android_device hỗ trợ tạo hình ảnh KVM nếu system_image cơ bản dựa trên X86 và được tối ưu hoá cho tối đa kiến trúc CPU I686. Để sử dụng KVM, hãy thêm tags = ['requires-kvm'] vào quy tắc android_device.

Các mục tiêu đầu ra ngầm ẩn

name_images/userdata.dat: Chứa các tệp hình ảnh và bản tổng quan nhanh để khởi động trình mô phỏng
name_images/emulator-meta-data.pb: Chứa thông tin chuyển đổi tuần tự cần thiết để truyền đến trình mô phỏng nhằm khởi động lại.

Ví dụ

Ví dụ sau cho biết cách sử dụng android_device. //java/android/helloandroid/BUILD chứa

android_device(
    name = "nexus_s",
    cache = 32,
    default_properties = "nexus_s.properties",
    horizontal_resolution = 480,
    ram = 512,
    screen_density = 233,
    system_image = ":emulator_images_android_16_x86",
    vertical_resolution = 800,
    vm_heap = 32,
)

filegroup(
    name = "emulator_images_android_16_x86",
    srcs = glob(["androidsdk/system-images/android-16/**"]),
)

//java/android/helloandroid/nexus_s.properties chứa:

ro.product.brand=google
ro.product.device=crespo
ro.product.manufacturer=samsung
ro.product.model=Nexus S
ro.product.name=soju

Quy tắc này sẽ tạo hình ảnh và một tập lệnh khởi động. Bạn có thể khởi động trình mô phỏng cục bộ bằng cách thực thi bazel run :nexus_s -- --action=start. Tập lệnh này cho thấy các cờ sau:

--adb_port: Cổng để hiển thị adb. Nếu bạn muốn đưa ra các lệnh adb cho trình mô phỏng, thì đây là cổng mà bạn sẽ kết nối adb.
--emulator_port: Cổng để hiển thị bảng điều khiển quản lý telnet của trình mô phỏng.
--enable_display: Khởi động trình mô phỏng bằng một màn hình nếu giá trị true (mặc định là false).
--action: Bắt đầu hoặc dừng.
--apks_to_install: danh sách tệp APK để cài đặt trên trình mô phỏng.

Đối số

Thuộc tính
`name`	Tên; bắt buộc Tên duy nhất cho mục tiêu này.
`cache`	Số nguyên; bắt buộc Dung lượng tính bằng megabyte của phân vùng bộ nhớ đệm của trình mô phỏng. Giá trị tối thiểu là 16 megabyte.
`default_properties`	Nhãn; mặc định là `None` Một tệp thuộc tính duy nhất được đặt vào /default.prop trên trình mô phỏng. Điều này cho phép tác giả quy tắc định cấu hình thêm để trình mô phỏng trông giống với thiết bị thực hơn (cụ thể là việc kiểm soát các chuỗi UserAgent và hành vi khác có thể khiến ứng dụng hoặc máy chủ hoạt động theo cách khác với một thiết bị cụ thể). Các thuộc tính trong tệp này sẽ ghi đè các thuộc tính chỉ đọc thường do trình mô phỏng đặt, chẳng hạn như ro.product.model.
`horizontal_resolution`	Số nguyên; bắt buộc Độ phân giải màn hình ngang tính bằng pixel để mô phỏng. Giá trị tối thiểu là 240.
`platform_apks`	Danh sách nhãn; mặc định là `[]` Danh sách tệp APK được cài đặt trên thiết bị tại thời điểm khởi động.
`ram`	Số nguyên; bắt buộc Dung lượng ram tính bằng megabyte cần mô phỏng cho thiết bị. Lựa chọn này áp dụng cho toàn bộ thiết bị chứ không chỉ áp dụng cho một ứng dụng cụ thể được cài đặt trên thiết bị. Giá trị tối thiểu là 64 megabyte.
`screen_density`	Số nguyên; bắt buộc Mật độ của màn hình được mô phỏng tính bằng pixel trên inch. Giá trị tối thiểu của thuộc tính này là 30 ppi.
`system_image`	Nhãn; bắt buộc Một nhóm tệp chứa các tệp sau: system.img: Phân vùng hệ thống kernel-qemu: Nhân hệ điều hành Linux mà trình mô phỏng sẽ tải ramdisk.img: Hình ảnh khởi động để sử dụng khi khởi động userdata.img: Phân vùng dữ liệu người dùng ban đầu source.properties: Một tệp thuộc tính chứa thông tin về hình ảnh Những tệp này thuộc SDK Android hoặc do bên thứ ba cung cấp (ví dụ: Intel cung cấp hình ảnh x86).
`vertical_resolution`	Số nguyên; bắt buộc Độ phân giải màn hình dọc tính bằng pixel để mô phỏng. Giá trị tối thiểu là 240.
`vm_heap`	Số nguyên; bắt buộc Dung lượng tính bằng megabyte của vùng nhớ khối xếp máy ảo mà Android sẽ sử dụng cho mỗi quy trình. Giá trị tối thiểu là 16 megabyte.

android_ndk_repository

Xem nguồn quy tắc

android_ndk_repository(name, api_level, path, repo_mapping)

Định cấu hình Bazel sử dụng Android NDK nhằm hỗ trợ tạo mục tiêu Android bằng mã gốc.

Xin lưu ý rằng phương thức triển khai android_ndk_repository này sẽ được thay thế bằng phương thức triển khai trong Starlark. Tính năng hỗ trợ các phiên bản NDK trong tương lai (bao gồm cả phiên bản 25 trở lên) sẽ được triển khai trong phiên bản Starlark của android_ndk_repository. Vui lòng xem rules_android_ndk để biết phiên bản Starlark.

Xin lưu ý rằng việc xây dựng cho Android cũng yêu cầu quy tắc android_sdk_repository trong tệp WORKSPACE.

Để biết thêm thông tin, hãy đọc tài liệu đầy đủ về cách sử dụng Android NDK với Bazel.

Ví dụ

android_ndk_repository(
    name = "androidndk",
)

Ví dụ trên sẽ định vị Android NDK của bạn từ $ANDROID_NDK_HOME và phát hiện cấp độ API cao nhất mà Android NDK hỗ trợ.

android_ndk_repository(
    name = "androidndk",
    path = "./android-ndk-r20",
    api_level = 24,
)

Ví dụ trên sẽ sử dụng Android NDK nằm bên trong không gian làm việc của bạn trong ./android-ndk-r20. Thư viện này sẽ sử dụng thư viện API cấp 24 khi biên dịch mã JNI.

tính năng cpu

Android NDK chứa thư viện cpufeatures có thể dùng để phát hiện CPU của thiết bị trong thời gian chạy. Ví dụ sau minh hoạ cách sử dụng cpufeatures với Bazel.

# jni.cc
#include "ndk/sources/android/cpufeatures/cpu-features.h"
...

# BUILD
cc_library(
    name = "jni",
    srcs = ["jni.cc"],
    deps = ["@androidndk//:cpufeatures"],
)

Đối số

Thuộc tính
`name`	Tên; bắt buộc Tên duy nhất cho mục tiêu này.
`api_level`	Số nguyên; không thể định cấu hình; giá trị mặc định là `0` Cấp độ API Android để xây dựng. Nếu không được chỉ định, hệ thống sẽ sử dụng cấp độ API cao nhất đã cài đặt.
`path`	Chuỗi; không thể định cấu hình; giá trị mặc định là `""` Đường dẫn tuyệt đối hoặc tương đối đến một Android NDK. Bạn phải đặt thuộc tính này hoặc biến môi trường `$ANDROID_NDK_HOME`. Bạn có thể tải Android NDK xuống từ trang web dành cho nhà phát triển Android .
`repo_mapping`	Từ điển: Chuỗi -> Chuỗi; mặc định là `{}` Một từ điển từ tên kho lưu trữ cục bộ thành tên kho lưu trữ toàn cục. Điều này cho phép bạn kiểm soát hoạt động phân giải phần phụ thuộc không gian làm việc đối với các phần phụ thuộc của kho lưu trữ này. Ví dụ: một mục `"@foo": "@bar"` khai báo rằng bất cứ khi nào kho lưu trữ này phụ thuộc vào `"@foo"` (chẳng hạn như một phần phụ thuộc trên `"@foo//some:target"`), thì mục đó phải thực sự phân giải phần phụ thuộc đó trong `"@bar"` được khai báo toàn cầu (`"@bar//some:target"`).

android_sdk_repository

Xem nguồn quy tắc

android_sdk_repository(name, api_level, build_tools_version, path, repo_mapping)

Định cấu hình Bazel để sử dụng SDK Android cục bộ nhằm hỗ trợ tạo mục tiêu Android.

Ví dụ

Cách tối thiểu để thiết lập SDK Android cho Bazel là đặt quy tắc android_sdk_repository có tên "androidsdk" vào tệp WORKSPACE và đặt biến môi trường $ANDROID_HOME thành đường dẫn của SDK Android. Theo mặc định, Bazel sẽ sử dụng cấp độ API Android cao nhất và phiên bản công cụ xây dựng được cài đặt trong SDK Android.

android_sdk_repository(
    name = "androidsdk",
)

Để đảm bảo các bản dựng có thể tái tạo, bạn có thể đặt các thuộc tính path, api_level và build_tools_version thành các giá trị cụ thể. Bản dựng sẽ không thành công nếu SDK Android chưa được cài đặt phiên bản cấp độ API hoặc công cụ xây dựng đã chỉ định.

android_sdk_repository(
    name = "androidsdk",
    path = "./sdk",
    api_level = 19,
    build_tools_version = "25.0.0",
)

Ví dụ ở trên cũng minh hoạ việc sử dụng đường dẫn tương đối với không gian làm việc đến SDK Android. Điều này sẽ hữu ích nếu SDK Android nằm trong không gian làm việc Bazel của bạn (ví dụ: nếu SDK được đánh dấu vào phần quản lý phiên bản).

Thư viện hỗ trợ

Thư viện hỗ trợ có trong Trình quản lý SDK Android dưới dạng "Kho lưu trữ hỗ trợ Android". Đây là tập hợp các thư viện Android phổ biến theo phiên bản, chẳng hạn như thư viện Support và AppCompat, được đóng gói dưới dạng kho lưu trữ Maven cục bộ. android_sdk_repository tạo các mục tiêu Bazel cho mỗi thư viện có thể dùng trong các phần phụ thuộc của mục tiêu android_binary và android_library.

Tên của các mục tiêu đã tạo được lấy từ toạ độ Maven của các thư viện trong Kho lưu trữ hỗ trợ Android, có định dạng là @androidsdk//${group}:${artifact}-${version}. Ví dụ sau cho thấy cách android_library có thể phụ thuộc vào phiên bản 25.0.0 của thư viện appcompat phiên bản 7.

android_library(
    name = "lib",
    srcs = glob(["*.java"]),
    manifest = "AndroidManifest.xml",
    resource_files = glob(["res/**"]),
    deps = ["@androidsdk//com.android.support:appcompat-v7-25.0.0"],
)

Đối số

Thuộc tính
`name`	Tên; bắt buộc Tên duy nhất cho mục tiêu này.
`api_level`	Số nguyên; không thể định cấu hình; giá trị mặc định là `0` Cấp độ API Android cần xây dựng theo mặc định. Nếu không được chỉ định, hệ thống sẽ sử dụng cấp độ API cao nhất đã cài đặt. Cờ `android_sdk` có thể ghi đè cấp độ API dùng cho một bản dựng nhất định. `android_sdk_repository` tạo một mục tiêu `android_sdk` cho mỗi cấp độ API được cài đặt trong SDK với tên `@androidsdk//:sdk-${level}`, cho dù thuộc tính này có được chỉ định hay không. Ví dụ: để tạo dựa trên cấp độ API không mặc định: `bazel build --android_sdk=@androidsdk//:sdk-19 //java/com/example:app`. Để xem tất cả `android_sdk` mục tiêu do `android_sdk_repository` tạo, bạn có thể chạy `bazel query "kind(android_sdk, @androidsdk//...)"`.
`build_tools_version`	Chuỗi; không thể định cấu hình; giá trị mặc định là `""` Phiên bản của bộ công cụ xây dựng Android để sử dụng trong SDK Android. Nếu không được chỉ định, hệ thống sẽ sử dụng phiên bản mới nhất đã cài đặt của công cụ xây dựng. Bazel yêu cầu công cụ xây dựng phiên bản 30.0.0 trở lên.
`path`	Chuỗi; không thể định cấu hình; giá trị mặc định là `""` Đường dẫn tuyệt đối hoặc tương đối đến SDK Android. Bạn phải đặt thuộc tính này hoặc biến môi trường `$ANDROID_HOME`. Bạn có thể tải SDK Android xuống từ trang web dành cho nhà phát triển Android.
`repo_mapping`	Từ điển: Chuỗi -> Chuỗi; mặc định là `{}` Một từ điển từ tên kho lưu trữ cục bộ thành tên kho lưu trữ toàn cục. Điều này cho phép bạn kiểm soát hoạt động phân giải phần phụ thuộc không gian làm việc đối với các phần phụ thuộc của kho lưu trữ này. Ví dụ: một mục `"@foo": "@bar"` khai báo rằng bất cứ khi nào kho lưu trữ này phụ thuộc vào `"@foo"` (chẳng hạn như một phần phụ thuộc trên `"@foo//some:target"`), thì mục đó phải thực sự phân giải phần phụ thuộc đó trong `"@bar"` được khai báo toàn cầu (`"@bar//some:target"`).