Android编译系统参考手册

build/core/definitions.mk

定义了公共的编译系统变量ALL_*，
还定义了很多命令用来编译各种各样的目标，
其它地方用来构建最终目标，build/core/main.mk，build/core/Makefile将用到这些变量

ALL_DOCS

所有文档的全路径
ALL_DOCS的赋值在droiddoc.mk里：
ALL_DOCS += $(full_target)
full_target := $(call doc-timestamp-for,$(LOCAL_MODULE))
ALL_DOCS示例：out/target/common/docs/api-stubs-timestamp  out/target/common/docs/hidden-timestamp 
如果某个模块要编译出文档，需要使用命令
include $(BUILD_DROIDDOC)
而BUILD_DROID_DOC变量的值是droiddoc.mk

ALL_MODULES

系统的所有模块的简单名字集合
编译系统还为每一个模块还定义了其它两个变量
ALL_MODULES.$(LOCAL_MODULE).BUILT 所有模块的生成路径
ALL_MODULES.$(LOCAL_MODULE).INSTALLED 所有模块的各自安装路径
例如：手机中将安装在system/bin/recovery，那么ALL_MODULES.recovery.INSTALLED为out/target/product/find5/system/bin/recovery
每个模块都会定义该模块生成的目标类型，可能生成二进制文件，也可能生成java静态库
这是由这个模块include $(BUILD_)决定的
比如build type若是EXCECUTABLE，，那么将include $(BUILD_EXECUTABLE)，那么将include build/core/executable.mk
而该makefile对应生成的目标类型是在手机上的可执行程序 
executable.mk里包含了binary.mk，而binary.mk包含了base_rules.mk
base_rules.mk里为变量ALL_MODULES，ALL_MODULES.$(target).BUILT，ALL_MODULES.$(target).INSTALLED赋值
代码：
ALL_MODULES += $(LOCAL_MODULE)
ALL_MODULES.$(LOCAL_MODULE).BUILT := \
$(ALL_MODULES.$(LOCAL_MODULE).BUILT) $(LOCAL_BUILT_MODULE)
LOCAL_BUILT_MODULE := $(built_module_path)/$(LOCAL_BUILT_MODULE_STEM)  
ALL_MODULES.$(LOCAL_MODULE).INSTALLED := \
$(strip $(ALL_MODULES.$(LOCAL_MODULE).INSTALLED) $(LOCAL_INSTALLED_MODULE))
ifneq (true,$(LOCAL_UNINSTALLABLE_MODULE))
LOCAL_INSTALLED_MODULE := $(LOCAL_MODULE_PATH)/$(LOCAL_INSTALLED_MODULE_STEM)
endif 
LOCAL_MODULE_PATH := $(strip $(LOCAL_MODULE_PATH))
ifeq ($(LOCAL_MODULE_PATH),)
LOCAL_MODULE_PATH := $($(my_prefix)OUT$(partition_tag)_$(LOCAL_MODULE_CLASS))
ifeq ($(strip $(LOCAL_MODULE_PATH)),)
$(error $(LOCAL_PATH): unhandled LOCAL_MODULE_CLASS "$(LOCAL_MODULE_CLASS)")
endif
endif 
LOCAL_MODULE_PATH:表示要安装的位置，可由编译系统推算，也可由某个模块显示指定
示例：
ALL_MODULES：recvery applypatch  applypatch_static imgdiff
对应的
$(built_module_path) : out/target/product/find5/obj/EXECUTABLES/recovery_intermediates
$(LOCAL_BUILT_MODULE_STEM) : recovery
$(LOCAL_MODULE_PATH):  out/target/product/find5/system/bin
$(LOCAL_INSTALLED_MODULE_STEM): recovery
$(my_prefix)OUT$(partition_tag)_$(LOCAL_MODULE_CLASS):TARGET_OUT_EXECUTABLES
$(ALL_MODULES.recovery.BUILT) :out/target/product/find5/obj/EXECUTABLES/recovery_intermediates/recovery
$(ALL_MODULES.recovery.INSTALLED):out/target/product/find5/system/bin/recovery

ALL_DEFAULT_INSTALLED_MODULES

所有默认要安装的模块,在build/core/main.mk和build/core/makfile里设置   
Full paths to targets that should be added to the "make droid" set of installed targets.
droid目标将安装的所有模块的集合

ALL_MODULE_TAGS

