Merge remote-tracking branch 'aosp/upstream-pre-alpha' into abranch am: fd1a7ff97e

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

Change-Id: Id8a2398aa221b071804bdbee3e12fb21dcf7ba3e
Signed-off-by: Automerger Merge Worker <android-build-automerger-merge-worker@system.gserviceaccount.com>
tree: e6c304846e835e87704ec5109b1300fface88f8e
  1. .bazelci/
  2. examples/
  3. kokoro/
  4. rules/
  5. src/
  6. test/
  7. toolchains/
  8. tools/
  9. .bazelrc
  10. .gitignore
  11. AUTHORS
  12. BUILD
  13. CONTRIBUTING.md
  14. CONTRIBUTORS
  15. defs.bzl
  16. groups
  17. LICENSE
  18. METADATA
  19. MODULE_LICENSE_APACHE2
  20. project.config
  21. README.md
  22. 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(
    ...
)