diff options
author | Colin Cross <ccross@android.com> | 2016-09-26 15:42:42 -0700 |
---|---|---|
committer | Colin Cross <ccross@android.com> | 2016-09-26 15:44:29 -0700 |
commit | 024c32e9870a2a7d7704967eeb7764686cd69aab (patch) | |
tree | be8078de69f9f81d0e315756cddc2a84e5de1d37 /README.md | |
parent | 0a249ce498b803656b31a6a2fd459a372e17a0a3 (diff) | |
download | build_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.md | 15 |
1 files changed, 13 insertions, 2 deletions
@@ -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 |