repost:Android Build系统介绍

Android Build系统介绍

Young_Allen

thanks to the author!!!!

概述

Android build系统主要的逻辑都包含在Make文件,另外还包括各种shell和 python脚本，Build树可以理解为给Android源码的编译构建了一整套规则。

框架

1.结构

1.Build核心模块

图1.Android Build源码目录

图1中Build源码文件定义了整个Build系统的框架，其他所有的Make文件都是基于这个构建环境编写出来并成功编译。Build的核心文件都在/build/core/下。

2.针对产品的Build模块

图2.针对产品的Build源码目录

图2中是针对某个产品类型的Make文件，一般都在device目录下，根据产品类型有一组完整的Build模块，比如hisillicon为硬件厂商定义的产品build树，与Android核心build模块一起构建build系统。

3.针对单独模块的Build

图3.针对单独模块的Build

单独模块的Build是依赖Android核心Build模块的，所以在单独模块编译时需要有如下操作：

单独模块的编译以Android.mk文件为核心，也是大多数开发者最熟悉的Build模块。

2.Build树分析

1.编译前准备

编译前执行的第一条命令source ./build/envsetup.sh，初始化了各种环境变量以及Shell函数：

build/envsetup.sh 中定义的常用函数

对lunch模块的处理

vendorsetup.sh环境变量处理

lunch函数实际则指定了编译的目标设备：

2.开始编译

Build编译系统的入口是根目录下的一个最简单的MakeFIle，仅仅只有一行代码：

根目录MakeFIle

在源码根目录调用make命令时，make命令最先读取这个文件。虽然这个文件只有一行代码，把/build/core/main.mk包含进来，但是这个操作引入了整个Build系统。

main.mk

Android Build思维导图

文件名	作用
main.mk	最主要的 Make 文件，该文件中首先将对编译环境进行检查，同时引入其他的 Make 文件
help.mk	包含了名称为 help 的 Make 目标的定义，该目标将列出主要的 Make 目标及其说明
pathmap.mk	将许多头文件的路径通过名值对的方式定义为映射表，并提供 include-path-for 函数来获取。例如，通过$(call include-path-for, frameworks-native)便可以获取到 framework 本地代码需要的头文件路径
envsetup.mk	配置 Build 系统需要的环境变量，例如：TARGET_PRODUCT，TARGET_BUILD_VARIANT，HOST_OS，HOST_ARCH 等。当前编译的主机平台信息（例如操作系统，CPU 类型等信息）就是在这个文件中确定的。另外，该文件中还指定了各种编译结果的输出路径
combo/select.mk	根据当前编译器的平台选择平台相关的 Make 文件
dumpvar.mk	在 Build 开始之前，显示此次 Build 的配置信息
config.mk	整个 Build 系统的配置文件，最重要的 Make 文件之一。该文件中主要包含以下内容：定义了许多的常量来负责不同类型模块的编译。定义编译器参数以及常见文件后缀，例如 .zip,.jar.apk。根据 BoardConfig.mk 文件，配置产品相关的参数。设置一些常用工具的路径，例如 flex，e2fsck，dx
definitions.mk	最重要的 Make 文件之一，在其中定义了大量的函数。这些函数都是 Build 系统的其他文件将用到的。例如：my-dir，all-subdir-makefiles，find-subdir-files，sign-package 等，关于这些函数的说明请参见每个函数的代码注释
distdir.mk	针对 dist 目标的定义。dist 目标用来拷贝文件到指定路径。
dex_preopt.mk	针对启动 jar 包的预先优化
pdk_config.mk	顾名思义，针对 pdk（Platform Developement Kit）的配置文件
post_clean.mk	在前一次 Build 的基础上检查当前 Build 的配置，并执行必要清理工作。
host_static_library.mk	定义了如何编译主机上的静态库
host_shared_library.mk	定义了如何编译主机上的共享库
static_library.mk	定义了如何编译设备上的静态库
shared_library.mk	定义了如何编译设备上的共享库
executable.mk	定义了如何编译设备上的可执行文件
host_executable.mk	定义了如何编译主机上的可执行文件
package.mk	定义了如何编译 APK 文件
prebuilt.mk	定义了如何处理一个已经编译好的文件 ( 例如 Jar 包 )
multi_prebuilt.mk	定义了如何处理一个或多个已编译文件，该文件的实现依赖 prebuilt.mk
host_prebuilt.mk	处理一个或多个主机上使用的已编译文件，该文件的实现依赖 multi_prebuilt.mk
java_library.mk	定义了如何编译设备上的共享 Java 库
static_java_library.mk	定义了如何编译设备上的静态 Java 库
host_java_library.mk	定义了如何编译主机上的共享 Java 库

Android Build系统包含了编译的所有规则：
make bigfish -j8会匹配到以下声明，并开始makefile编译

Paste_Image.png

为了方便模块编译，Build系统还设置了很多编译环境。单独编译一个模块时，需要配置变量后才能执行编译：

TAG	作用
LOCAL_SRC_FILES	当前模块包含的所有源代码文件
LOCAL_MODULE	当前模块的名称，这个名称应当是唯一的，模块间的依赖关系就是通过这个名称来引用的
LOCAL_C_INCLUDES	C 或 C++ 语言需要的头文件的路径
LOCAL_STATIC_LIBRARIES	当前模块在静态链接时需要的库的名称
LOCAL_SHARED_LIBRARIES	当前模块在运行时依赖的动态库的名称
LOCAL_CFLAGS	提供给 C/C++ 编译器的额外编译参数
LOCAL_JAVA_LIBRARIES	当前模块依赖的 Java 共享库
LOCAL_STATIC_JAVA_LIBRARIES	当前模块依赖的 Java 静态库
LOCAL_PACKAGE_NAME	当前 APK 应用的名称
LOCAL_CERTIFICATE	签署当前应用的证书名称

在Android Build系统中声明了很多编译类型：Java 库，C/C++ 库，APK 应用，以及可执行文件等，并且Java 或者 C/C++ 库还可以分为静态的或者动态的，库或可执行文件既可能是针对设备的也可能是针对主机的或者模拟器的，不同的模块的编译声明和方法是不一样的，在config.mk中声明了模块类型，如下：

TAG	Action
BUILD_HOST_STATIC_LIBRARY	编译静态库(适用与主机)
BUILD_HOST_SHARED_LIBRARY	编译动态库(适用与主机)
BUILD_HOST_EXECUTABLE	编译可执行程序(适用与主机)
BUILD_HOST_PREBUILT	预编译(适用与主机)
BUILD_HOST_JAVA_LIBRARY	编译java包(适用与主机)
BUILD_JAVA_LIBRARY	编译java包
BUILD_STATIC_JAVA_LIBRARY	编译java静态包
BUILD_STATIC_LIBRARY	编译静态库
BUILD_SHARED_LIBRARY	编译动态库
BUILD_EXECUTABLE	编译可执行程序
BUILD_PACKAGE	编译apk
BUILD_PREBUILT	预编译(针对单个预编译文件)
BUILD_MULTI_PREBUILT	预编译(针对多个预编译文件)

在Android源码中，为了把一个模块添加到Build系统中，每个模块都需要编写一个专门的Android.mk文件，Build系统会查找到所有目录下的Android.mk，并根据Android.mk文件编译出指定的目标文件。