Quy tắc Android

Quy tắc

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 tệp gói ứng dụng Android (.apk).

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

  • name.apk: Một tệp gói ứng dụng Android đã ký bằng khoá gỡ lỗi và zipaligned. Tệp này có thể được dùng để phát triển và gỡ lỗi cho ứng dụng của bạn. Bạn không thể phát hành ứng dụng khi đã ký bằng các khoá gỡ lỗi.
  • name_unsigned.apk: Phiên bản chưa có chữ 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: Tệp lưu trữ Java có chứa phương thức đó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 có thể được tìm thấy bằng trình tải lớp đã tìm kiếm đường dẫn lớp thời gian chạy của mục tiêu này từ đầu đến cuối.

  • name_proguard.jar: Một tệp lưu trữ Java có chứa kết quả 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.
  • name_proguard.map: Kết quả tệp ánh xạ sau 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ể tìm thấy 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 tính
name

Name; required

Tên dành riêng cho mục tiêu này.
deps

List of labels; optional

Danh sách các thư viện khác được liên kết đến đích nhị phân. Các loại thư viện được phép là: android_library, java_library với 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 đích Android.
srcs

List of labels; optional

Danh sách các tệp nguồn được xử lý để tạo mục tiêu.

Các tệp srcs thuộc loại .java sẽ được biên dịch. Để dễ đọc, bạn không nên đặt 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.

Các tệp srcs thuộc loại .srcjar sẽ đượ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 có quy tắc tạo hoặc phần mở rộng bản dựng.)

assets

List of labels; optional

Danh sách tài sản cần đóng gói. Thường thì đây 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 (bất kỳ quy tắc nào tạo tệp) hoặc tệp được xuất trong các gói khác, miễn là tất cả các tệp đó nằm trong thư mục assets_dir trong gói tương ứng.
assets_dir

String; optional

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à bạn phải cung cấp cả hai thuộc tính hoặc không cung cấp thuộc tính nào.
crunch_png

Boolean; optional; default is True

Tạo tệp PNG nén (hoặc không). Quá trình này không phụ thuộc vào quá trình xử lý 9 bản vá (việc này luôn được thực hiện). Đây là giải pháp tạm thời không dùng nữa cho một lỗi aapt, đã được khắc phục trong aapt2.
custom_package

String; optional

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 nơi tệp BUILD có 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ì nó có thể gây ra xung đột classpath với các thư viện khác mà sẽ chỉ được phát hiện trong thời gian chạy.
debug_key

Label; optional; default is @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ông phải là 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á phát hành công khai. Chúng phải được bảo vệ nghiêm ngặt và không được lưu giữ trong cây nguồn.
debug_signing_keys

List of labels; optional

Danh sách các 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ông phải là 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á phát hành công khai. Chúng phải được bảo vệ nghiêm ngặt và không được lưu giữ trong cây nguồn.
debug_signing_lineage_file

Label; optional

Tệp chứa loạt chữ ký nối tiếp cho các khoá_ký_gỡ lỗi. Thông thường, bạn không muốn sử dụng các khoá không phải là 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á phát hành công khai. Chúng phải được bảo vệ nghiêm ngặt và không được lưu giữ trong cây nguồn.
densities

List of strings; optional

Mật độ cần lọc khi xây dựng tệp apk. Thao tác này sẽ loại bỏ các tài nguyên có thể vẽ trên đường quét không được tải trên một thiết bị có mật độ màn hình đã chỉ định, để giảm kích thước tệp 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 chưa chứa danh sách tập mẹ.
dex_shards

Integer; optional; default is 1

Số lượng phân đoạn tạo thành tệp dex phải được phân rã thành. Điều này giúp việc tạo tệp dex nhanh hơn nhiều mà không phải tốn thời gian cài đặt ứng dụng và khởi động. Tệp nhị phân càng lớn, bạn nên sử dụng càng nhiều phân đoạn. 25 là một giá trị tốt để bắt đầu thử nghiệm.

Xin lưu ý rằng mỗi phân đoạn sẽ tạo ra ít nhất một tệp dex trong ứng dụng cuối cùng. Vì lý do này, bạn không nên đặt giá trị này thành nhiều hơn 1 cho các tệp nhị phân của bản phát hành.

