android bp文件_Android.bp学习笔记
1.Android.bp简介
Android 7.0之后希望用Android.bp替换Android.mk，bp简单的配置更方便Ninja 文件的产生，而Blueprint和Soong 就此产生。Android 利用Blueprint和Soong 来解析bp文件，经过最终转换为ninja files。 Blueprint和Soong都是由Golang写的项目。 从Android Nougat开始，prebuilts/go/ 目录下新增了Golang所需的运行环境，在编译时使用。Android.bp以及相关支持，从Android Nougat开始加入，从 Android Oreo(8.0)开始默认开启。 如果需要在Android Nougat的版本使用，需要在执行编译时添加变量: make 'USE_SOONG=true' Soong是以前Android基于make的编译系统的替代品。它以Android.bp文件替代Android.mk，Android.bp文件用类似JSON的简洁声明来描述需要构建的模块。
2.例子1
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","[email protected]","libhidlbase","libbase",
],
}
2.其它可用选项
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,
4.官方最全解释
Android.bp Build Docs (android-8.0.0-r9)：http://note.qidong.name/demo/soong_build/
5.变量
Android.bp文件可包含顶级变量赋值：
test_srcs = ["src/test.c"],
cc_binary {
name:"test",
srcs: test_srcs,
}
变量范围限定为声明它们的文件的其余部分，以及任何子蓝图文件。变量是不可变的，但有一个例外 —— 它们可以附上+= 赋值，但仅在变量被引用之前。
6.注释
注释方式，与Golang类似。 支持行注释//与块注释/* block */。
7.操作符
除了赋值的 = 以外，只有 + 。
8.默认模块
默认模块可用于在多个模块中重复相同的属性。
cc_defaults {
name:"test_defaults",
shared_libs: ["libz"],
stl:"none",
}
cc_binary {
name:"test1",
defaults: ["test_defaults"],
srcs: ["src/test/test1.c"],
}
9.常用工具
(1)bpfmt 一个是格式化工具bpfmt。 与gofmt类似，可以格式化Blueprint文件。 (其实，代码基本上都是从gofmt复制而来。)eg 格式化当前目录及其递归子目录下的所有Android.bp： # bpfmt -w .
(2)androidmk 另一个是androidmk，负责转换Android.mk为Android.bp, eg: # androidmk Android.mk > Android.bp
10.工具链关系
Android.mk、Android.bp、Soong、Blueprint、Ninja 简单的方式表达这几个概念之间的作用关系
Android.bp --> Blueprint --> Soong --> Ninja
Makefile or Android.mk --> kati --> Ninja Android.mk --> Soong --> Blueprint --> Android.bp
11.针对不同系统进行编译
system/core/libusbhost$ cat Android.bp
cc_library {
name:"libusbhost",
vendor_available:true,
vndk: {
enabled:true,
},
host_supported:true,
srcs: ["usbhost.c"],
cflags: ["-Werror"],
export_include_dirs: ["include"],
target: {
android: {//编译Android上运行的程序
cflags: ["-g","-DUSE_LIBLOG",
],
shared_libs: ["liblog"],
},
darwin: {//编译darwin上运行的程序
enabled: false,
},
},
}