diff options
author | Jingwen Chen <jingwen@google.com> | 2020-11-12 01:05:08 -0500 |
---|---|---|
committer | Jingwen Chen <jingwen@google.com> | 2020-11-12 01:37:20 -0500 |
commit | 419cf2ee68380bd7349a1e6e7b7b99853d0fbcfa (patch) | |
tree | ef5562222c61fd687dab68afa33d279821178f6a /docs | |
parent | 0edd2882e4c437e30e735612e25cc4dc56b8e581 (diff) | |
download | bazel-419cf2ee68380bd7349a1e6e7b7b99853d0fbcfa.tar.gz |
Add Android.bp and Android.mk to the build system concepts documentation.
Received from user/product feedback.
Test: N/A
Change-Id: I393e76cb4f99531336619f134ba4aff2994311e5
Diffstat (limited to 'docs')
-rw-r--r-- | docs/concepts.md | 4 |
1 files changed, 3 insertions, 1 deletions
diff --git a/docs/concepts.md b/docs/concepts.md index 851d0100..087b7936 100644 --- a/docs/concepts.md +++ b/docs/concepts.md @@ -7,11 +7,13 @@ concepts in the current Android build system and Bazel. |Android build system component|Description|Mapping to Bazel concepts| |---|---|---| -|Blueprint|Build definition syntax. Build syntax parser. Internal data structures like Modules/Variations/Context/Scope. Ninja file generator.|Starlark.| |Kati|Make-compatible front-end. Encodes build logic in `.mk` scripts. Declares buildable units in `Android.mk`. Generates Ninja file directly.|Loading and analysis phase. Conceptually similar to `bazel build --nobuild`.| +|Blueprint|Build definition syntax. Build syntax parser. Internal data structures like Modules/Variations/Context/Scope. Ninja file generator.|Starlark.| |Soong|Bazel-like front-end. Encodes build logic in Go. Declares build units in `Android.bp`, parsed by Blueprint. Uses Blueprint to generate Ninja file. Generates a `.mk` file with prebuilt module stubs to Kati.|Loading and analysis phase. Conceptually similar to `bazel build --nobuild command`.| |Ninja|Serialized command line action graph executor. Executes Ninja graph generated from Kati and Soong.|Bazel's execution phase.| |atest|Test executor and orchestrator.|Conceptually similar to `bazel test` command.| |Blueprint + Kati + Soong + Ninja + atest|The entire build pipeline for Android.|Conceptually similar to `bazel build` or `bazel test` commands.| |`<script>.sh`|Running arbitrary scripts in AOSP.|Conceptually similar to `bazel run` command.| |Make (replaced in-place by Kati)|No longer in use. Entire build system, replaced by the tools above.|Loading, analysis, execution phases. Conceptually similar to `bazel build` command.| +|`Android.bp`|Build definition file for Soong.|`BUILD.bazel` or `BUILD`.| +|`Android.mk`|Build definition file for Kati.|`BUILD.bazel` or `BUILD`.| |