Android build system note

1. Android编译系统分析

编译脚本及系统变量

build/envsetup.sh脚本分析

在编译源代码之前通常需要在android源代码顶层目录执行 . ./build/envsetup.sh 目的是为了使用脚本

choosecombo 命令分析：

function choosecombo()

{

choosesim $1

echo

echo

choosetype $2

echo

echo

chooseproduct $3

echo

echo

choosevariant $4

echo

set_stuff_for_environment

printconfig

}

会依次进行如下选择：

Build for the simulator or the device?

1. Device

2. Simulator

Which would you like? [1]

Build type choices are:

1. release

2. debug

Which would you like? [1]

Product choices are:

1. emulator

2. generic

3. sim

4. littleton

You can also type the name of a product if you know it.

Which would you like? [littleton]

Variant choices are:

1. user

2. userdebug

3. eng

Which would you like? [eng] user

默认选择以后会出现：

TARGET_PRODUCT=littleton

TARGET_BUILD_VARIANT=user

TARGET_SIMULATOR=false

TARGET_BUILD_TYPE=release

TARGET_ARCH=arm

HOST_ARCH=x86

HOST_OS=linux

HOST_BUILD_TYPE=release

BUILD_ID=

＝＝＝＝＝＝＝＝＝＝

function chooseproduct()函数分析：

choices=(`/bin/ls build/target/board/*/BoardConfig.mk vendor/*/*/BoardConfig.mk 2> /dev/null`)

读取 build/target/board/* 目录下的板配置文件：BoardConfig.mk

读取 vendor/*/*/目录下的板配置文件：BoardConfig.mk

choices 的值为：

build/target/board/emulator/BoardConfig.mk

build/target/board/generic/BoardConfig.mk

build/target/board/sim/BoardConfig.mk

vendor/marvell/littleton/BoardConfig.mk

经过：

for choice in ${choices[@]}

do

# The product name is the name of the directory containing

# the makefile we found, above.

prodlist=(${prodlist[@]} `dirname ${choice} | xargs basename`)

done

的处理，prodlist的值为：

emulator generic sim littleton

所以选择菜单为：

Product choices are:

1. emulator

2. generic

3. sim

4. littleton

如果选择 4，那么 TARGET_PRODUCT 被赋值为： littleton。

board_config_mk := /

