Using Bzlmod with Bazel 6 or greater
- (Bazel 6 only) Enable with
common --enable_bzlmod
in.bazelrc
. - Add to your
MODULE.bazel
file:
bazel_dep(name = "rules_android", version = "0.6.0")
Using WORKSPACE
Paste this snippet into your WORKSPACE.bazel
file:
load("@bazel_tools//tools/build_defs/repo:http.bzl", "http_archive")
http_archive(
name = "rules_android",
sha256 = "af84b69ab3d16dd1a41056286e6511f147a94ccea995603e13e934c915c1631c",
strip_prefix = "rules_android-0.6.0",
url = "https://github.com/bazelbuild/rules_android/releases/download/v0.6.0/rules_android-v0.6.0.tar.gz",
)
# Android rules dependencies
load("@rules_android//:prereqs.bzl", "rules_android_prereqs")
rules_android_prereqs()
##### rules_java setup for rules_android #####
load("@rules_java//java:rules_java_deps.bzl", "rules_java_dependencies")
rules_java_dependencies()
# note that the following line is what is minimally required from protobuf for the java rules
# consider using the protobuf_deps() public API from @com_google_protobuf//:protobuf_deps.bzl
load("@com_google_protobuf//bazel/private:proto_bazel_features.bzl", "proto_bazel_features") # buildifier: disable=bzl-visibility
proto_bazel_features(name = "proto_bazel_features")
# register toolchains
load("@rules_java//java:repositories.bzl", "rules_java_toolchains")
rules_java_toolchains()
##### rules_jvm_external setup for rules_android #####
load("@rules_jvm_external//:repositories.bzl", "rules_jvm_external_deps")
rules_jvm_external_deps()
load("@rules_jvm_external//:setup.bzl", "rules_jvm_external_setup")
rules_jvm_external_setup()
##### rules_android setup #####
load("@rules_android//:defs.bzl", "rules_android_workspace")
rules_android_workspace()
# Android SDK setup
load("@rules_android//rules:rules.bzl", "android_sdk_repository")
android_sdk_repository(
name = "androidsdk",
)
register_toolchains(
"@rules_android//toolchains/android:android_default_toolchain",
"@rules_android//toolchains/android_sdk:android_sdk_tools",
)
In BUILD
Load the rules from rules_android
:
load("@rules_android//rules:rules.bzl", "android_binary", "android_library")
android_binary(
...
)
android_library(
...
)
Release notes
Highlights:
- Compatibility with {Bazel 7, Bazel 8} x {bzlmod, WORKSPACE} x {Linux, Mac, Windows}
- Starlark implementations of all Android rules
- Note:
android_ndk_repository
is migrated to https://github.com/bazelbuild/rules_android_ndk, andandroid_instrumentation_test
is migrated to https://github.com/bazelbuild/rules_utp
- Note:
- Starlark implementations of all Android providers
- Bazel Android Tools are migrated from the Bazel repo to the rules_android repo
--experimental_enable_android_migration_apis
and--experimental_google_legacy_api
are no longer required- Fully integrated mobile-install v3 and its related tools
- Support Java 11+ compilation
Other Changes:
- Support ANDROID_HOME paths relative to the workspace
- Generate a split APK per native architecture in fat builds.
- Updated to newer versions of rules_java, protobuf, rules_jvm_external, rules_robolectric, and others rules