dexopts

List of strings; optional

Các cờ hiệu dòng lệnh bổ sung cho công cụ dx khi tạo class.dex. Có thể thay thế "Tạo biến" và mã thông báo shell shell.
enable_data_binding

Boolean; optional; default is False

Nếu đúng, quy tắc này sẽ xử lý 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ẽ tạo 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:

  1. Đặ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. Lý do là những 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 hoạt động hợp nhất tài nguyên. Vì vậy, chúng 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 đó.
  2. 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 hàng của bạn.
incremental_dexing

Integer; optional; nonconfigurable; default is -1

Buộc mục tiêu được xây dựng có hoặc không có thao tác tạo tệp dex tăng dần, ghi đè các giá trị mặc định và cờ --ly_dexing.
instruments

Label; optional

Mục tiêu android_binary cho công cụ.

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ử để 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

List of strings; optional

Các tuỳ chọn trình biên dịch bổ sung cho mục tiêu này. Có thể thay thế "Tạo biến" và mã thông báo shell shell.

Các tuỳ chọn trình biên dịch này được chuyển đến javac sau các tuỳ chọn trình biên dịch chung.
key_rotation_min_sdk

String; optional

Đặt 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ý ban đầu cho APK sẽ được dùng cho tất cả các phiên bản trước của nền tảng.
main_dex_list

Label; optional

Tệp văn bản chứa danh sách tên tệp của lớp. Các lớp do các tệp lớp đó xác định sẽ được đặt trong class.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 dùng với multidex="manual_main_dex".
main_dex_list_opts

List of strings; optional

Các tuỳ chọn dòng lệnh để chuyển đến trình tạo danh sách dex chính. Hãy sử dụng tuỳ chọn này để tác động đến các lớp có trong danh sách tệp dex chính.
main_dex_proguard_specs

List of labels; optional

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 lưu giữ trong dex chính. Chỉ được phép sử dụng nếu thuộc tính multidex được đặt thành legacy.
manifest

Label; required

Tên của tệp kê khai Android, thường là AndroidManifest.xml. Phải được xác định nếu tài nguyên hoặc tài sản được xác định.
manifest_values

Dictionary: String -> String; optional

Từ điển gồm 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 đặt từ applicationId nếu được chỉ định hoặc gói trong tệp kê khai. Khi bạn đặt manifest_merger thành phiên bản cũ, chỉ applicationId, versionCode và versionName mới có hiệu lực.
multidex

String; optional; default is "native"

Liệu có chia mã thành nhiều tệp dex hay không.
Các giá trị có thể là:
  • native: Chia mã thành nhiều tệp dex khi vượt quá giới hạn chỉ mục dex 64K. Giả định tính năng hỗ trợ nền tảng gốc cho 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: Chia 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: Chia 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 tệp văn bản sử dụng thuộc tính main_dex_list.
  • off: Biên dịch tất cả các mã thành một tệp dex duy nhất, ngay cả khi mã vượt quá giới hạn chỉ mục.
nocompress_extensions

List of strings; optional

Danh sách đuôi tệp không nén trong APK.
package_id

Integer; optional; default is 0

Mã gói sẽ được chỉ định 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. Thông thường, bạn có thể (và nên) không đặt thuộc tính này, dẫn đến giá trị mặc định là 127 (0x7F).

plugins

List of labels; optional

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

Label; optional

Tệp được dùng làm tệp ánh xạ cho Proguard. Một tệp phân tách bằng dòng gồm các "từ" để lấy khi đổi tên các lớp và thành phần trong quá trình làm rối mã nguồn.
proguard_apply_mapping

Label; optional

Tệp được dùng làm tệp ánh xạ cho Proguard. Một tệp ánh xạ do proguard_generate_mapping tạo sẽ được sử dụng lại nhằm áp dụng cùng một mục ánh xạ cho một bản dựng mới.
proguard_generate_mapping

Boolean; optional; nonconfigurable; default is 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ê thông tin ánh xạ 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ông số kỹ thuật Proguard không được chứa -dontobfuscate cũng như -printmapping.
proguard_specs

