Quy tắc
android_binary
Xem nguồn quy tắcandroid_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ênname_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ênname_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 tí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à 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à Hệ thống biên dịch các tệp Tệp |
assets
|
Danh sách nhãn; mặc định 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à 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à |
custom_package
|
Chuỗi; giá trị mặc định là |
debug_key
|
Nhãn; mặc định là 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à 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à 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à |
dex_shards
|
Số nguyên; giá trị mặc định là 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à |
enable_data_binding
|
Boolean; giá trị mặc định là Để 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:
|
incremental_dexing
|
Số nguyên; không thể định cấu hình; giá trị mặc định là |
instruments
|
Nhãn; mặc định là Mục tiêu Nếu bạn đặt thuộc tính này, |
javacopts
|
Danh sách chuỗi; mặc định là 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à |
main_dex_list
|
Nhãn; mặc định là android/support/multidex/MultiDex$V19.class android/support/multidex/MultiDex.class android/support/multidex/MultiDexApplication.class com/google/common/base/Objects.classPhải được sử dụng với multidex="manual_main_dex" .
|
main_dex_list_opts
|
Danh sách chuỗi; mặc định là |
main_dex_proguard_specs
|
Danh sách nhãn; mặc định là 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à
Mọi thực thể của
Khi bạn đặt |
multidex
|
Chuỗi; giá trị mặc định là Có thể dùng các giá trị sau:
|
nocompress_extensions
|
Danh sách chuỗi; mặc định là |
package_id
|
Số nguyên; giá trị mặc định là Xem đối số |
plugins
|
Danh sách nhãn; mặc định là 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à |
proguard_apply_mapping
|
Nhãn; mặc định là 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à 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 |
proguard_specs
|
Danh sách nhãn; mặc định là |
resource_configuration_filters
|
Danh sách chuỗi; mặc định là en_XA và/hoặc ar_XB .
|
resource_files
|
Danh sách nhãn; mặc định 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à 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ú ý:
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:
|
android_library
Xem nguồn quy tắcandroid_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 tí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à 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à .java hoặc .srcjar được xử lý để tạo mục tiêu.
Hệ thống biên dịch các tệp Tệp Nếu bạn bỏ qua |
assets
|
Danh sách nhãn; mặc định 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à 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à |
enable_data_binding
|
Boolean; giá trị mặc định là Để 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:
|
exported_plugins
|
Danh sách nhãn; mặc định là 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 |
exports
|
Danh sách nhãn; mặc định là 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_manifest
|
Số nguyên; giá trị mặc định là 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 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 Xem ví dụ. |
idl_parcelables
|
Danh sách nhãn; mặc định là 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 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à 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 |
idl_srcs
|
Danh sách nhãn; mặc định là 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 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 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à 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à 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à 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à 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à 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_local_test
Xem nguồn quy tắcandroid_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 tí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 quy tắc được phép trong |
srcs
|
Danh sách nhãn; mặc định là Hệ thống biên dịch các tệp Tệp 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 |
custom_package
|
Chuỗi; giá trị mặc định là test_class .
|
densities
|
Danh sách chuỗi; mặc định là |
enable_data_binding
|
Boolean; giá trị mặc định là |
javacopts
|
Danh sách chuỗi; mặc định là 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à 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à Lưu ý rằng thuộc tính này không ảnh hưởng đến dữ liệu đầu ra |
manifest
|
Nhãn; mặc định 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à 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à |
plugins
|
Danh sách nhãn; mặc định là 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à |
resource_jars
|
Danh sách nhãn; mặc định là |
resource_strip_prefix
|
Chuỗi; giá trị mặc định là
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 |
runtime_deps
|
Danh sách nhãn; mặc định là 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à
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à
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 |
use_launcher
|
Boolean; giá trị mặc định là 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ờ |
android_ndk_repository
Xem nguồn quy tắcandroid_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 tí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à |
path
|
Chuỗi; không thể định cấu hình; giá trị mặc định là $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à Ví dụ: một mục |
android_sdk_repository
Xem nguồn quy tắcandroid_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ắcandroid_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 tí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à Cờ Để xem tất cả |
build_tools_version
|
Chuỗi; không thể định cấu hình; giá trị mặc định là 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à $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à Ví dụ: một mục |