Android.bp文件首先是Android系统的一种编译配置文件，是用来代替原来的Android.mk文件的。在Android7.0以前，Android都是使用make来组织各模块的编译，对应的编译配置文件就是Android.mk。在Android7.0开始，Google引入了ninja和kati来编译，为什么引入ninja？因为随着Android越来越庞大，module越来越多，编译时间也越来越久，而使用ninja在编译的并发处理上较make有很大的提升。Ninja的配置文件就是Android.bp，Android系统使用Blueprint和Soong工具来解析Android.bp转换生成ninja文件。为了兼容老的mk配置文件，Android当初也开发了Kati 工具来转换mk文件生成ninja，目前Android Q里边，还是支持Android.mk方式的。相信在将来的版本中，会彻底让mk文件废弃，同时Kati也就淘汰了，只保留bp配置方式，所以我们要提前学习bp。Blueprint和Soong工具的源码在Android/build/目录下，我们可以通过查阅相关代码来学习。

Make 和 Soong 比较

Make 示例

LOCAL_PATH := $(call my-dir)

include $(CLEAR_VARS)
LOCAL_MODULE := libxmlrpc++
LOCAL_MODULE_HOST_OS := linux

LOCAL_RTTI_FLAG := -frtti
LOCAL_CPPFLAGS := -Wall -Werror -fexceptions
LOCAL_EXPORT_C_INCLUDES := $(LOCAL_PATH)/src

LOCAL_SRC_FILES := $(call \
     all-cpp-files-under,src)
include $(BUILD_SHARED_LIBRARY)

 Soong 示例

cc_library_shared {
     name: “libxmlrpc++”,

     rtti: true,
     cppflags: [
           “-Wall”,
           “-Werror”,
           “-fexceptions”,
     ],
     export_include_dirs: [“src”],
     srcs: [“src/**/*.cpp”],

     target: {
           darwin: {
                enabled: false,
           },
     },
}

android.mk

android.mk 一般位于工程目录中以“LOCAL_PATH := $(call my-dir)”开始,每个mk 可以编译多个应用以inclue $(CLEAR_VARS) 开始，include $(BUILD_XXX)结束，BUILD_XXX 为此应用的类型.

下面介绍一下android.mk的主要参数：

• LOCAL_MODULE_TAGS (android 10 取消这个参数)

        此参数会影响到库生成后的存放位置.

LOCAL_MODULE_TAGS ：=user eng tests optional

user: 指该模块只在user版本下才编译

eng: 指该模块只在eng版本下才编译

tests: 指该模块只在tests版本下才编译

optional:指该模块在所有版本下都编译

• LOCAL_PRELINK_MODULE

        Prelink利用事先链接代替运行时链接的方法来加速共享库的加载，它不仅可以加快起动速度，还可以减少部分内存开销，是各种Linux架构上用于减少程序加载时间、缩短系统启动时间和加快应用程序启动的很受欢迎的一个工具。程序运行时的动态链接尤其是重定位(relocation)的开销对于大型系统来说是很大的。

变量设置为false那么将不做prelink操作
LOCAL_PRELINK_MODULE := false

• LOCAL_MODULE_RELATIVE_PATH 

  指定动态库的相对路径,以各自编译对象放置的目录为参考。

• LOCAL_MODULE_PATH:

  目标的安装路径LOCAL_PATH := $(call my-dir)

• TARGET_ROOT_OUT：表示根文件系统。

• TARGET_OUT：表示system文件系统。

• TARGET_OUT_DATA：表示data文件系统。

• LOCAL_CFLAGS  ： C语言编译时额外选项，

#-Wno-unused- 加上对应的变量或参数类型，即可忽略当前警告，编译通过。
LOCAL_CFLAGS += -Wno-unused-const-variable \   
                -Wno-unused-variable \
                -Wno-unused-parameter