List of labels; optional

Tệp được 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

List of strings; optional

Danh sách các bộ lọc cấu hình tài nguyên, chẳng hạn như "en", sẽ giới hạn tài nguyên trong tệp APK thành các tài nguyên trong cấu hình "en". Để bật tính năng bản địa hoá giả, hãy thêm ngôn ngữ giả lập en_XA và/hoặc ar_XB.
resource_files

List of labels; optional

Danh sách các tài nguyên sẽ đóng gói. Thường thì đây là glob của mọi tệp trong thư mục res.
Nhãn cũng có thể tham chiếu các tệp đã tạo (từ genrules) 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 thư mục "res" với mọi tệp tài nguyên khác có trong đó.
shrink_resources

Integer; optional; default is -1

Liệu có tiến hành rút gọn tài nguyên hay không. Các tài nguyên mà tệp nhị phân không 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ộ (tức là các thuộc tính manifest và resource_files) và cần có ProGuard. Trình thu gọn này hoạt động gần như giống như trình thu gọn tài nguyên Gradle (https://developer.android.com/studio/build/shrink-code.html#shrink-resources).

Những khác biệt đáng chú ý:

  • tài nguyên trong values/ cũng như các tài nguyên dựa trên tệp đều sẽ bị xoá
  • sử dụng strict mode theo mặc định
  • Việc xoá các tài nguyên mã nhận dạng không sử dụng 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, thì name_files/resource_shrinker.log cũng sẽ được tạo, kèm theo thông tin chi tiết về hoạt động 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: Tính năng thu hẹp chịu sự kiểm soát của cờ --android_resource_shrinking.

aar_import 

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 các 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 tính
name

Name; required

Tên dành riêng cho mục tiêu này.
aar

Label; required

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

List of labels; optional

Mục tiêu để xuất sang các quy tắc phụ thuộc vào quy tắc này. Xem java_library.exports.
srcjar

Label; optional

Tệp JAR chứa mã nguồn cho các tệp JAR đã biên dịch trong AAR.

android_library 

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 trong một tệp .jar. Thư viện thời gian chạy Android android.jar được ngầm đặt trên đường dẫn lớp biên dịch.

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

  • libname.jar: 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 tệp lưu trữ java và các tài nguyên của mục tiêu này. Không có trạng thái đóng bắc cầu.

Ví dụ

Bạn có thể tìm thấy 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. Để //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 tính
name

Name; required

Tên dành riêng cho mục tiêu này.
deps

List of labels; optional

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 với 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 đích Android.
srcs

List of labels; optional

Danh sách các tệp .java hoặc .srcjar được xử lý để tạo mục tiêu.

Các tệp srcs thuộc loại .java sẽ được biên dịch. Để dễ đọc, bạn không nên đặt 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.

Các tệp srcs thuộc loại .srcjar sẽ đượ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 có quy tắc tạo hoặc phần mở rộng 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 qua quy tắc này (xem tệp xuất của java_library để biết thêm thông tin về cách xuất phần phụ thuộc). Tuy nhiên, hành vi này sẽ sớm ngừng hoạt động; hãy cố gắng không dựa vào nó.

assets

List of labels; optional

Danh sách tài sản cần đóng gói. Thường thì đây 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 (bất kỳ quy tắc nào tạo tệp) hoặc tệp được xuất trong các gói khác, miễn là tất cả các tệp đó nằm trong thư mục assets_dir trong gói tương ứng.
assets_dir

String; optional

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à bạn phải cung cấp cả hai thuộc tính hoặc không cung cấp thuộc tính nào.
custom_package

String; optional

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 nơi tệp BUILD có 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ì nó có thể gây ra xung đột classpath với các thư viện khác mà sẽ chỉ được phát hiện trong thời gian chạy.
enable_data_binding

Boolean; optional; default is False

Nếu đúng, quy tắc này sẽ xử lý 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ẽ tạo 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:

  1. Đặ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. Lý do là những 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 hoạt động hợp nhất tài nguyên. Vì vậy, chúng 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 đó.
  2. 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 hàng của bạn.
exported_plugins

List of labels; optional

Danh sách các java_plugin (ví dụ: trình xử lý chú giải) cần 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 phụ thuộc trực tiếp vào thư viện này, giống như thể thư viện đó đã khai báo rõ ràng các nhãn này trong plugins.

exports

List of labels; optional

Việc đóng tất cả quy tắc đạt được thông qua thuộc tính exports được coi là phần phụ thuộc trực tiếp của mọi quy tắc mà trực tiếp phụ thuộc 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à các giá trị này thuộc về.
exports_manifest

Integer; optional; default is 1

Liệu có xuất các mục nhập tệp kê khai sang những mục tiêu android_binary phụ thuộc vào mục tiêu này hay không. Các thuộc tính uses-permissions không bao giờ được xuất.
idl_import_root

String; optional

Đường dẫn tương đối với 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 thư mục gốc nhập khi xử lý các nguồn không đồng bộ phụ thuộc vào thư viện này.

Khi idl_import_root được chỉ định, cả idl_parcelables và idl_srcs đều phải nằm trong đường dẫn do gói java của đối tượng mà các giá trị này đạ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 nằm tại đường dẫn do gói chỉ định trong một gốc Java.

Hãy xem ví dụ.
idl_parcelables

List of labels; optional

Danh sách định nghĩa IDL của Android cần 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 dữ liệu 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 nguồn .java trong thư viện này (ví dụ: các hoạt động triển khai tuỳ chỉnh của Parcelable), nếu không bạn nên sử dụng idl_srcs.

Các tệp này phải được đặt một cách thích hợp để trình biên dịch aidl tìm thấy chúng. Hãy xem nội dung mô tả của idl_import_root để biết thông tin về ý nghĩa của điều này.
idl_preprocessed

List of labels; optional

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 dữ liệu 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 các tệp .aidl đã xử lý trước tương ứng trực tiếp với 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, 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 không được xử lý trước.

idl_srcs

List of labels; optional

Danh sách định nghĩa IDL của Android cần dịch sang giao diện Java. Sau khi tạo giao diện Java, các giao diện này 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 dữ liệu 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 của thư viện.

Các tệp này phải được đặt một cách thích hợp để trình biên dịch aidl tìm thấy chúng. Hãy xem nội dung mô tả của idl_import_root để biết thông tin về ý nghĩa của điều này.
javacopts

List of strings; optional

Các tuỳ chọn trình biên dịch bổ sung cho mục tiêu này. Có thể thay thế "Tạo biến" và mã thông báo shell shell.

Các tuỳ chọn trình biên dịch này được chuyển đến javac sau các tuỳ chọn trình biên dịch chung.
manifest

Label; optional

Tên của tệp kê khai Android, thường là AndroidManifest.xml. Phải được xác định nếu tài nguyên hoặc tài sản được xác định.

Boolean; optional; default is False

Chỉ sử dụng thư viện này để biên dịch và không sử 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 để tạo .apk. Hữu ích nếu thư viện sẽ được môi trường thời gian chạy cung cấp trong quá trình thực thi.
plugins

List of labels; optional

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

List of labels; optional

Tệp được dùng làm thông số kỹ thuật Proguard. Các đối tượng này sẽ mô tả tập hợp thông số kỹ thuật mà Proguard sử dụng. Nếu được chỉ định, các giá trị 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 trong thư mục này chỉ được có các quy tắc không thay đổi giá trị (idempotent) cụ thể là -dontnote, -dontwarn,remembernosideEffect 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 việc hợp nhất không tự động.
resource_files

List of labels; optional

Danh sách các tài nguyên sẽ đóng gói. Thường thì đây là glob của mọi tệp trong thư mục res.
Nhãn cũng có thể tham chiếu các tệp đã tạo (từ genrules) 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 thư mục "res" với mọi tệp tài nguyên khác có trong đó.

android_instrumentation_test 

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ử và mọi ứng dụng cần thiết khác, đồng thời chạy các hoạt động 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 bài 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 (Công cụ).

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 tính
name

Name; required

Tên dành riêng cho mục tiêu này.
support_apks

List of labels; optional

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

Label; required

android_device sẽ chạy kiểm thử trên đó.

Để chạy kiểm thử trên một trình mô phỏng đang chạy hoặc trên một thiết bị thực tế, 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

Label; required

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 thử nghiệm thông qua thuộc tính instruments.

android_local_test 

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 kiểm thử đơn vị android_library cục bộ (thay vì trên thiết bị). Công cụ này hoạt động với khung kiểm thử Robolectric của Android. 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.

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

  • name.jar: Tệp lưu trữ Java về hoạt động kiểm thử.
  • name-src.jar: Một bản lưu trữ chứa các nguồn ("nguồn") ("source jar").
  • name_deploy.jar: Một tệp lưu trữ triển khai Java phù hợp với việc triển khai (chỉ được tạo nếu đượ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:

http_archive(
    name = "robolectric",
    urls = ["https://github.com/robolectric/robolectric/archive/<COMMIT>.tar.gz"],
    strip_prefix = "robolectric-<COMMIT>",
    sha256 = "<HASH>",
)
load("@robolectric//bazel:robolectric.bzl", "robolectric_repositories")
robolectric_repositories()
Thao tác này sẽ lấy các quy tắc maven_jar 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:robolectric",
    ],
)

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