$(strip $(wildcard /

$(SRC_TARGET_DIR)/board/$(TARGET_DEVICE)/BoardConfig.mk /

vendor/*/$(TARGET_DEVICE)/BoardConfig.mk /

))

怎样添加一个模块

LOCAL_PATH:= $(call my-dir)

#编译静态库

include $(CLEAR_VARS)

LOCAL_MODULE = libhellos

LOCAL_CFLAGS = $(L_CFLAGS)

LOCAL_SRC_FILES = hellos.c

LOCAL_C_INCLUDES = $(INCLUDES)

LOCAL_SHARED_LIBRARIES := libcutils

LOCAL_COPY_HEADERS_TO := libhellos

LOCAL_COPY_HEADERS := hellos.h

include $(BUILD_STATIC_LIBRARY)

#编译动态库

include $(CLEAR_VARS)

LOCAL_MODULE = libhellod

LOCAL_CFLAGS = $(L_CFLAGS)

LOCAL_SRC_FILES = hellod.c

LOCAL_C_INCLUDES = $(INCLUDES)

LOCAL_SHARED_LIBRARIES := libcutils

LOCAL_COPY_HEADERS_TO := libhellod

LOCAL_COPY_HEADERS := hellod.h

include $(BUILD_SHARED_LIBRARY)

BUILD_TEST=true

ifeq ($(BUILD_TEST),true)

#使用静态库

include $(CLEAR_VARS)

LOCAL_MODULE := hellos

LOCAL_STATIC_LIBRARIES := libhellos

LOCAL_SHARED_LIBRARIES :=

LOCAL_LDLIBS += -ldl

LOCAL_CFLAGS := $(L_CFLAGS)

LOCAL_SRC_FILES := mains.c

LOCAL_C_INCLUDES := $(INCLUDES)

include $(BUILD_EXECUTABLE)

#使用动态库

include $(CLEAR_VARS)

LOCAL_MODULE := hellod

LOCAL_MODULE_TAGS := debug

LOCAL_SHARED_LIBRARIES := libc libcutils libhellod

LOCAL_LDLIBS += -ldl

LOCAL_CFLAGS := $(L_CFLAGS)

LOCAL_SRC_FILES := maind.c

LOCAL_C_INCLUDES := $(INCLUDES)

include $(BUILD_EXECUTABLE)

endif # ifeq ($(WPA_BUILD_SUPPLICANT),true)

########################

#local_target_dir := $(TARGET_OUT)/etc/wifi

#include $(CLEAR_VARS)

#LOCAL_MODULE := wpa_supplicant.conf

#LOCAL_MODULE_TAGS := user

#LOCAL_MODULE_CLASS := ETC

#LOCAL_MODULE_PATH := $(local_target_dir)

#LOCAL_SRC_FILES := $(LOCAL_MODULE)

#include $(BUILD_PREBUILT)

########################

系统变量解析

LOCAL_MODULE － 编译的目标对象

LOCAL_SRC_FILES － 编译的源文件

LOCAL_C_INCLUDES － 需要包含的头文件目录

LOCAL_SHARED_LIBRARIES － 链接时需要的外部库

LOCAL_PRELINK_MODULE － 是否需要prelink处理

BUILD_SHARED_LIBRARY － 指明要编译成动态库

LOCAL_PATH - 编译时的目录

$(call 目录，目录….) 目录引入操作符

如该目录下有个文件夹名称 src，则可以这样写 $(call src)，那么就会得到 src 目录的完整路径

include $(CLEAR_VARS) -清除之前的一些系统变量

CLEAR_VARS:= $(BUILD_SYSTEM)/clear_vars.mk

在 build/core/config.mk 定义 CLEAR_VARS:= $(BUILD_SYSTEM)/clear_vars.mk

通过include 包含自定义的.mk文件（即是自定义编译规则）或是引用系统其他的.mk文件（系统定义的编译规则）。

LOCAL_SRC_FILES － 编译的源文件

可以是.c, .cpp, .java, .S（汇编文件）或是.aidl等格式

不同的文件用空格隔开。如果编译目录子目录，采用相对路径，如子目录/文件名。也可以通过$(call 目录)，指明编译某目录

下所有.c/.cpp/.java/.S/ .aidl文件.追加文件 LOCAL_SRC_FILES += 文件

LOCAL_C_INCLUDES － 需要包含的头文件目录

可以是系统定义路径，也可以是相对路径. 如该编译目录下有个include目录，写法是include/*.h

LOCAL_SHARED_LIBRARIES － 链接时需要的外部共享库

LOCAL_STATIC_LIBRA RIES － 链接时需要的外部外部静态

LOCAL_JAVA_LIBRARIES 加入jar包

LOCAL_MODULE － 编译的目标对象

module 是指系统的 native code，通常针对c,c++代码

./system/core/sh/Android.mk:32:LOCAL_MODULE:= sh

./system/core/libcutils/Android.mk:71:LOCAL_MODULE := libcutils

./system/core/cpio/Android.mk:9:LOCAL_MODULE := mkbootfs

./system/core/mkbootimg/Android.mk:8:LOCAL_MODULE := mkbootimg

./system/core/toolbox/Android.mk:61:LOCAL_MODULE:= toolbox

./system/core/logcat/Android.mk:10:LOCAL_MODULE:= logcat

./system/core/adb/Android.mk:65:LOCAL_MODULE := adb

./system/core/adb/Android.mk:125:LOCAL_MODULE := adbd

./system/core/init/Android.mk:20:LOCAL_MODULE:= init

./system/core/vold/Android.mk:24:LOCAL_MODULE:= vold

./system/core/mountd/Android.mk:13:LOCAL_MODULE:= mountd

LOCAL_PACKAGE_NAME

Java 应用程序的名字用该变量定义

./packages/apps/Music/Android.mk:9:LOCAL_PACKAGE_NAME := Music

./packages/apps/Browser/Android.mk:14:LOCAL_PACKAGE_NAME := Browser

./packages/apps/Settings/Android.mk:8:LOCAL_PACKAGE_NAME := Settings

./packages/apps/Stk/Android.mk:10:LOCAL_PACKAGE_NAME := Stk

./packages/apps/Contacts/Android.mk:10:LOCAL_PACKAGE_NAME := Contacts

./packages/apps/Mms/Android.mk:8:LOCAL_PACKAGE_NAME := Mms

./packages/apps/Camera/Android.mk:8:LOCAL_PACKAGE_NAME := Camera

./packages/apps/Phone/Android.mk:11:LOCAL_PACKAGE_NAME := Phone

./packages/apps/VoiceDialer/Android.mk:8:LOCAL_PACKAGE_NAME := VoiceDialer

BUILD_SHARED_LIBRARY － 指明要编译成动态库。

编译的目标，用include 操作符

UILD_STATIC_LIBRARY来指明要编译成静态库。

如果是java文件的话，会用到系统的编译脚本host_java_library.mk，用BUILD_PACKAGE来指明。三个编译

－－－－－－－－－－－－－－－－－－－

include $(BUILD_STATIC_LIBRARY)

BUILD_STATIC_LIBRARY:= $(BUILD_SYSTEM)/static_library.mk

－－－－－－－－－－－－－－－－－－－

include $(BUILD_SHARED_LIBRARY)

./build/core/config.mk:50:BUILD_SHARED_LIBRARY:= $(BUILD_SYSTEM)/shared_library.mk

－－－－－－－－－－－－－－－－－－－

include $(BUILD_HOST_SHARED_LIBRARY)

BUILD_HOST_SHARED_LIBRARY:= $(BUILD_SYSTEM)/host_shared_library.mk

－－－－－－－－－－－－－－－－－－－

include $(BUILD_EXECUTABLE)

build/core/config.mk:51:BUILD_EXECUTABLE:= $(BUILD_SYSTEM)/executable.mk

－－－－－－－－－－－－－－－－－－－

include $(BUILD_HOST_EXECUTABLE)

./build/core/config.mk:53:BUILD_HOST_EXECUTABLE:= $(BUILD_SYSTEM)/host_executable.mk

－－－－－－－－－－－－－－－－－－－

BUILD_HOST_JAVA_LIBRARY:= $(BUILD_SYSTEM)/host_java_library.mk

－－－－－－－－－－－－－－－－－－－

BUILD_JAVA_LIBRARY

./build/core/config.mk:58:BUILD_JAVA_LIBRARY:= $(BUILD_SYSTEM)/java_library.mk

－－－－－－－－－－－－－－－－－－

BUILD_STATIC_JAVA_LIBRARY 编译静态JAVA库

./build/core/config.mk:59:BUILD_STATIC_JAVA_LIBRARY:= $(BUILD_SYSTEM)/static_java_library.mk

－－－－－－－－－－－－－－－－－－

BUILD_HOST_JAVA_LIBRARY 编译本机用的JAVA库

./build/core/config.mk:60:BUILD_HOST_JAVA_LIBRARY:= $(BUILD_SYSTEM)/host_java_library.mk

－－－－－－－－－－－－－－－－－－

BUILD_HOST_STATIC_LIBRARY:= $(BUILD_SYSTEM)/host_static_library.mk

BUILD_HOST_SHARED_LIBRARY:= $(BUILD_SYSTEM)/host_shared_library.mk

BUILD_STATIC_LIBRARY:= $(BUILD_SYSTEM)/static_library.mk

BUILD_RAW_STATIC_LIBRARY := $(BUILD_SYSTEM)/raw_static_library.mk

BUILD_SHARED_LIBRARY:= $(BUILD_SYSTEM)/shared_library.mk

BUILD_EXECUTABLE:= $(BUILD_SYSTEM)/executable.mk

BUILD_RAW_EXECUTABLE:= $(BUILD_SYSTEM)/raw_executable.mk

BUILD_HOST_EXECUTABLE:= $(BUILD_SYSTEM)/host_executable.mk

BUILD_PACKAGE:= $(BUILD_SYSTEM)/package.mk

BUILD_HOST_PREBUILT:= $(BUILD_SYSTEM)/host_prebuilt.mk

BUILD_PREBUILT:= $(BUILD_SYSTEM)/prebuilt.mk

BUILD_MULTI_PREBUILT:= $(BUILD_SYSTEM)/multi_prebuilt.mk

BUILD_JAVA_LIBRARY:= $(BUILD_SYSTEM)/java_library.mk

BUILD_STATIC_JAVA_LIBRARY:= $(BUILD_SYSTEM)/static_java_library.mk

BUILD_HOST_JAVA_LIBRARY:= $(BUILD_SYSTEM)/host_java_library.mk

BUILD_DROIDDOC:= $(BUILD_SYSTEM)/droiddoc.mk

BUILD_COPY_HEADERS := $(BUILD_SYSTEM)/copy_headers.mk

BUILD_KEY_CHAR_MAP := $(BUILD_SYSTEM)/key_char_map.mk

＝＝＝＝＝＝＝＝＝＝＝＝

LOCAL_PRELINK_MODULE

Prelink利用事先链接代替运行时链接的方法来加速共享库的加载，它不仅可以加快起动速度，还可以减少部分内存开销，

是各种Linux架构上用于减少程序加载时间、缩短系统启动时间和加快应用程序启动的很受欢迎的一个工具。程序运行时的

动态链接尤其是重定位(relocation)的开销对于大型系统来说是很大的。

动态链接和加载的过程开销很大，并且在大多数的系统上, 函数库并不会常常被更动, 每次程序被执行时所进行的链接

动作都是完全相同的，对于嵌入式系统来说尤其如此。因此，这一过程可以改在运行时之前就可以预先处理好，即花一些时间

利用Prelink工具对动态共享库和可执行文件进行处理，修改这些二进制文件并加入相应的重定位等信息，节约了本来在程序

启动时的比较耗时的查询函数地址等工作，这样可以减少程序启动的时间，同时也减少了内存的耗用。

Prelink的这种做法当然也有代价：每次更新动态共享库时，相关的可执行文件都需要重新执行一遍Prelink才能保

证有效，因为新的共享库中的符号信息、地址等很可能与原来的已经不同了，这就是为什么 android framework代码一改动，

这时候就会导致相关的应用程序重新被编译。

这种代价对于嵌入式系统的开发者来说可能稍微带来一些复杂度，不过好在对用户来说几乎是可以忽略的。

－－－－－－－－－－－－－－－－－－－－

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

LOCAL_PRELINK_MODULE := false

默认是需要prlink的，同时需要在 build/core/prelink-linux-arm.map 中加入

libhellod.so 0x96000000

这个map文件好像是制定动态库的地址的，在前面注释上面有一些地址范围的信息，注意库与库之间的间隔数，

如果指定不好的话编译的时候会提示说地址空间冲突的问题。另外，注意排序，这里要把数大的放到前面去，

按照大小降序排序。

解析 LOCAL_PRELINK_MODULE 变量

build/core/dynamic_binary.mk:94:ifeq ($(LOCAL_PRELINK_MODULE),true)

ifeq ($(LOCAL_PRELINK_MODULE),true)

$(prelink_output): $(prelink_input) $(TARGET_PRELINKER_MAP) $(APRIORI)

$(transform-to-prelinked)

transform-to-prelinked定义：

./build/core/definitions.mk:1002:define transform-to-prelinked

define transform-to-prelinked

@mkdir -p $(dir $@)

@echo "target Prelink: $(PRIVATE_MODULE) ($@)"

$(hide) $(APRIORI) /

--prelinkmap $(TARGET_PRELINKER_MAP) /

--locals-only /

--quiet /

$< /

--output $@

endef

./build/core/config.mk:183:APRIORI := $(HOST_OUT_EXECUTABLES)/apriori$(HOST_EXECUTABLE_SUFFIX)

prelink工具不是常用的prelink而是apriori，其源代码位于” /build/tools/apriori”

参考文档：

动态库优化——Prelink（预连接）技术
http://www.eefocus.com/article/09-04/71629s.html
＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝

LOCAL_ARM_MODE := arm

目前Android大部分都是基于Arm处理器的，Arm指令用两种模式Thumb(每条指令两个字节)和arm指令（每条指令四个字节）

LOCAL_CFLAGS += -O3 -fstrict-aliasing -fprefetch-loop-arrays

通过设定编译器操作，优化级别，-O0表示没有优化,-O1为缺省值，-O3优化级别最高

LOCAL_CFLAGS += -W -Wall

LOCAL_CFLAGS += -fPIC -DPIC

LOCAL_CFLAGS += -O2 -g -DADB_HOST=1 -Wall -Wno-unused-parameter

LOCAL_CFLAGS += -D_XOPEN_SOURCE -D_GNU_SOURCE -DSH_HISTORY

LOCAL_CFLAGS += -DUSEOVERLAY2

根据条件选择相应的编译参数

ifeq ($(TARGET_ARCH),arm)

LOCAL_CFLAGS += -DANDROID_GADGET=1

LOCAL_CFLAGS := $(PV_CFLAGS)

endif

ifeq ($(TARGET_BUILD_TYPE),release)

LOCAL_CFLAGS += -O2

endif

LOCAL_LDLIBS := -lpthread

LOCAL_LDLIBS += -ldl

ifdef USE_MARVELL_MVED

LOCAL_WHOLE_STATIC_LIBRARIES += lib_il_mpeg4aspdecmved_wmmx2lnx lib_il_h264decmved_wmmx2lnx

LOCAL_SHARED_LIBRARIES += libMrvlMVED

else

LOCAL_WHOLE_STATIC_LIBRARIES += lib_il_h264dec_wmmx2lnx lib_il_mpeg4aspdec_wmmx2lnx

endif

http://blog.csdn.net/qclzdh/article/details/6280737