理解Android.bp

一、简介
早期的Android系统都是采用Android.mk的配置来编译源码，从Android 7.0开始引入Android.bp。很明显Android.bp的出现就是为了替换掉Android.mk。

再来说一说跟着Android版本相应的发展演变过程:

Android 7.0引入ninja和kati
Android 8.0使用Android.bp来替换Android.mk，引入Soong
Android 9.0强制使用Android.bp
转换关系图如下：

android_build;

通过Kati将Android.mk转换成ninja格式的文件，通过Blueprint+ Soong将Android.bp转换成ninja格式的文件，通过androidmk将将Android.mk转换成Android.bp，但针对没有分支、循环等流程控制的Android.mk才有效。

这里涉及到Ninja, kati, Soong, bp概念，接下来分别简单介绍一下。

1. Ninja
   ninja是一个编译框架，会根据相应的ninja格式的配置文件进行编译，但是ninja文件一般不会手动修改，而是通过将Android.bp文件转换成ninja格文件来编译。

2. Android.bp
   Android.bp的出现就是为了替换Android.mk文件。bp跟mk文件不同，它是纯粹的配置，没有分支、循环等流程控制，不能做算数逻辑运算。如果需要控制逻辑，那么只能通过Go语言编写。

3. Soong
   Soong类似于之前的Makefile编译系统的核心，负责提供Android.bp语义解析，并将之转换成Ninja文件。Soong还会编译生成一个androidmk命令，用于将Android.mk文件转换为Android.bp文件，不过这个转换功能仅限于没有分支、循环等流程控制的Android.mk才有效。

4. Blueprint
   Blueprint是生成、解析Android.bp的工具，是Soong的一部分。Soong负责Android编译而设计的工具，而Blueprint只是解析文件格式，Soong解析内容的具体含义。Blueprint和Soong都是由Golang写的项目，从Android 7.0，prebuilts/go/目录下新增Golang所需的运行环境，在编译时使用。

5. Kati
   kati是专为Android开发的一个基于Golang和C++的工具，主要功能是把Android中的Android.mk文件转换成Ninja文件。代码路径是build/kati/，编译后的产物是ckati。

二、Android.bp语法
Android.bp是一种纯粹的配置文件，设计简单，没有条件判断或控制流语句，采用在Go语言编写控制逻辑。

Android.bp文件记录着模块信息，每一个模块以模块类型开始，后面跟着一组模块的属性，以名值对(name: value)表示，每个模块都必须有一个 name属性。基本格式，以frameworks/base/services/Android.bp文件为例

java_library {
name: “services”,

dex_preopt: {
    app_image: true,
    profile: "art-profile",
},

srcs: [
    "java/**/*.java",
],

static_libs: [
    "services.core",
    "services.accessibility",
    "services.appwidget",
    "services.autofill",
    "services.backup",
    "services.companion",
    "services.coverage",
    "services.devicepolicy",
    "services.midi",
    "services.net",
    "services.print",
    "services.restrictions",
    "services.usage",
    "services.usb",
    "services.voiceinteraction",
    "android.hidl.base-V1.0-java",
],

libs: [
    "android.hidl.manager-V1.0-java",
    "miuisdk",
    "miuisystemsdk"
],

}

cc_library_shared {
name: “libandroid_servers”,
defaults: [“libservices.core-libs”],
whole_static_libs: [“libservices.core”],
}

再附一个带解释的例子
cc_binary { //编译成可执行文件，cc_library_shared编译成动态库
name: “bt_test”, //编译出的可执行文件的名字为bt_test
vendor: true, //编译出来放在/vendor目录下(默认是放在/system目录下)
srcs: [“bt_test.cpp”], //源文件，格式[“a.cpp”, “b.cpp”]
cflags: [
“-Wall”,
“-Werror”,
“-Wno-unused-parameter”,
], //编译flag
include_dirs: [
“hardware/interfaces/halnode/1.0/default”, //用户值定的头文件查找路径
],
shared_libs: [ //编译依赖的动态库
“liblog”,
“libutils”,
“libhidltransport”,
“android.hardware.halnode@1.0”,
“libhidlbase”,
“libbase”,
],
}

其它可用选项
subdirs = [“ndk”] 　　//指定进入下层ndk目录进行编译
export_include_dirs: [ 　　//从其他模块添加头文件检索路径 “include”, “include/camera” ],
export_shared_lib_headers: [“libcamera_metadata”],
local_include_dirs: [“aidl”], 　　//如果从当前目录添加路径时使用，将./aidl目录加入头文件的搜索路径
static_libs: [“libupdater”], 　　//指定对库libupdater进行静态链接 static_executable: true,

官方最全解释
Android.bp Build Docs (android-8.0.0-r9)：http://note.qidong.name/demo/soong_build/