Đối số

Thuộc tính
name

Name; required

Tên dành riêng cho mục tiêu này.
deps

List of labels; optional

Danh sách các thư viện cần kiểm thử cũng như các thư viện khác cần 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 Android khi đóng bắc cầu thuộc tính này đều đượ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

List of labels; optional

Danh sách các tệp nguồn được xử lý để tạo mục tiêu. Bắt buộc trừ trường hợp đặc biệt như mô tả dưới đây.

Các tệp srcs thuộc loại .java sẽ được biên dịch. Để dễ đọc, bạn không nên đặt 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.

Các tệp srcs thuộc loại .srcjar sẽ đượ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 có quy tắc tạo hoặc phần mở rộng bản dựng.)

Mọi 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ẽ xảy ra.

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

String; optional

Gói Java mà trong đó lớp R sẽ được tạo. Theo mặc định, gói được dự đoán từ thư mục nơi tệp BUILD có chứa quy tắc. Nếu sử dụng thuộc tính này, bạn có thể cũng cần sử dụng test_class.
densities

List of strings; optional

Mật độ cần lọc khi xây dựng tệp 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 chưa chứa siêu tập hợp StarlarkListing.
enable_data_binding

Boolean; optional; default is 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 hỗ trợ tính năng liên kết dữ liệu mà bài 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 cần tạo mã ở cấp độ nhị phân và có thể gây ra lỗi bản dựng.
javacopts