• LOCAL_CXXFLAGS ： C++语言编译时额外选项
• LOCAL_SRC_FILES ：指定源文件位置
• LOCAL_CC ：指定C 编译器
• LOCAL_CXX : 指定 C++ 编译器
• LOCA_C_INCLUDES :编译c c++ 所需额外头文件
• LOCAL_STATIC_LIBRARIES 编译时所需静态库列表
• LOCAL_SHARTED_LIBRARIES 编译时所需共享库列表
• LOCAL_JAVA_LIBRARIES 编译时所需JAVA类库
• BUILD_HOST_XXX ,BUILD_STATIC_XXX ,BUILD_XXX : 各种形式的编译模版，如生成设备端，HOST端，动态库，可执行文件，文档等。

android.mk 的常用模版

• NDK C++

 1.必须以LOCAL_PATH开头，用于在开发树种查找源文件
# 2.my-dir为宏，由编译系统提供，返回包含Android.mk文件的目录路径
LOCAL_PATH := $(call my-dir) 
 
# 1.CLEAR_VARS由build system提供，指向一个指定的GNU Makefile
# 2.负责清理LOCAL_xxx变量，但不清理LOCAL_PATH
# 3.由于所有编译文件都是同一个GNU Makefile解析和执行，变量是全局的，所以清理后才能避免相互影响
include $(CLEAR_VARS)
 
# 1.包含要编译的源文件
LOCAL_SRC_FILES := src/1.cpp src/2.cpp src/3.cpp \
                   src/4.cpp src/5.cpp src/6.cpp
# 打印信息方法
$(info $(LOCAL_SRC_FILES))
$(warning $(LOCAL_SRC_FILES))
$(error $(LOCAL_SRC_FILES))
# 1.追加要搜索的头文件目录
LOCAL_C_INCLUDES += itf/
# 1.android系统编译环境配置成debug时加入test工程
# 2.envsetup.sh中choosecombo第一个参数配置2即是debug模式
ifeq ($(TARGET_BUILD_TYPE), debug)
  # 获取test目录下所有cpp文件
  define all-cpp-files-under  
        # 1.$(patsubst <pattern>,<replacement>,<text>):查找<text>中单词是否符合<pattern>，如果匹配，则以<replacement>替换。
        # 2.%通配符，表示任意长度字符串
  $(patsubst ./%,%, $(shell cd $(LOCAL_PATH)/test;find $(1) -name "*.cpp" -or -name "*.cc" -and -not -name ".*"))  
  endef  
 
  define all-test-cpp-files  
  $(call all-cpp-files-under,.)  
  endef  
  LOCAL_SRC_FILES += $(call all-test-cpp-files) 
  LOCAL_C_INCLUDES += test/include
endif
# 1.依赖的动态链接库 
# 2.LOCAL_SHARED_LIBRARIES一般是先找编译好的，找不到就编译得到
# 3. LOCAL_LDLIBS 一般用于链接系统编译的库
# 4. LOCAL_LDFLAGS 一般用于链接第三方库,库要包含扩展名
LOCAL_SHARED_LIBRARIES := liblog
LOCAL_LDLIBS := $(LOCAL_PATH)/src/liblog
LOCAL_LDFLAGS := $(LOCAL_PATH)/src/libthird.so
# 1.指定可识别cpp文件的扩展名，只能选择一种，不支持混合
LOCAL_CPP_EXTENSION:=.cc .cpp .cxx
# 1.定义要生成的模块名字，这里命名为myModule
# 2.build system会自动添加适当的前缀和后缀，例如生成动态库则为libmyModule.so
LOCAL_MODULE := myModule
 
# 1.指定install路径
# 2.optional: out/target/product/OK6410/symbols/system/
# 3.eng:  out/target/product/Ok6410/system/
LOCAL_MODULE_TAGS := optional
 
# 1.keep_symbols:保留动态库中的符号信息
# 2.false:去掉动态库中的符号表等调试信息
LOCAL_STRIP_MODULE := keep_symbols
 
LOCAL_INIT_RC := myModule.rc
 
