Merge remote-tracking branch 'aosp/upstream-pre-alpha' into update-rules_android am: 219e8b42b9 am: dbcbbb2c9a am: 78dafa3af2 am: 5b733a7bee

Original change: https://android-review.googlesource.com/c/platform/external/bazelbuild-rules_android/+/1907391

Change-Id: I96f3664a63711574baa695f0a24a9bde5966a80e
tree: 852e73e45af48623c78a152bdd5dc38f8a4986ab
  1. .bazelci/
  2. rules/
  3. src/
  4. test/
  5. toolchains/
  6. tools/
  7. AUTHORS
  8. BUILD
  9. CONTRIBUTING.md
  10. CONTRIBUTORS
  11. defs.bzl
  12. LICENSE
  13. METADATA
  14. MODULE_LICENSE_APACHE2
  15. README.md
  16. WORKSPACE
README.md

Android support in Bazel

Disclaimer

NOTE: This branch contains a development preview of the Starlark implementation of Android rules for Bazel. This code is incomplete and may not function as-is.

A version of Bazel built at or near head and the following flags are necessary to use these rules:

--experimental_enable_android_migration_apis
--experimental_google_legacy_api
--incompatible_java_common_parameters
--android_databinding_use_v3_4_args
--experimental_android_databinding_v2

Overview

This repository contains the Starlark implementation of Android rules in Bazel.

The rules are being incrementally converted from their native implementations in the Bazel source tree.

For the list of Android rules, see the Bazel documentation.

Getting Started

To use the new Bazel Android rules, add the following to your WORKSPACE file:

load("@bazel_tools//tools/build_defs/repo:http.bzl", "http_archive")
http_archive(
    name = "build_bazel_rules_android",
    urls = ["https://github.com/bazelbuild/rules_android/archive/refs/heads/pre-alpha.zip"],
    strip_prefix = "rules_android-pre-alpha",
)
load("@build_bazel_rules_android//:defs.bzl", "rules_android_workspace")
rules_android_workspace()

register_toolchains(
  "@build_bazel_rules_android//toolchains/android:android_default_toolchain",
  "@build_bazel_rules_android//toolchains/android_sdk:android_sdk_tools",
)

Then, in your BUILD files, import and use the rules:

load("@build_bazel_rules_android//rules:rules.bzl", "android_library")
android_library(
    ...
)