List of strings; optional

Các tuỳ chọn trình biên dịch bổ sung dành cho thư viện này. Có thể thay thế "Tạo biến" và mã thông báo shell shell.

Các tuỳ chọn trình biên dịch này được chuyển đến javac sau các tuỳ chọn trình biên dịch chung.
jvm_flags

List of strings; optional

Danh sách cờ để nhúng vào tập lệnh bao bọc được tạo để chạy tệp nhị phân này. Tuân theo sự thay thế $(location) và "Make variable" (Tạo biến) và phương thức mã hoá vỏ Bourne.

Tập lệnh trình bao bọc cho 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 sẽ chứa 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, bạn phải chỉ định các đối số dành cho JVM phân tích cú pháp 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ê.

Xin lưu ý rằng thuộc tính này không ảnh hưởng đến dữ liệu đầu ra của *_deploy.jar.
manifest

Label; optional

Tên của tệp kê khai Android, thường là AndroidManifest.xml. Phải được xác định nếu tài nguyên hoặc tài sản được xác định, hoặc nếu bất kỳ tệp kê khai nào từ các thư viện đang kiểm thử có thẻ minSdkVersion.
manifest_values

Dictionary: String -> String; optional

Từ điển gồm 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. Không cần phải có tệp kê khai trong quy tắc để sử dụng manifest_values.
nocompress_extensions

List of strings; optional

Danh sách đuôi tệp không được nén trong tệp APK tài nguyên.
plugins

List of labels; optional

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. 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 chứa quy tắc này.
resource_configuration_filters

List of strings; optional

