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 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ênname_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ê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ể 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 |
Tên dành riêng cho mục tiêu này. |
deps
|
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
|
Các tệp Các tệp |
assets
|
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
|
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
|
|
custom_package
|
|
debug_key
|
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
|
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
|
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
|
|
dex_shards
|
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
|
|
enable_data_binding
|
Để 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
|
|
instruments
|
Mục tiêu Nếu bạn đặt thuộc tính này, |
javacopts
|
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
|
|
main_dex_list
|
android/support/multidex/MultiDex$V19.class android/support/multidex/MultiDex.class android/support/multidex/MultiDexApplication.class com/google/common/base/Objects.classPhải được dùng với multidex="manual_main_dex" .
|
main_dex_list_opts
|
|
main_dex_proguard_specs
|
multidex được đặt thành legacy .
|
manifest
|
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
|
|
multidex
|
Các giá trị có thể là:
|
nocompress_extensions
|
|
package_id
|
Xem đối số |
plugins
|
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
|
|
proguard_apply_mapping
|
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
|
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 |
proguard_specs
|
|
resource_configuration_filters
|
en_XA và/hoặc ar_XB .
|
resource_files
|
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
|
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ú ý:
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:
|
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 |
Tên dành riêng cho mục tiêu này. |
aar
|
.aar để cung cấp cho các mục tiêu Android phụ thuộc vào mục tiêu này.
|
exports
|
|
srcjar
|
|
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 |
Tên dành riêng cho mục tiêu này. |
deps
|
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
|
.java hoặc .srcjar được xử lý để tạo mục tiêu.
Các tệp Các tệp Nếu bạn bỏ qua |
assets
|
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
|
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
|
|
enable_data_binding
|
Để 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
|
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 |
exports
|
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_manifest
|
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
|
Đườ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 Hãy xem ví dụ. |
idl_parcelables
|
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 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
|
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 |
idl_srcs
|
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 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
|
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
|
AndroidManifest.xml .
Phải được xác định nếu tài nguyên hoặc tài sản được xác định.
|
neverlink
|
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
|
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
|
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
|
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 |
Tên dành riêng cho mục tiêu này. |
support_apks
|
|
target_device
|
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_app
|
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 |
Tên dành riêng cho mục tiêu này. |
deps
|
Danh sách các quy tắc được phép trong |
srcs
|
Các tệp Các tệp 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 |
custom_package
|
test_class .
|
densities
|
|
enable_data_binding
|
|
javacopts
|
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
|
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à Xin lưu ý rằng thuộc tính này không ảnh hưởng đến dữ liệu đầu ra của |
manifest
|
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
|
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
|
|
plugins
|
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
|
|
resource_jars
|
|
resource_strip_prefix
|
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
|
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
|
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
|
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 |
use_launcher
|
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_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ỏngname_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 |
Tên dành riêng cho mục tiêu này. |
cache
|
|
default_properties
|
|
horizontal_resolution
|
|
platform_apks
|
|
ram
|
|
screen_density
|
|
system_image
|
|
vertical_resolution
|
|
vm_heap
|
|
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 |
Tên dành riêng cho mục tiêu này. |
api_level
|
|
path
|
$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
|
Ví dụ: một mục |
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ắcandroid_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 |
Tên dành riêng cho mục tiêu này. |
api_level
|
Cấp độ API dùng cho một bản dựng nhất định có thể bị cờ Để xem tất cả các mục tiêu |
build_tools_version
|
Bazel yêu cầu công cụ xây dựng phiên bản 30.0.0 trở lên. |
path
|
$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
|
Ví dụ: một mục |