使用LOCAL_MODULE_TAGS定义的所有tag集合
每一个tag对应一个ALL_MODULE_TAGS.变量
例：
在recovery的Android.mk里定义了；
LOCAL_MODULE := recovery
LOCAL_MODULE_TAGS := eng
LOCAL_MODULE := nandroid-md5.sh
LOCAL_MODULE_TAGS := optional 
那么：ALL_MODULE_TAGS 将包含 eng,optional，
ALL_MODULE_TAGS.eng：out/target/product/find5/system/bin/recovery 
ALL_MODULE_TAGS.optional： out/target/product/find5/recovery/root/sbin/nandroid-md5.sh

ALL_MODULE_NAME_TAGS

类似于ALL_MODULE_TAGS，但是它的值是 某个tag的所有模块的名称
例：
包含bootable/recovery/Android.mk后，
ALL_MODULE_NAME_TAGS.eng: recovery libbmlutils libdedupe utility_dedupe libcrecovery libmmcutils updater libapplypatch applypatch_static su.recovery
ALL_MODULE_NAME_TAGS.optional: nandroid-md5.sh killrecovery.sh dedupe libflashutils flash_image dump_image erase_image libflash_image libdump_image liberase_image 
utility_dump_image utility_flash_image utility_erase_image libminui libminelf libminzip libminadbd libmtdutils edify libedify applypatch 
imgdiff parted sdparted libminizip libmake_ext4fs install-su.sh run-su-daemon.sh

ALL_HOST_INSTALLED_FILES

安装在pc上的程序集合
例：
包含bootable/recovery/Android.mk后，
ALL_HOST_INSTALLED_FILES:
/home/cloud/android/Cyanogenmod/out/host/linux-x86/bin/dedupe
/home/cloud/android/Cyanogenmod/out/host/linux-x86/bin/edify 
/home/cloud/android/Cyanogenmod/out/host/linux-x86/bin/imgdiff

ALL_PREBUILT

将会被拷贝的预编译文件的安装全路径的集合
Full paths to all prebuilt files that will be copied (used to make the dependency on acp) 
在system/core/Android.mk里大量使用了ALL_PREBUILT
ALL_PREBUILT += $(file)
ALL_PREBUILT += $(DIRS)
示例：
ALL_PREBUILT:   out/target/product/find5/system/etc/dbus.conf out/target/product/find5/system/etc/hosts out/target/product/find5/system/etc/init.goldfish.sh

ALL_GENERATED_SOURCES

某些工具生成的源代码文件的集合，比如aidl会生成java源代码文件
Full path to all files that are made by some tool 
./build/core/binary.mk:273:ALL_GENERATED_SOURCES += $(LOCAL_GENERATED_SOURCES)
./bionic/libc/Android.mk:735:ALL_GENERATED_SOURCES += $(GEN)
例：
ALL_GENERATED_SOURCES： out/target/product/find5/obj/SHARED_LIBRARIES/libRS_intermediates/rsgApiStructs.h 
out/target/product/find5/obj/SHARED_LIBRARIES/libRS_intermediates/rsgApiFuncDecl.h 
out/target/product/find5/obj/SHARED_LIBRARIES/libbt-vendor_intermediates/vnd_buildcfg.h

ALL_C_CPP_ETC_OBJECTS

所有asm，c,c++,以及lex和yacc生成的c代码文件的全路径
这些都对拷贝的头文件有一个按序的依赖关系

ALL_ORIGINAL_DYNAMIC_BINARIES

没有被优化，也没有被压缩的动态链接库
The list of dynamic binaries that haven't been stripped/compressed/etc   
dynamic_binary.mk:  ALL_ORIGINAL_DYNAMIC_BINARIES += $(linked_module)
例：
ALL_ORIGINAL_DYNAMIC_BINARIES：out/target/product/find5/obj/EXECUTABLES/vold_intermediates/LINKED/vold
out/target/product/find5/obj/SHARED_LIBRARIES/libkeystore_intermediates/LINKED/libkeystore.so

ALL_SDK_FILES

将会放在sdk的文件  
These files go into the SDK 
主要赋值：development/build/Android.mk

INTERNAL_DALVIK_MODULES

dalvik虚拟机需要的文件   
Files for dalvik.  This is often build without building the rest of the OS   
在dalvik/dx/src/Android.mk dalvik/dx/Android.mk中有赋值

ALL_FINDBUGS_FILES

所有findbugs程序用的xml文件
build/core/java.mk:400:ALL_FINDBUGS_FILES += $(findbugs_xml)
All findbugs xml files

ALL_GPL_MODULE_LICENSE_FILES