Danh sách các bộ lọc cấu hình tài nguyên, chẳng hạn như "en", sẽ giới hạn tài nguyên trong tệp APK thành các tài nguyên trong cấu hình "en".
resource_jars

List of labels; optional

Ngừng sử dụng: Thay vào đó, hãy dùng java_import và phần phụ thuộc hoặc Runtime_deps.
resource_strip_prefix

String; optional

Tiền tố đường dẫn để xoá khỏi các 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. Sẽ có lỗi khi tệp tài nguyên không nằm trong thư mục này. 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 tệp nguồn. Ví dụ: tệp nguồn ở stuff/java/foo/bar/a.txt sẽ được đặt ở foo/bar/a.txt.

runtime_deps

List of labels; optional

Các thư viện cung cấp cho tệp nhị phân cuối cùng hoặc chỉ kiểm thử trong thời gian chạy. Giống như deps thông thường, những lớp 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ư những lớp này, sẽ không xuất hiện trên đường dẫn lớp thời gian biên dịch. Các phần phụ thuộc chỉ cần thiết trong thời gian chạy sẽ được liệt kê ở đâ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

Integer; optional; default is 0

Liệu có mã hoá thông tin bản dựng vào tệp nhị phân hay không. Có thể là những giá trị sau đây:
  • 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 sử dụng chế độ cài đặt này, vì chế độ cài đặt này có thể tắt hoạt động lưu vào bộ nhớ đệm từ xa đối với tệp nhị phân và mọi thao tác xuôi dòng phụ thuộc vào chế độ cài đặt này.
  • stamp = 0: Luôn thay thế thông tin bản dựng bằng các giá trị không đổi. Chức năng này lưu kết quả bản dựng vào bộ nhớ đệm tốt.
  • stamp = -1: Việc nhúng thông tin bản dựng chịu sự kiểm soát của cờ --[no]stamp.

Tệp nhị phân được đóng dấu không được tạo lại trừ phi phần phụ thuộc của chúng thay đổi.
test_class

String; optional

Lớp Java sẽ được trình chạy kiểm thử tải.

Thuộc tính này chỉ định tên của một lớp Java sẽ chạy trong bài kiểm thử này. Hiếm khi cần phải đặt giá trị này. Nếu đối số này bị bỏ qua, 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. Lớp kiểm thử cần được chú thích bằng org.junit.runner.RunWith.

use_launcher

Boolean; optional; default is True

Liệu tệp nhị phân có nên 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 

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 tạo một trình mô phỏng Android được định cấu hình bằng 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 một 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ì tự xác định các quy tắc của riêng mình.

Quy tắc này là một mục tiêu phù hợp cho cờ --run_under để kiểm thử bazel và chạy sáng. Tính năng này khởi động 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 phù 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.

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

  • name_images/userdata.dat: Chứa các tệp hình ảnh và ảnh chụp 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 có 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à tập lệnh bắt đầu. Bạn có thể khởi động trình mô phỏng một cách cục bộ bằng cách thực thi bazel run :nexus_s -- --action=start. Tập lệnh sẽ hiển thị 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ẽ thực hiện 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 với một màn hình nếu giá trị là true (mặc định là false).
  • --hành động: Bắt đầu hoặc kết thúc.
  • --apks_to_install: danh sách các tệp APK cần cài đặt trên trình mô phỏng.

Đối số

Thuộc tính
name

Name; required

Tên dành riêng cho mục tiêu này.
cache

Integer; required

Kích thước tính bằng megabyte phân vùng bộ nhớ đệm của trình mô phỏng. Giá trị tối thiểu của tham số này là 16 megabyte.
default_properties

Label; optional

Một tệp thuộc tính duy nhất cần được đặt trong /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 một thiết bị thực tế 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 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ể đọc thường do trình mô phỏng đặt, chẳng hạn như ro.product.model.
horizontal_resolution

Integer; required

Độ 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

List of labels; optional

Danh sách tệp APK được cài đặt trên thiết bị khi khởi động.
ram

Integer; required

Lượng ram tính bằng megabyte để mô phỏng cho thiết bị. Phương thức này áp dụng cho toàn bộ thiết bị, không chỉ 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