# 1.可选设置，在编译C/C++源码时附加编译选项
# 2.比如编译时附加搜索头文件目录的选项，如下所示。这种方法比LOCAL_C_INCLUDES要好，可以被ndk-debug使用
# Wall：所有的警告信息，Werror：所有的错误信息， Wunused：所有的未使用变量信息，Wunreachable-code：所有的未找到定义的信息
LOCAL_CFLAGS += -I<path>
LOCAL_CFLAGS += -Wall -Werror -Wunused -Wunreachable-code
# 1.分别编译成动态库、静态库、可执行native程序方法
# 2.实际使用中选择一个即可
# 3.主要作用是收集自从上次调用include $(CLEAR_VARS)后的所有LOCAL_xxx信息
include $(BUILD_SHARED_LIBRARY)
include $(BUILD_STATIC_LIBRARY)
include $(BUILD_EXECUTABLE)
 

• 多模块(frameworks/base/libs/audioflinger/Android.mk)

LOCAL_PATH:= $(call my-dir)
include $(CLEAR_VARS)  模块一
ifeq ($(AUDIO_POLICY_TEST),true)
  ENABLE_AUDIO_DUMP := true
endif
LOCAL_SRC_FILES:= \
    AudioHardwareGeneric.cpp \
    AudioHardwareStub.cpp \
    AudioHardwareInterface.cpp
ifeq ($(ENABLE_AUDIO_DUMP),true)
  LOCAL_SRC_FILES += AudioDumpInterface.cpp
  LOCAL_CFLAGS += -DENABLE_AUDIO_DUMP
endif
LOCAL_SHARED_LIBRARIES := \
    libcutils \
    libutils \
    libbinder \
    libmedia \
    libhardware_legacy
ifeq ($(strip $(BOARD_USES_GENERIC_AUDIO)),true)
  LOCAL_CFLAGS += -DGENERIC_AUDIO
endif
LOCAL_MODULE:= libaudiointerface
ifeq ($(BOARD_HAVE_BLUETOOTH),true)
  LOCAL_SRC_FILES += A2dpAudioInterface.cpp
  LOCAL_SHARED_LIBRARIES += liba2dp
  LOCAL_CFLAGS += -DWITH_BLUETOOTH -DWITH_A2DP
  LOCAL_C_INCLUDES += $(call include-path-for, bluez)
endif
include $(BUILD_STATIC_LIBRARY)  模块一编译成静态库
include $(CLEAR_VARS)  模块二
LOCAL_SRC_FILES:=               \
    AudioPolicyManagerBase.cpp
LOCAL_SHARED_LIBRARIES := \
    libcutils \
    libutils \
    libmedia
ifeq ($(TARGET_SIMULATOR),true)
 LOCAL_LDLIBS += -ldl
else
 LOCAL_SHARED_LIBRARIES += libdl
endif
LOCAL_MODULE:= libaudiopolicybase
ifeq ($(BOARD_HAVE_BLUETOOTH),true)
  LOCAL_CFLAGS += -DWITH_A2DP
endif
ifeq ($(AUDIO_POLICY_TEST),true)
  LOCAL_CFLAGS += -DAUDIO_POLICY_TEST
endif
include $(BUILD_STATIC_LIBRARY) 模块二编译成静态库
include $(CLEAR_VARS) 模块三
LOCAL_SRC_FILES:=               \
    AudioFlinger.cpp            \
    AudioMixer.cpp.arm          \
    AudioResampler.cpp.arm      \
    AudioResamplerSinc.cpp.arm  \
    AudioResamplerCubic.cpp.arm \
    AudioPolicyService.cpp
LOCAL_SHARED_LIBRARIES := \
    libcutils \
    libutils \
    libbinder \
    libmedia \
    libhardware_legacy
ifeq ($(strip $(BOARD_USES_GENERIC_AUDIO)),true)
  LOCAL_STATIC_LIBRARIES += libaudiointerface libaudiopolicybase
  LOCAL_CFLAGS += -DGENERIC_AUDIO
else
  LOCAL_SHARED_LIBRARIES += libaudio libaudiopolicy
endif
ifeq ($(TARGET_SIMULATOR),true)
 LOCAL_LDLIBS += -ldl
else
 LOCAL_SHARED_LIBRARIES += libdl
endif
LOCAL_MODULE:= libaudioflinger
ifeq ($(BOARD_HAVE_BLUETOOTH),true)
  LOCAL_CFLAGS += -DWITH_BLUETOOTH -DWITH_A2DP
  LOCAL_SHARED_LIBRARIES += liba2dp