GPL module license files
GPL 模块的 许可文件
在build/core/base_rules.mk里有赋值
gpl_license_file := $(call find-parent-file,$(LOCAL_PATH),MODULE_LICENSE*_GPL* MODULE_LICENSE*_MPL*)
ifneq ($(gpl_license_file),)
LOCAL_MODULE_TAGS += gnu
ALL_GPL_MODULE_LICENSE_FILES := $(sort $(ALL_GPL_MODULE_LICENSE_FILES) $(gpl_license_file))
endif

ANDROID_RESOURCE_GENERATED_CLASSES

Android 资源文件生成的java代码编译后的类的类型
ANDROID_RESOURCE_GENERATED_CLASSES := 'R.class' 'R
∗.class′′Manifest.class′′Manifest∗.class″Manifest.class″Manifest
*.class'
在build/core/static_java_library.mk中有用到，用于排除某些文件，使其不被打包至lib文件

Function:  print-vars

Debugging; prints a variable list to stdout
用于打印变量的值
$(1): variable name list, not variable values

Function:  true-or-empty

如果参数含有true，则返回true，否则返回空
$(1) 要测试的变量

Function:  my-dir

返回当前makefile所在目录

Function:  all-makefiles-under

获取某个目录下及子目录的所有Android.mk
$(1):需要提取Android.mk的目录

Function:  first-makefiles-under

在某个目录下的所有子目录中查找Android.mk，不包括当前目录
$(1):要搜索的目录

Function:  all-subdir-makefiles

查找当前目录及子目录下的所有Android.mk

Function:  all-named-subdir-makefiles

在当前目录下的一组子目录下查找Android.mk
$(1): List of directories to look for under this directory

Function:  all-java-files-under

找出当前makefile所在目录的指定子目录里的所有java文件
$(1) 指定子目录
使用范例：SRC_FILES := $(call all-java-files-under,src tests)

Function:  all-subdir-java-files

从当前目录查找所有java文件
使用范例： SRC_FILES := $(call all-subdir-java-files)

Function:  all-c-files-under

在指定子目录下找C代码
Find all of the c files under the named directories.
Meant to be used like:
SRC_FILES := $(call all-c-files-under,src tests)
$1: 指定子目录名称

Function:  all-subdir-c-files

查找当前目录所有子目录的c代码文件
Find all of the c files from here.  Meant to be used like:
SRC_FILES := $(call all-subdir-c-files)

Function:  all-Iaidl-files-under

在指定子目录下查找所有类似I*.aidl代码文件
Find all files named "I*.aidl" under the named directories,
which must be relative to $(LOCAL_PATH).  The returned list
is relative to $(LOCAL_PATH).
$1: 指定子目录名称

Function:  all-subdir-Iaidl-files

在$(LOCAL_PATH)下查找所有I*.aidl代码文件
Find all of the "I*.aidl" files under $(LOCAL_PATH).

Function:  all-logtags-files-under

在指定子目录下查找所有logtags文件
Find all of the logtags files under the named directories.
Meant to be used like:
SRC_FILES := $(call all-logtags-files-under,src)
查找.logtag文件
$1:指定子目录名称

Function:  all-proto-files-under

在指定子目录下查找所有.proto文件
Find all of the .proto files under the named directories.
Meant to be used like:
SRC_FILES := $(call all-proto-files-under,src)
查找.proto文件
$1:指定子目录名称

Function:  all-renderscript-files-under

在指定子目录下查找所有.rs或者.fs文件
Find all of the RenderScript files under the named directories.
Meant to be used like:
SRC_FILES := $(call all-renderscript-files-under,src)
查找.rs .fs文件
$1:指定子目录名称

Function:  all-html-files-under

在指定子目录下查找所有html文件
Find all of the html files under the named directories.
Meant to be used like:
SRC_FILES := $(call all-html-files-under,src tests)
查找.html文件
$1:指定子目录名称

Function:  all-subdir-html-files

在当前目录的子目录里查找所有html文件
Find all of the html files from here.  Meant to be used like:
SRC_FILES := $(call all-subdir-html-files)

Function:  find-subdir-files

根据find命令的规则查找所有文件
Find all of the files matching pattern
SRC_FILES := $(call find-subdir-files, )
$1 find命令的匹配规则

Function:  find-subdir-subdir-files

