aboutsummaryrefslogtreecommitdiffstats
path: root/README.md
diff options
context:
space:
mode:
authorColin Cross <ccross@android.com>2016-09-26 15:42:42 -0700
committerColin Cross <ccross@android.com>2016-09-26 15:44:29 -0700
commit024c32e9870a2a7d7704967eeb7764686cd69aab (patch)
treebe8078de69f9f81d0e315756cddc2a84e5de1d37 /README.md
parent0a249ce498b803656b31a6a2fd459a372e17a0a3 (diff)
downloadbuild_soong-024c32e9870a2a7d7704967eeb7764686cd69aab.tar.gz
build_soong-024c32e9870a2a7d7704967eeb7764686cd69aab.tar.bz2
build_soong-024c32e9870a2a7d7704967eeb7764686cd69aab.zip
Update readme
Use go/Android.bp link, add a little more on androidmk conversions. Test: none Change-Id: Ibe2be4ad54b6d9a8954d7efbb40d04dc54c8dbf2
Diffstat (limited to 'README.md')
-rw-r--r--README.md15
1 files changed, 13 insertions, 2 deletions
diff --git a/README.md b/README.md
index df092e73..9d3dde65 100644
--- a/README.md
+++ b/README.md
@@ -28,7 +28,7 @@ Every module must have a `name` property, and the value must be unique across
all Android.bp files.
For a list of valid module types and their properties see
-[$OUT_DIR/soong/.bootstrap/docs/soong_build.html](https://android-build.googleplex.com/builds/latest/branches/aosp-build-tools/targets/linux/soong_build.html).
+[$OUT_DIR/soong/.bootstrap/docs/soong_build.html](https://go/Android.bp).
### Variables
@@ -113,7 +113,18 @@ androidmk Android.mk > Android.bp
```
The tool converts variables, modules, comments, and some conditionals, but any
-custom Makefile rules or complex conditionals must be converted by hand.
+custom Makefile rules, complex conditionals or extra includes must be converted
+by hand.
+
+#### Differences between Android.mk and Android.bp
+
+* Android.mk files often have multiple modules with the same name (for example
+for static and shared version of a library, or for host and device versions).
+Android.bp files require unique names for every module, but a single module can
+be built in multiple variants, for example by adding `host_supported: true`.
+The androidmk converter will produce multiple conflicting modules, which must
+be resolved by hand to a single module with any differences inside
+`target: { android: { }, host: { } }` blocks.
## Build logic