Clean up Android and Bazel documentation page
Introduce sections for improved flow
Remove "Android and New Rules" section. The links are already broken, and we're moving Android rule extensions to rules_android anyway.
RELNOTES: None.
@@ -9,7 +9,7 @@ This page contains resources that help you use Bazel with Android projects. It
links to a tutorial, build rules, and other information specific to building
Android projects with Bazel.
-## Working with Bazel
+## Getting started
The following resources will help you work with Bazel on Android projects:
@@ -18,37 +18,28 @@ The following resources will help you work with Bazel on Android projects:
to build Android apps with Bazel.
* [Codelab: Building Android Apps with Bazel](https://codelabs.developers.google.com/codelabs/bazel-android-intro/index.html).
This codelab explains how to build Android apps with Bazel.
+
+## Features
+
+Bazel has Android rules for building and testing Android apps, integrating with
+the SDK/NDK, and creating emulator images. There are also Bazel plugins for
+Android Studio and IntelliJ.
+
* [Android rules](https://docs.bazel.build/versions/master/be/android.html).
The Build Encyclopedia describes the rules you can use to build and test
Android apps with Bazel.
-* [`mobile-install` for Android](mobile-install.html). Bazel's `mobile-install`
- feature provides automated build-and-deploy functionality for building and
- testing Android apps directly on Android devices and emulators.
* [Integration with Android Studio](ide.html). Bazel is compatible with
Android Studio using the [Android Studio with Bazel](https://ij.bazel.build/)
plugin.
-* Bazel supports [Android instrumentation testing](https://docs.bazel.build/versions/master/android-instrumentation-test.html).
-* Learn how to use the [Android NDK with Bazel](https://docs.bazel.build/versions/master/android-ndk.html).
-* Learn [How Android Builds Work in Bazel](https://blog.bazel.build/2018/02/14/how-android-builds-work-in-bazel.html).
-
-## Android and new rules
-
-**Note**: Creating new rules is for advanced build and test scenarios.
-You do not need it when getting started with Bazel.
-
-The following modules, configuration fragments, and providers will help you
-[extend Bazel's capabilities](https://docs.bazel.build/versions/master/skylark/concepts.html)
-when building your Android projects:
-
-* Modules:
-
- * [`android_common`](skylark/lib/AndroidSkylarkApiProvider.html)
- * [`AndroidSkylarkIdlInfo`](skylark/lib/AndroidSkylarkIdlInfo.html)
-
-* Configuration fragments:
-
- * [`android`](skylark/lib/android.html)
+* [`mobile-install` for Android](mobile-install.html). Bazel's `mobile-install`
+ feature provides automated build-and-deploy functionality for building and
+ testing Android apps directly on Android devices and emulators.
+* [Android instrumentation testing](https://docs.bazel.build/versions/master/android-instrumentation-test.html)
+ on emulators and devices.
+* [Android NDK integration](https://docs.bazel.build/versions/master/android-ndk.html).
+ Bazel supports compiling to native code through direct NDK integration and
+ the C++ rules.
-* Providers:
+## Further reading
- * [`android`](skylark/lib/AndroidSkylarkApiProvider.html)
+* Learn [How Android Builds Work in Bazel](https://blog.bazel.build/2018/02/14/how-android-builds-work-in-bazel.html).