在指定子目录下根据find命令的规则查找文件
find the files in the subdirectory $1 of LOCAL_DIR
matching pattern $2, filtering out files $3
e.g.
SRC_FILES += $(call find-subdir-subdir-files, \
css, *.cpp, DontWantThis.cpp)
$1 LOCAL_DIR的子目录
$2 find命令的匹配规则
$3 过滤的文件

Function:  find-subdir-assets

查找所有不是软链且文件名不带后缀的文件
SRC_FILES := $(call find-subdir-assets)
$1 要进入并查找的目录

Function:  find-other-java-files

在$(LOCAL_PATH)里根据find命令的匹配规则查找java文件
$1 find命令的匹配规则

Function:  find-other-html-files

在$(LOCAL_PATH)里根据find命令的匹配规则查找html文件
$1 find命令的匹配规则

Function:  find-parent-file

在$1给出的目录及这个目录的父目录里查找$2,若找到返回该路径
Scan through each directory of $(1) looking for files
that match $(2) using $(wildcard).  Useful for seeing if
a given directory or one of its parents contains
a particular file.  Returns the first match found,
starting furthest from the root.
$1 要查找的目录集合
$2 要查找的文件

Function:  add-dependency

添加依赖关系
Function we can evaluate to introduce a dynamic dependency
$1 需要依赖其它东东的目标
$2 被依赖的东东

Function:  add-prebuilt-file

Set up the dependencies for a prebuilt target
$(call add-prebuilt-file, srcfile, [targetclass])
$(1): srcfile
$(2): target class 

Function:  add-prebuilt-files

domultipleprebuilts
$(calltargetclass,files...)
$(1)targetclass
$(2)srcfiles
使用举例：
gdbserver/Android.mk:$(calladd-prebuilt-files,EXECUTABLES,$(prebuilt_files))

Function:  intermediates-dir-for

查找中间目录并返回
The intermediates directory.  Where object files go for
a given target.  We could technically get away without
the "_intermediates" suffix on the directory, but it's
nice to be able to grep for that string to find out if
anyone's abusing the system.
# $(1): target class, like "APPS"
# $(2): target name, like "NotePad"
# $(3): if non-empty, this is a HOST target.
# $(4): if non-empty, force the intermediates to be COMMON 如果是host的common，则是out/host/common，如果是target的common，则是out/target/common
使用举例：
./development/build/Android.mk framework_res_package := $(call intermediates-dir-for,APPS,framework-res,,COMMON)/package-export.apk
./frameworks/base/core/res/Android.mk:37:framework_GENERATED_SOURCE_DIR := $(call intermediates-dir-for,JAVA_LIBRARIES,framework,,COMMON)/src
值： out/target/product/find5/obj/STATIC_LIBRARIES/libstdc++_intermediates
out/target/common/obj/JAVA_LIBRARIES/core_intermediates
out/target/common/obj/APPS/framework-res_intermediates
out/target/common/obj/JAVA_LIBRARIES/framework_intermediates

Function:  local-intermediates-dir

利用LOCAL_MODULE_CLASS, LOCAL_MODULE, and LOCAL_IS_HOST_MODULE决定中间目录  
$(1): if non-empty, force the intermediates to be COMMON
例： LOCAL_MODULE_CLASS：EXECUTABLES
LOCAL_MODULE: recovery
LOCAL_IS_HOST_MODULE empty 
$1 为空
那么返回out/target/product/find5/obj/EXECUTABLES/recovery_intermediates

Function:  normalize-libraries

将"path/to/libXXX.so"转为 -lXXX
Convert "path/to/libXXX.so" to "-lXXX".
Any "path/to/libXXX.a" elements pass through unchanged.

Function:  normalize-host-libraries

参见normalize-libraries，和之类似

Function:  normalize-target-libraries

参见normalize-libraries，和之类似

Function:  module-built-files

将模块名字转为它们对应的编译生成路径
Convert a list of short module names (e.g., "framework", "Browser")
into the list of files that are built for those modules.
NOTE: this won't return reliable results until after all
sub-makefiles have been included.
$(1): target list

Function:  module-installed-files

将模块名字转为它们对应的安装路径
Convert a list of short modules names (e.g., "framework", "Browser")
into the list of files that are installed for those modules.
NOTE: this won't return reliable results until after all
sub-makefiles have been included.
$(1): target list

Function:  module-stubs-files

将模块名字转为它们要作为公共API时链接的文件路径
Convert a list of short modules names (e.g., "framework", "Browser")
into the list of files that should be used when linking
against that module as a public API.
TODO: Allow this for more than JAVA_LIBRARIES modules
NOTE: this won't return reliable results until after all
sub-makefiles have been included.
$(1): target list
define module-stubs-files
$(foreach module,$(1),$(ALL_MODULES.$(module).STUBS))
endef