endif
ifeq ($(AUDIO_POLICY_TEST),true)
  LOCAL_CFLAGS += -DAUDIO_POLICY_TEST
endif
ifeq ($(TARGET_SIMULATOR),true)
    ifeq ($(HOST_OS),linux)
        LOCAL_LDLIBS += -lrt -lpthread
    endif
endif
ifeq ($(BOARD_USE_LVMX),true)
    LOCAL_CFLAGS += -DLVMX
    LOCAL_C_INCLUDES += vendor/nxp
    LOCAL_STATIC_LIBRARIES += liblifevibes
    LOCAL_SHARED_LIBRARIES += liblvmxservice
#    LOCAL_SHARED_LIBRARIES += liblvmxipc
endif
include $(BUILD_SHARED_LIBRARY) 模块三编译成动态库

• 编译一个应用程序(APK)

 LOCAL_PATH := $(call my-dir)
  include $(CLEAR_VARS)
   
  # Build all java files in the java subdirectory-->直译（建立在java子目录中的所有Java文件）
  LOCAL_SRC_FILES := $(call all-subdir-java-files)
   
  # Name of the APK to build-->直译（创建APK的名称）
  LOCAL_PACKAGE_NAME := LocalPackage
   
  # Tell it to build an APK-->直译（告诉它来建立一个APK）
  include $(BUILD_PACKAGE)

• 编译一个依赖于静态Java库(static.jar)的应用程序

  LOCAL_PATH := $(call my-dir)
  include $(CLEAR_VARS)
   
  # List of static libraries to include in the package
  LOCAL_STATIC_JAVA_LIBRARIES := static-library
   
  # Build all java files in the java subdirectory
  LOCAL_SRC_FILES := $(call all-subdir-java-files)
   
  # Name of the APK to build
  LOCAL_PACKAGE_NAME := LocalPackage
   
  # Tell it to build an APK
  include $(BUILD_PACKAGE)

android.bp

bp 文件相对mk来说文件结构更加清晰，写法更加简单。

参考：

Soong 构建系统  |  Android 开源项目  |  Android Open Source Project

Build Docs (storage.googleapis.com)

文件一般以模块类型开头：

cc_binary {
    name: "gzip",
    srcs: ["src/test/minigzip.c"],
    shared_libs: ["libz"],
    stl: "none",
}

模块类型有：apex_defaults aidl_interface ，cc_binary ,cc_defaults,cc_library_static 等

在模块内部都必须定义 name 属性，并且这个属性必须全局唯一，仅有两个例外情况是命名空间和预构建模块中的 Android.bp 属性值，这两个值可能会重复。

srcs 属性以字符串列表的形式指定用于构建模块的源文件。您可以使用模块引用语法 ":<module-name>" 来引用生成源文件的其他模块的输出，如 genrule 或 filegroup。

类型

变量和属性是强类型，变量根据第一项赋值动态变化，属性由模块类型静态设置。支持的类型为：

• 布尔值（true 或 false）
• 整数 (int)
• 字符串 ("string")
• 字符串列表 (["string1", "string2"])
• 映射 ({key1: "value1", key2: ["value2"]})

条件语句

Soong 不支持 Android.bp 文件中的条件语句。但是，编译规则中需要条件语句的复杂问题将在 Go中处理。大多数条件语句都会转换为映射属性，其中选择了映射中的某个值并将其附加到顶级属性。

例如，要支持特定于架构的文件，请使用以下命令：

cc_library {
    ...
    srcs: ["generic.cpp"],
    arch: {
        arm: {
            srcs: ["arm.cpp"],
        },
        x86: {
            srcs: ["x86.cpp"],
        },
    },
}

默认模块

默认模块可用于在多个模块中重复使用相同的属性。例如：

cc_defaults {
    name: "gzip_defaults",
    shared_libs: ["libz"],
    stl: "none",
}

cc_binary {
    name: "gzip",
    defaults: ["gzip_defaults"],
    srcs: ["src/test/minigzip.c"],
}