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",

        "android.hardware.halnode@1.0",

        "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,

        },

    },

}

巴特西

Android.bp学习笔记

最新文章

热门文章