Function:  doc-timestamp-for

为文档模块转为timestamp为文件，这个文件是添加依赖时会用到的
Evaluates to the timestamp file for a doc module, which
is the dependency that should be used.
$(1): doc module

Function:  java-lib-files

Convert "core ext framework" to "out/.../javalib.jar ..."
out/target/common/JAVA_LIBRARIES/libname_indeterminates/classes.jar
out/host/common/JAVA_LIBRARIES/libname_indeterminates/classes.jar
$(1): library name list
$(2): Non-empty if IS_HOST_MODULE

Function:  java-lib-deps

多个javalib.jar
$(1): library name list
$(2): Non-empty if IS_HOST_MODULE

Function:  rot13

Run rot13 on a string rot13 是一种简易的置换暗码
$(1): the string.  Must be one line.

Function:  streq

Returns true if $(1) and $(2) are equal.  Returns
the empty string if they are not equal.

Function:  normalize-path-list

Convert "a b c" into "a:b:c"

Function:  word-colon

Read the word out of a colon-separated list of words.
This has the same behavior as the built-in function
$(word n,str).
The individual words may not contain spaces.
将用":"分隔的字符串转化为词数组
$(1): 1 based index
$(2): value of the form a:b:c...

Function:  collapse-pairs

Convert "a=b c= d e = f" into "a=b c=d e=f" ，注意空格
$(1): list to collapse
$(2): if set, separator word; usually "=", ":", or ":="
Defaults to "=" if not set.

Function:  uniq-pairs-by-first-component

Given a list of pairs, if multiple pairs have the same
first components, keep only the first pair.
$(1): list of pairs
$(2): the separator word, such as ":", "=", etc.

Function:  modules-for-tag-list

Given a list of pairs, if multiple pairs have the same
first components, keep only the first pair.
$(1): list of pairs
$(2): the separator word, such as ":", "=", etc.
ALL_MODULE_TAGS.eng：out/target/product/find5/system/bin/recovery

Function:  module-names-for-tag-list

Given a list of tags, return the targets that specify
any of those tags.
$(1): tag list
ALL_MODULE_NAME_TAGS.eng: recovery libbmlutils libdedupe utility_dedupe libcrecovery libmmcutils updater libapplypatch applypatch_static su.recovery

Function:  get-tagged-modules

Given an accept and reject list, find the matching set of targets.  If a target has multiple tags and
any of them are rejected, the target is rejected.
Reject overrides accept.
$(1): list of tags to accept
$(2): list of tags to reject

Function:  append-path

Append a leaf to a base path.  Properly deals with
base paths ending in /.
$(1): base path
$(2): leaf path

Function:  get-package-overrides

Packagefiltering
#Givenalistofinstalledmodules(shortorlongnames)
#returnalistofthepackages(yes,.apkpackages,not
#modulesingeneral)thatareoverriddenbythislistand,
#therefore,shouldnotbeinstalled.
#$(1):mixedlistofinstalledmodules
#TODO:Thisisfragile;findareliablewaytogetthisinformation.

Function:  pretty

Output the command lines, or not
如果编译时传递了添加了showcommands参数，调用pretty会打印正在执行的命令
如果没有传递showcommand参数，则不会打印正在执行的命令

Function:  dump-module-variables

Dump the variables that are associated with targets
打印编译时的一些参数
主要是一些PRIVATE变量，例如PRIVATE_YACCFLAGS

Function:  transform-variables

Commands for using sed to replace given variable values

Function:  transform-d-to-p-args

CommandsformungingthedependencyfilesGCCgenerates
$(1):theinput.dfile
$(2):theoutput.Pfile

Function:  transform-d-to-p

参见 transform-d-to-p-args 

Function:  transform-l-to-cpp

Commands for running lex
举例：
ifneq ($(strip $(lex_cpps)),)
$(lex_cpps): $(intermediates)/%$(LOCAL_CPP_EXTENSION): \
$(TOPDIR)$(LOCAL_PATH)/%.l
$(transform-l-to-cpp)

Function:  transform-y-to-cpp

Commands for running yacc
Because the extension of c++ files can change, the
extension must be specified in $1.
E.g, "$(call transform-y-to-cpp,.cpp)"

Function:  transform-renderscripts-to-java-and-bc

Commands to compile RenderScript

