Android 编译的配置文件：android.mk 和android.bp

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 := linuxLOCAL_RTTI_FLAG := -frtti
LOCAL_CPPFLAGS := -Wall -Werror -fexceptions
LOCAL_EXPORT_C_INCLUDES := $(LOCAL_PATH)/srcLOCAL_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 optionaluser: 指该模块只在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_symbolsLOCAL_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.cppLOCAL_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.cppLOCAL_SHARED_LIBRARIES += liba2dpLOCAL_CFLAGS += -DWITH_BLUETOOTH -DWITH_A2DPLOCAL_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
elseLOCAL_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 libaudiopolicybaseLOCAL_CFLAGS += -DGENERIC_AUDIO
elseLOCAL_SHARED_LIBRARIES += libaudio libaudiopolicy
endif
ifeq ($(TARGET_SIMULATOR),true)LOCAL_LDLIBS += -ldl
elseLOCAL_SHARED_LIBRARIES += libdl
endif
LOCAL_MODULE:= libaudioflinger
ifeq ($(BOARD_HAVE_BLUETOOTH),true)LOCAL_CFLAGS += -DWITH_BLUETOOTH -DWITH_A2DPLOCAL_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 -lpthreadendif
endif
ifeq ($(BOARD_USE_LVMX),true)LOCAL_CFLAGS += -DLVMXLOCAL_C_INCLUDES += vendor/nxpLOCAL_STATIC_LIBRARIES += liblifevibesLOCAL_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 packageLOCAL_STATIC_JAVA_LIBRARIES := static-library# Build all java files in the java subdirectoryLOCAL_SRC_FILES := $(call all-subdir-java-files)# Name of the APK to buildLOCAL_PACKAGE_NAME := LocalPackage# Tell it to build an APKinclude $(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"],
}