Integer; required

Mật độ của màn hình được mô phỏng tính bằng pixel/inch. Giá trị tối thiểu của chỉ số này là 30 ppi.
system_image

Label; required

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 Linux mà trình mô phỏng sẽ tải
  • ramdisk.img: Hình ảnh ban đầu để sử dụng khi khởi động
  • userdata.img: Phân vùng dữ liệu người dùng ban đầu
  • source.properties: Tệp thuộc tính chứa thông tin về hình ảnh
Các tệp này là một phần của SDK Android hoặc do bên thứ ba cung cấp (ví dụ: Intel cung cấp hình ảnh x86).
vertical_resolution

Integer; required

Độ 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

Integer; required

Kích thước 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 quá trình. Giá trị tối thiểu là 16 megabyte.

android_ndk_repository 

android_ndk_repository(name, api_level, path, repo_mapping)

Định cấu hình Bazel để sử dụng Android NDK nhằm hỗ trợ xây dựng mục tiêu Android bằng mã gốc.

Xin lưu ý rằng việc tạo bản dựng cho Android cũng yêu cầu có 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à nền tảng 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. Nền tảng 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 các tính năng cpu bằng 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 tính
name

Name; required

Tên dành riêng cho mục tiêu này.
api_level

Integer; optional; nonconfigurable; default is 0

Cấp độ API Android để xây dựng. Nếu bạn không chỉ định, hệ thống sẽ sử dụng cấp độ API cao nhất được cài đặt.
path

String; optional; nonconfigurable

Đườ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

Dictionary: String -> String; optional

Từ điển, từ tên kho lưu trữ cục bộ đến tên kho lưu trữ toàn cục. Nhờ vậy, bạn có thể kiểm soát quá trình phân giải phần phụ thuộc không gian làm việc cho 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ì kho lưu trữ đó sẽ thực sự phân giải phần phụ thuộc đó trong "@bar" được khai báo toàn cục ("@bar//some:target").

android_sdk_repository 

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

Định cấu hình Bazel để sử dụng một SDK Android cục bộ nhằm hỗ trợ việc xây dựng các mục tiêu Android.

Ví dụ

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

Để đảm bảo các bản dựng có thể mô phỏng, bạn có thể đặt 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ài đặt phiên bản công cụ xây dựng hoặc cấp độ API được 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 đến không gian làm việc đến SDK Android. Việc này rất 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 này đượ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à một tập hợp các thư viện Android phổ biến được tạo phiên bản, chẳng hạn như Thư viện hỗ trợ và AppCompat, được đóng gói dưới dạng một 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 trong số này 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 Android Support Repository (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 tính
name

Name; required

Tên dành riêng cho mục tiêu này.
api_level

Integer; optional; nonconfigurable; default is 0

Cấp độ API Android để xây dựng theo mặc định. Nếu bạn không chỉ định, hệ thống sẽ sử dụng cấp độ API cao nhất được cài đặt.

Cấp độ API dùng cho một bản dựng nhất định có thể bị cờ android_sdk ghi đè. android_sdk_repository tạo một mục tiêu android_sdk cho từng 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 bản dựng 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ả các mục tiêu android_sdk do android_sdk_repository tạo, bạn có thể chạy bazel query "kind(android_sdk, @androidsdk//...)".

build_tools_version

String; optional; nonconfigurable

Phiên bản công cụ xây dựng Android để sử dụng từ bên trong SDK Android. Nếu bạn không chỉ định, hệ thống sẽ sử dụng phiên bản công cụ xây dựng mới nhất đã cài đặt.

Bazel yêu cầu công cụ xây dựng phiên bản 30.0.0 trở lên.

path

String; optional; nonconfigurable

Đườ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

Dictionary: String -> String; optional

Từ điển, từ tên kho lưu trữ cục bộ đến tên kho lưu trữ toàn cục. Nhờ vậy, bạn có thể kiểm soát quá trình phân giải phần phụ thuộc không gian làm việc cho 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ì kho lưu trữ đó sẽ thực sự phân giải phần phụ thuộc đó trong "@bar" được khai báo toàn cục ("@bar//some:target").