Function:  transform-aidl-to-java

Commands for running aidl

Function:  transform-logtags-to-java

Commands for running java-event-log-tags.py

Function:  transform-proto-to-java

Commands for running protoc to compile .proto into .java

Function:  transform-proto-to-cc

Commands for running protoc to compile .proto into .pb.cc and .pb.h

Function:  transform-cpp-to-o

Commands for running gcc to compile a C++ file

Function:  transform-c-or-s-to-o-no-deps

Commands for running gcc to compile a C file
# $(1): extra flags

Function:  transform-c-to-o-no-deps

编译c文件至目标文件,无依赖的编译
# $(1): extra flags

Function:  transform-s-to-o-no-deps

编译汇编文件至目标文件，无依赖的编译
$(1): extra flags

Function:  transform-c-to-o

编译c文件至目标文件
# $(1): extra flags 编译参数

Function:  transform-s-to-o

编译汇编文件至目标文件
$(1): extra flags，编译参数

Function:  transform-m-to-o-no-deps

Commands for running gcc to compile an Objective-C file
This should never happen for target builds but this
will error at build time.

Function:  transform-m-to-o

编译objet c文件至目标文件
$(1): extra flags，编译参数  

Function:  transform-host-cpp-to-o

Commands for running gcc to compile a host C++ file
编译cpp文件，目标代码将在主机上运行
$(1): extra flags

Function:  transform-host-c-or-s-to-o-no-deps

Commands for running gcc to compile a host C file
编译c代码或者汇编代码，目标代码将在主机上运行，无依赖的编译
$(1): extra flags

Function:  transform-host-c-to-o-no-deps

Commands for running gcc to compile a host C file
编译c代码，目标代码将在主机上运行，无依赖的编译
$(1): extra flags

Function:  transform-host-s-to-o-no-deps

编译汇编代码，目标代码将在主机上运行，无依赖的编译
$(1): extra flags

Function:  transform-host-c-to-o

编译c代码，目标代码将在主机上运行
$(1): extra flags

Function:  transform-host-s-to-o

编译汇编代码，目标代码将在主机上运行
$(1): extra flags

Function:  transform-host-m-to-o-no-deps

Commands for running gcc to compile a host Objective-C file
编译object c代码，目标代码将在主机上运行，无依赖编译
$(1): extra flags

Function:  transform-host-m-to-o

Commands for running gcc to compile a host Objective-C file
编译object c代码，目标代码将在主机上运行，
$(1): extra flags

Function:  _concat-if-arg2-not-empty

Commands for running ar

Function:  split-long-arguments

Split long argument list into smaller groups and call the command repeatedly
Call the command at least once even if there are no arguments, as otherwise
the output file won't be created. 
$(1): the command without arguments
$(2): the arguments

Function:  extract-and-include-target-whole-static-libs

$(1): the full path of the source static library.

Function:  transform-o-to-static-lib

Explicitly delete the archive first so that ar doesn't
try to add to an existing archive.
将目标代码打包成静态库

Function:  extract-and-include-host-whole-static-libs

Commands for running host ar
$(1): the full path of the source static library.
静态库将在主机上运行

Function:  transform-host-o-to-static-lib

将目标代码打包成在主机上运行的静态库
静态库将在主机上运行

Function:  transform-host-o-to-shared-lib-inner

Commands for running gcc to link a shared library or package
ld just seems to be so finicky with command order that we allow
it to be overriden en-masse see combo/linux-arm.make for an example.
将目标代码打包成在主机上运行的动态库或者包

Function:  transform-host-o-to-shared-lib

参见transform-host-o-to-shared-lib-inner

Function:  transform-host-o-to-package

参见transform-host-o-to-shared-lib-inner

Function:  transform-o-to-shared-lib-inner

Commands for running gcc to link a shared library or package 
ld just seems to be so finicky with command order that we allow
it to be overriden en-masse see combo/linux-arm.make for an example.
将目标代码打包成在目标机上运行的动态库

Function:  transform-o-to-shared-lib

参见transform-o-to-shared-lib-inner

Function:  transform-o-to-package

参见transform-o-to-shared-lib-inner

Function:  transform-to-stripped

Commands for filtering a target executable or library

Function:  transform-o-to-executable-inner

Commandsforrunninggcctolinkanexecutable
编译成可执行文件

Function:  transform-o-to-executable

参见transform-o-to-executable-inner

Function:  transform-o-to-static-executable-inner

