Android.bp语法和使用方法讲解

Android.bp语法和使用方法讲解

什么是Android.bp文件

Android.bp是一个Makefile与Blueprints的结合。

Makefile是一个类Unix系统的编译构建最常用的工具之一。使用Makefile可以定义目标和规则，递归的去解决目标之间的依赖关系，实现自动化构建的过程。

Blueprints是Google提出的Android构建系统。它通过类似Make的文件来定义模块，然后生成构建系统所需的构建配置。

Android.bp文件是融合了两种工具的思想和功能的文件。

Android.bp语法

Android.bp 使用了一种自己的基于Python的Mini语言，以定义模块：

module_type {
    name: "module_name",
    property1: value1,
    property2: value2,
    ...
}

注释

单行注释：

# 这是一条单行注释

多行注释：

/* 这是多行注释
   这是多行注释
   这是多行注释 */

属性

Android.bp支持以下类型的属性：

• string
• boolean
• list of strings
• list of modules
• module
• dict
• int
• host required boolean

常见的属性:

• name: 模块的名字。
• srcs: 模块的输入文件
• src: 模块的输入文件(单个)
• cflags: CFLAGS定义编译选项

具体用法可以参考文档。

常见的module_type

module_type定义了模块类型。

• cc_binary()：用于编译可执行文件的模块
• cc_library_static()：用于编译静态库的模块
• cc_library_shared()：用于编译动态库的模块
• java_library()：用于编译Java类库的模块
• java_binary()：用于包含主要方法的Java应用程序的模块

Android.bp使用

一个最简单的Android.bp文件

cc_binary {
    name: "hello_world",
    srcs: ["hello_world.c"],
}

该文件为一个最简单的Android.bp文件，用于编译hello_world.c成为可执行文件hello_world。

Android.bp使用示例

下面是一个完整的Android.bp文件，用于编译一个包含多个文件的库并链接到其他库：

cc_library_shared {
    name: "libmy_shared_library",
    srcs: [
        "source1.c",
        "source2.c",
        "source3.c",
    ],
    export_include_dirs: ["include"],
    arch: "arm64",
    shared_libs: ["libc", "libz"],
}

其中：

• name：模块的名称
• srcs：该模块使用的源码文件，可以使用通配符来声明多个文件
• export_include_dirs：需要导出的头文件的路径，其他模块可以使用该库时，可以调用这些头文件；如果不需要导出头文件，可以省略该属性
• arch：要编译的CPU体系结构
• shared_libs：要链接的其他库。

总结

Android.bp是Android构建系统的重要组成部分。Android.bp可以让我们定义模块和规则，以便系统能够自动执行构建操作。熟悉Android.bp的语法和常见的module_type的使用方法，可以让我们更好地编写清晰和容易维护的项目代码。