Android.bp 语法浅析

最新推荐文章于 2025-12-06 12:36:53 发布

转载最新推荐文章于 2025-12-06 12:36:53 发布 · 5.5k 阅读

18 ·

CC 4.0 BY-SA版权

原文链接：Android.bp 语法浅析

Android 同时被 2 个专栏收录

73 篇文章

订阅专栏

Java

2 篇文章

订阅专栏

本文介绍了Android构建系统的演变，从传统的Makefile和Android.mk到Android.bp的过渡。Android 7.0引入了Ninja提高构建速度，并使用kati将Android.mk转换为Ninja文件。从Android 8.0开始，Android.bp成为主要配置文件，简化了构建过程。Android.bp定义了模块类型，如cc_library_shared，包含了编译、依赖库等信息。同时，文章提供了一个Android.bp的实际示例，展示了如何配置应用程序模块。转换工具androidmk可以将Android.mk转为Android.bp，但复杂的规则需手动调整。

随着 android 工程越来越大，包含的 module 越来越多，以 makefile 组织的项目编译花费的时间越来越多。Google 在 7.0 引入了 ninja 是 Google 的一名程序员推出的注重速度的构建工具，一般在 Unix/Linux 上的程序通过 make/makefile 来构建编译，而 Ninja 通过将编译任务并行组织，大大提高了构建速度。

7.0 的时候 android 项目还是有大部分是由 makefile 来组织的，因此 Google 引入了 kati 将 makefile 翻译成 ninja 文件。8.0 开始，android 引入了 Android.bp 来替代之前的 Android.mk 文件，不同于Android.mk，Android.bp只是纯粹的配置文件，不包括分支、循环等流程控制。在 android 项目上如何进行选择编译、解析配置、转换成 ninja 等，Soong 就被创造出来，将 Android.bp 转换为ninja文件进行管理。

简而言之，kati 把 bp 直接翻译成 ninja，blueprint / soong 则把 bp 翻译成 ninja。

Android.bp --> Blueprint --> Soong --> Ninja
Makefile or Android.mk --> kati --> Ninja

1. 模块

cc_library_shared {				//编译成动态库，类似于Android.mk中的BUILD_SHARED_LIBRARY
    name: "libbluetooth_jni",	//编译出的模块的名称，类似于Android.mk中的LOCAL_MODULE
    srcs: [ 					//源文件，类似于Android.mk中的LOCAL_SRC_FILES
        "com_android_bluetooth_btservice_AdapterService.cpp"
    ],
    include_dirs: [				//用户指定的头文件查找路径，类似于Android.mk中的LOCAL_C_INCLUDES
        "libnativehelper/include/nativehelper",
        "system/bt/types",
    ],
    shared_libs: [				//编译所依赖的动态库，类似于Android.mk中的LOCAL_SHARED_LIBRARIES
        "libandroid_runtime",
        "libchrome",
    ],
    static_libs: [				//编译所依赖的静态库，类似于Android.mk中的LOCAL_STATIC_LIBRARIES
        "libbluetooth-types",
    ],
    cflags: [					///编译flag,类似于Android.mk中的LOCAL_CFLAGS
        "-Wall",
        "-Wextra",
        "-Wno-unused-parameter",
    ],
}
subdirs = ["subdir1", "subdir2"]

定义一个模块从模块的类型开始，模块有不同的类型，上面例子中的 cc_library_shared 声明编译成动态库，当然类型还有很多种，譬如 cc_binary android_app、cc_library_static 等等。模块包含一些属性格式为 property-name:property-value，其中name属性必须指定，其属性值必须是全局唯一的。

动态库：可以被 install/copy 到应用程序包（apk）
静态库：可以被链接入动态库

name : 模块的名称
src : 模块的源码
include_dirs : 指定的头文件查找路径
shared_libs : 编译时依赖的动态库
static_libs : 编译时依赖的静态库
subdirs : 是一个文件级的顶层属性，指定后会查找次级目录下的Android.bp。

2. 示例

我们来看一下，android 中一个实际的 bp 文件：

android_app {
    name: "NFC",
    srcs: [
        "src/**/*.java",
        "nci/**/*.java",
        ":statslog-Nfc-java-gen",
    ],
    platform_apis: true,
    certificate: "platform",
    jni_libs: ["libsn100nfc_nci_jni"],
    libs: ["com.nxp.nfc.nq"],
    static_libs: [
        "androidx.appcompat_appcompat",
        "nearme_nfc",
        ],
    optimize: {
        enabled: true,
        obfuscate: true,
        proguard_flags_files: ["proguard.flags"],
    },
}

java_import {
    name: "nearme_nfc",
    host_supported: true,
    jars: [
        "libs/env.jar",
    ],
}

platform_apis : 用 sdk 的 hide 的 api 來编译
certificate : 指定用的是什么签名，如上用的是 platform 签名。
jni_libs : 依赖使用的 JNI 库
libs : 工程中的 libs 库
static_libs : 静态库，其中 nearme_nfc 为下方定义的：java_import
optimize : 压缩配置，enabled 是否开启，obfuscate 是否开启混淆，proguard_flags_files 混淆规则配置文件
host_supported : Android.bp 文件要求每个模块拥有唯一的名称，但每个模块可以内置多种变化，例如可以添加 host_supported: true。