Commandsforrunninggcctolinkastaticallylinked
executable.Inpractice,weonlyusethisonarm,so
theotherplatformsdon'thavethe
transform-o-to-static-executabledefined

Function:  transform-o-to-static-executable

参见transform-o-to-static-executable-inner

Function:  transform-host-o-to-executable-inner

Commands for running gcc to link a host executable

Function:  transform-host-o-to-executable

参见transform-host-o-to-executable-inner

Function:  create-resource-java-files

Commandsforrunningjavactomake.classfiles
@echo"Sourceintermediatesdir:$(PRIVATE_SOURCE_INTERMEDIATES_DIR)"
@echo"Sourceintermediates:$$(find$(PRIVATE_SOURCE_INTERMEDIATES_DIR)-name'*.java')"
ThisrulecreatestheR.javaandManifest.javafiles,bothofwhich
arePRODUCT-neutral.Don'tpassPRIVATE_PRODUCT_AAPT_CONFIGtothisinvocation.

Function:  emit-line

emit-line

Function:  dump-words-to-file

dump-words-to-file

Function:  unzip-jar-files

For a list of jar files, unzip them to a specified directory,
but make sure that no META-INF files come along for the ride.
$(1): files to unzip
$(2): destination directory

Function:  compile-java

Common definition to invoke javac on the host and target.
Some historical notes:
- below we write the list of java files to java-source-list to avoid argument
list length problems with Cygwin
- we filter out duplicate java file names because eclipse's compiler
doesn't like them.
$(1): javac
$(2): bootclasspath

Function:  transform-java-to-classes.jar

将java编译并打包成classes.jar

Function:  transform-classes.jar-to-emma

emma代码覆盖率测试

Function:  transform-classes.jar-to-dex

将classes.jar转化为dex

Function:  create-empty-package

Create a mostly-empty .jar file that we'll add to later.
The MacOS jar tool doesn't like creating empty jar files,
so we need to give it something.

Function:  add-assets-to-package

TODO: we kinda want to build different asset packages for
different configurations, then combine them later (or something).
Per-locale, etc.
A list of dynamic and static parameters;build layers for
dynamic params that lay over the static ones.
TODO: update the manifest to point to the package file
Note that the version numbers are given to aapt as simple default
values; applications can override these by explicitly stating
them in their manifest.
将资源文件打包到package

Function:  add-jni-shared-libs-to-package

将jni 动态库打包到package

Function:  add-dex-to-package

将dex打包到package

Function:  add-java-resources-to-package

Add java resources added by the current module.

Function:  add-carried-java-resources

Add java resources carried by static Java libraries.

Function:  sign-package

Sign a package using the specified key/cert.

Function:  align-package

Align STORED entries of a package on 4-byte boundaries
to make them easier to mmap.

Function:  install-dex-debug

安装debug版本的dex文件

Function:  transform-host-java-to-package

TODO(joeo):Ifwecaneverupgradetopost3.81makeandgetthe
newprebuiltrulestowork,weshouldchangethistocopythe
resourcestotheoutdirectoryandthencopytheresources.
Note:weintentionallydon'tcleanPRIVATE_CLASS_INTERMEDIATES_DIR
intransform-java-to-classesforthesakeofvm-tests.

Function:  obfuscate-jar

Obfuscate a jar file
PRIVATE_KEEP_FILE is a file containing a list of classes
PRIVATE_INTERMEDIATES_DIR is a directory we can use for temporary files
The module using this must depend on
$(HOST_OUT_JAVA_LIBRARIES)/proguard-4.0.1.jar
混淆代码

Function:  copy-one-header

Commands for copying files 
Define a rule to copy a header.  Used via $(eval) by copy_headers.make.
$(1): source header
$(2): destination header

Function:  copy-one-file

Define a rule to copy a file.  For use via $(eval).
$(1): source file
$(2): destination file

Function:  copy-many-files

Copies many files.
$(1): The files to copy.  Each entry is a ':' separated src:dst pair
Evaluates to the list of the dst files (ie suitable for a dependency list)

Function:  copy-xml-file-checked

Copy the file only if it's a well-formed xml file. For use via $(eval).
$(1): source file
$(2): destination file, must end with .xml.

Function:  copy-file-to-target

The -t option to acp and the -p option to cp is
required for OSX.  OSX has a ridiculous restriction
where it's an error for a .a file's modification time
to disagree with an internal timestamp, and this
macro is used to install .a files (among other things).
Copy a single file from one place to another,
preserving permissions and overwriting any existing
file.
We disable the "-t" option for acp cannot handle
high resolution timestamp correctly on file systems like ext4.
Therefore copy-file-to-target is the same as copy-file-to-new-target.

Function:  copy-file-to-target-with-cp

The same as copy-file-to-target, but use the local
cp command instead of acp.

Function:  copy-file-to-target-with-zipalign

The same as copy-file-to-target, but use the zipalign tool to do so.

Function:  copy-file-to-target-strip-comments

The same as copy-file-to-target, but strip out "# comment"-style
comments (for config files and such).

Function:  copy-file-to-new-target

The same as copy-file-to-target, but don't preserve
the old modification time.

Function:  copy-file-to-new-target-with-cp

The same as copy-file-to-new-target, but use the local
cp command instead of acp.

Function:  transform-prebuilt-to-target

Copy a prebuilt file to a target location.

Function:  transform-prebuilt-to-target-with-zipalign

Copyaprebuiltfiletoatargetlocation,usingzipalignonit.

Function:  transform-prebuilt-to-target-strip-comments

Copy a prebuilt file to a target location, stripping "# comment" comments.

Function:  transform-host-ranlib-copy-hack

Onsomeplatforms(MacOS),aftercopyingastatic
library,ranlibmustberuntoupdateaninternal
timestamp!?!?!

Function:  proguard-disabled-commands

Commands to call Proguard
Command to copy the file with acp, if proguard is disabled.

Function:  proguard-enabled-commands

Command to copy the file with acp, if proguard is disabled.

Function:  get-instrumentation-proguard-flags

Figure out the proguard dictionary file of the module that is instrumentationed for.

Function:  transform-jar-to-proguard

将jar混淆

Function:  transform-generated-source

Stuffsourcegeneratedfromone-offtools

Function:  image-size-from-data-size

将data分区大小(在/proc/mtd里存储)转为能够刷入该分区的img文件大小
Convert a partition data size (eg, as reported in /proc/mtd) to the
size of the image used to flash that partition (which includes a
spare area for each page).
$(1): the partition data size

Function:  assert-max-file-size

确保文件大小不超过某个数值
$(1): The file(s) to check (often $@)
$(2): The maximum total image size, in decimal bytes
$(3): the type of filesystem "yaffs" or "raw"
If $(2) is empty, evaluates to "true"  
Reserve bad blocks.  Make sure that MAX(1% of partition size, 2 blocks)
is left over after the image has been flashed.  Round the 1% up to the
next whole flash block size.

Function:  assert-max-image-size

确保image大小不超过某个数值
Like assert-max-file-size, but the second argument is a partition
size, which we'll convert to a max image size before checking it
against the files. 
$(1): The file(s) to check (often $@)
$(2): The partition size.

Function:  add-radio-file

添加radio包
Define device-specific radio files
Copy a radio image file to the output location, and add it to
INSTALLED_RADIOIMAGE_TARGET.
$(1): filename 

Function:  add-radio-file-checked

Version of add-radio-file that also arranges for the version of the
file to be checked against the contents of
$(TARGET_BOARD_INFO_FILE).
$(1): filename
$(2): name of version variable in board-info (eg, "version-baseband")

Function:  inherit-package

Override the package defined in $(1), setting the
variables listed below differently.
$(1): The makefile to override (relative to the source
tree root)
$(2): Old LOCAL_PACKAGE_NAME value.
$(3): New LOCAL_PACKAGE_NAME value.
$(4): New LOCAL_MANIFEST_PACKAGE_NAME value.
$(5): New LOCAL_CERTIFICATE value.
$(6): New LOCAL_INSTRUMENTATION_FOR value.
$(7): New LOCAL_MANIFEST_INSTRUMENTATION_FOR value.
Note that LOCAL_PACKAGE_OVERRIDES is NOT cleared in
clear_vars.mk.

Function:  set-inherited-package-variables

To be used with inherit-package above
Evalutes to true if the package was overridden

Function:  keep-or-override

参见inherit-package

Function:  expand-required-modules

Expand a module name list with REQUIRED modules
$(1): The variable name that holds the initial module name list.
the variable will be modified to hold the expanded results.
$(2): The initial module name list.
Returns empty string (maybe with some whitespaces).

Function:  check-api

API Check
eval this to define a rule that runs apicheck. 
Args:
$(1)  target
$(2)  stable api file
$(3)  api file to be tested
$(4)  arguments for apicheck
$(5)  command to run if apicheck failed
$(6)  target dependent on this api check
$(7)  additional dependencies