Android makefile 组织结构

以你之姓@ 2022-02-14 00:42 266阅读 0赞

下面是main.mk文件包含关系，本文档主要说明的就是这些文件里到底做了什么。（这个文件被根目录下的makefile文件包含）

![0_1311081586v8sE.gif][]

![20130524153832798][]

**一.     main.mk**

BUILD\_SYSTEM=build/core

** **

1.检查版本号，设置环境变量（BUILD\_SYSTEM）和缺省的目标。$(MAKE\_VERSION) >= 3.81,BUILD\_SYSTEM= build/core

2.包含文件[BUILD\_SYSTEM/config.mk][BUILD_SYSTEM_config.mk]。根据配置信息和主机目标机信息，设置一些变量。

3.包含文件[BUILD\_SYSTEM/cleanbuild.mk][BUILD_SYSTEM_cleanbuild.mk]。如果当前配置改变，强制删除上次的编译结果

4.包含文件OUT\_DIR/version\_check.mk。就设置了VERSIONS\_CHECKED。如果版本序号改变，即VERSION\_CHECK\_SEQUENCE\_NUMBER！＝VERSIONS\_CHECKED，检查文件系统是否大小写不敏感。文件路径上是否没有空格。JAVA，JAVAC的版本是否是1.6。

5.包含文件BUILD\_SYSTEM/definitions.mk。定义了很多函数供makefile文件系统使用。

主要的是transform-xxx-to-xxx的形式，比如transform-cpp-to-o。并定义了一个make目标dist,额外的拷贝一些重要的文件到目标文件夹。

6.检查MAKECMDGOALS和TARGE\_BUILD\_VARIANT.根据MAKECMDGOALS设置标量is\_sdk\_build，是否编译SDK。

7.根据TARGE\_BUILD\_VARIANT，设置tags\_to\_install,ADDITIONAL\_DEFAULT\_PROPERTIES

>  
> 
> <table> 
> <tbody> 
> <tr> 
> <td>&nbsp;TARGE_BUILD_VARIANT</td> 
> <td>tags_to_install&nbsp;</td> 
> <td>&nbsp;ADDITIONAL_DEFAULT_PROPERTIES</td> 
> </tr> 
> <tr> 
> <td>user</td> 
> <td>user</td> 
> <td>ro.secure=1 ro.allow.mock.location=0</td> 
> </tr> 
> <tr> 
> <td>eng</td> 
> <td>user debug eng</td> 
> <td>ro.setupwizard.mode=OPTIONAL</td> 
> </tr> 
> <tr> 
> <td>tests</td> 
> <td>user debug eng</td> 
> <td> </td> 
> </tr> 
> <tr> 
> <td>sdk</td> 
> <td>user debug eng</td> 
> <td>xmpp.auto-presence=true ro.config.nocheckin=yes</td> 
> </tr> 
> <tr> 
> <td>user debug</td> 
> <td>user debug</td> 
> <td>ro.sercure=1 dalvik.vm.lockprof.threshold=500&nbsp; ro.allow.mock.location=0 ro.debuggable=1 persist.service.adb=1</td> 
> </tr> 
> </tbody> 
> </table>
> 
>

8.检查PARDUCT\_TAG是否包含dalvik.gc.type-precise，如果包含设置ADDITIONAL\_DEFAULT\_PROPERTIES＋＝dalvik.vm.dexopt-flags=m=y

9.判断PRODUCT\_COPY\_FILES。为空就安装apns-conf.xml文件

PRODUCT\_COPY\_FILE＝development/data/etc/apns-conf\_sdk.xml:system/etc/apns-conf.xml

如果TARGE\_BUILD\_VARIANT包含eng,tests但不包含sdk，且vendor/google/etc/apns-conf.xml文件存在，则PRODUCT\_COPY\_FILE＝vendor/google/etc/apns-conf.xml：system/etc/apns-conf.xml

10.设置ADDITIONAL\_BUILD\_PROPERTIES+= net.bt.name=Android

dalvik.vm.stack-trace-file=/data/anr/traces.txt

11.如果MAKECMDGOALS仅包含showcommands或checkbuild，设置make目标为DEFAULT\_GOALS

12.如果MAKECMDGOALS不包含clean,clobber,dataclean,installclean,根据不同的主机平台和处理器品平台，包含进要编译的模块，设置subdirs。

13.通过build/tools/findleaves.py，把subdirs目录下的Android.mk存在subdirs\_makefiles。并包含这些文件。如果使用mm命令，只包含当前目录下的Android.mk。

14.若是全部编译，包含frameworks/policies/base/PolicyConfig.mk。生成android.policy模块，并定义了自己的make删除操作policy\_installclean。

15.根据tags\_to\_install和is\_sdk\_build,设置哪些模块需要安装，并存入modules\_to\_install.

这里主要有两个函数要说明一下：

get-tagged-modules $1 $2  这两个参数一般都是ALL\_MODULE\_TAGS＝debug eng gnuoptional samples testsuser里面的值，取得$1中不包括$2的列表，比如tests user，返回$(ALL\_MODULE\_TAGS.user)$(ALL\_MODULE\_TAGS.tests)即带有user或tests标记模块的目标文件路径列表。

Module-installed-files $1  $1一般的是一个短的模块名，比如framework,Browers，返回这个模块的目标文件路径

16.包含：[$(BUILD\_SYSTEM)/Makefile][BUILD_SYSTEM_Makefile]。主要是定义了一些伪目标。

17.定义modules\_to\_check，文件路径列表，若模块没有定义LOCAL\_DONT\_CHECK\_MODULE,会把生成目标的规则加入到这个变量，以便在modules\_to\_install后检查目标是否生成成功，目标不存在的话再次生成目标。

18.定义一些make target

<table style="color:rgb(0,0,0); font-family:Arial; font-size:13.63636302947998px; line-height:25.99431800842285px"> 
 <tbody> 
 <tr> 
 <td> target </td> 
 <td> 说明 </td> 
 </tr> 
 <tr> 
 <td> .PHONY:checkbuilt checkbuilt: $(modules-to-check) </td> 
 <td> 生成没有定义LOCAL_DONT_CHECK_MODULE的模块并拷贝到系统目录 </td> 
 </tr> 
 <tr> 
 <td> .PHONY:prebuilt prebuit: $(ALL_PREBUILT) </td> 
 <td> 拷贝预遍野的文件(比如用include prebuild.mk编译的)到系统目录 </td> 
 </tr> 
 <tr> 
 <td> .PHONY: files files: prebuilt checkbuilt moduls-to-install&nbsp; $(INSTALLED_ANDROID_INFO_TXT_TARGET) &nbsp;&nbsp;&nbsp;&nbsp; </td> 
 <td> 生成所有目标文件(包括：prebuile,modules-to-install,modules-to-check,INSTALLED_ANDROID_INFO_TXT_TARGET)并拷贝到系统目录。INSTALLED_ANDROID_INFO_TXT_TARGET在build/target/board/Android.mk定义＝out/target/product/**/android-info.txt </td> 
 </tr> 
 <tr> 
 <td> .PHONY: ramdisk ramdisk: $(INSTALL_RAMDISK_TARGET) </td> 
 <td> 生成ramdisk.img $(HOST_OUT_EXECUTABLES)/mkbootfs $(PRODUCT_OUT)/root|$(HOST_OUT_EXECUTABLES)/minizip &gt;&nbsp; $(PRODUCT_OUT)/ramdisk.img </td> 
 </tr> 
 <tr> 
 <td> .PHONY: systemimage systemimage: $(INSTALL_SYSTEMIMAGE) </td> 
 <td> 生成system.img $(INSTALLED_SYSTEMIMAGE): $(BUILT_SYSTEMIMAGE) $(HOST_OUT_EXECUTABLES)/mkyaffs2image$(PRODUCT_OUT)/system$(PRODUCT_OUT)/obj/PACKING/systemimage_unopt_intermediates/system.img cp **/system.img (PRODUCT_OUT)/system.img </td> 
 </tr> 
 <tr> 
 <td> .PHONY: userdataimage userdataimage:$(INSTALL_USERDATAIMAGE_TARGET) </td> 
 <td> 生成data.img $(HOST_OUT_EXECUTABLES)/mkyaffs2image $(PRODUCT_OUT)/data $(PRODUCT_OUT)/data.img </td> 
 </tr> 
 <tr> 
 <td> .PHONY: bootimage bootimage: $(INSTALL_BOOTIMAGE_TARGET) </td> 
 <td> 生成boot.img if(TARGET_NO_KERNEL=true), INSTALL_BOOTIMAGE_TARGET=$(PRODUCT_OUT)/boot.img else $(PRODUCT_OUT)/boot.img=. 参数： INTERNAL_BOOTIMAGE_ARGS := \ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; $(addprefix --second ,$(INSTALLED_2NDBOOTLOADER_TARGET)) \ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; --kernel $(INSTALLED_KERNEL_TARGET) \ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; --ramdisk $(INSTALLED_RAMDISK_TARGET) $(HOST_OUT_EXECUTABLES)/mkbootimg&nbsp;--kernel $(PRODUCT_OUT)/kernel –ramdisk $(PRODUCT_OUT)/ramdisk.img &gt;$(PRODUCT_OUT)/boot.img </td> 
 </tr> 
 <tr> 
 <td> .PHONY: recoveryimage recoveryimage:$(INSTALL_RECOVERYIMAGE_TARGET) </td> 
 <td> 生成ramdisk-recovery.img recovery.img 目录$(PRODUCT_OUT) rm -rf&nbsp; recovery mkdir -p recovery &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; mkdir -p recovery/root mkdir -p recovery/root/etc mkdir -p recovery/root/tmp cp -R root&nbsp; recovery/root cp -f&nbsp; /bootable/recovery/init.rc recovery/root/ cp -f&nbsp; obj/EXECUTABLES/recovery_intermediates/recovery&nbsp; recovery/root/sbin/ cp -rf&nbsp; /bootable/recovery/res recovery/root/ $(foreach item,/build/target/product/**/recovery/res cp -rf $(item) recovery/root/) cp /obj/PACKAGING/ota_keys_ intermediates/keys recovery/res/keys cat root/default.prop system/build.prop &gt; recovery/root/default.prop &nbsp; $(HOST_OUT_EXECUTABLES)/mkbootfs$(PRODUCT_OUT)/recovery/root|$(HOST_OUT_EXECUTABLES)/minizip &gt;&nbsp;$(PRODUCT_OUT)/ramdisk-recovery.img $(HOST_OUT_EXECUTABLES)/mkbootimg&nbsp;--kernel $(PRODUCT_OUT)/kernel –ramdisk$(PRODUCT_OUT)/ramdisk-recovery.img &gt; $(PRODUCT_OUT)/recovery.img </td> 
 </tr> 
 <tr> 
 <td> &nbsp; </td> 
 <td> &nbsp; </td> 
 </tr> 
 <tr> 
 <td> .PHONY: droidcore droidcore: files \ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; systemimage \ $(INSTALLED_BOOTIMAGE_TARGET) \ $(INSTALLED_RECOVERYIMAGE_TARGET) \ $(INSTALLED_USERDATAIMAGE_TARGET) \ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; $(INSTALLED_FILES_FILE) </td> 
 <td> 生成整个系统 system.img ramdisk.img/boot.img ramdisk-recovery.img recovery.img userdata.img&nbsp; installed-files.txt </td> 
 </tr> 
 <tr> 
 <td> .PHONY: apps_only </td> 
 <td> 生成TARGET_BUILD_APPS指定的APPS模块. 若TARGET_BUILD_APPS包含all就编译全部APPS模块 </td> 
 </tr> 
 <tr> 
 <td> droid </td> 
 <td> 默认target。 ifneq ($(TARGET_BUILD_APPS),) &nbsp;&nbsp; droid: apps_only else &nbsp;&nbsp; droid:droidcore </td> 
 </tr> 
 <tr> 
 <td> .PHONY: sdk </td> 
 <td> 生成sdk </td> 
 </tr> 
 <tr> 
 <td> .PHONY: clean .PHONY: clobber </td> 
 <td> 删除生成文件 </td> 
 </tr> 
 <tr> 
 <td> .PHONY: modules </td> 
 <td> 显示所有模块名 </td> 
 </tr> 
 <tr> 
 <td> .PHONY: showcommands </td> 
 <td> 显示命令 </td> 
 </tr> 
 </tbody> 
</table>

**二.    config.mk**

1.设置一些原文件路径，以SRC\_开头

2.包含文件$(BUILD\_SYSTEM)/pathmap.mk，定义了一些短名到长路径名的影射，

存放在pathmap\_INCL,通过include-path-for $1 根据短名获取到长路径名FRAMEWORKS\_BASE\_JAVA\_SRC\_DIRS 保存了所有要编进Android.jar的framework/base下的文件路径。

3.设置编译目标，.jar,.bin,.so,.a,.apk,...。以BUILD\_开头，指向具体的mk文件。比如BUILD\_STATIC\_LIBRARY:= $(BUILD\_SYSTEM)/static\_library.mk

4.设置一般编译选项和不同类型的文件后缀名。以COMMON\_开头。COMMON\_GLOBAL\_CFLAGS，COMMON\_RELEASE\_CFLAGS。COMMON\_PACKAGE\_SUFFIX：＝.zip

5.包含include$(TOPDIR)buildspec.mk。设置一些主要的变量，比如目标产品名称。这些都要我们在make之前设置。这个文件有个模版是build/buildspec.mk.default。

6.包含[include$(BUILD\_SYSTEM)/envsetup.mk][include_BUILD_SYSTEM_envsetup.mk]。设置一些跟product相关的变量。

7.在build/target/board/$(TARGET\_DEVICE)/BroadConfig.mk,device/\*/$(TARGET\_DEVICE)/BroadConfig.mk veror/\*/$(TARGET\_DEVICE)/BroadConfig.mk 这三个路径下，查找product的目标设备的BroadConfig.mk文件。并包含进来。BroadConfig.mk设置了每个设备的自己的一些变量值，来区别编译时的行为。TARGET\_CPU\_ABI 必须要设置。这些设备是被product.mk中 TARGET\_DEVICE指定，一个设备信息可以被很多个product使用。

8.设置combo\_target := HOST\_，包含include $(BUILD\_SYSTEM)/combo/select.mk。

根据操作系统和CPU类型设置以HOST\_开头的变量，并包含include$(BUILD\_SYSTEM)/combo/HOST\_$(HOST\_OS)\_$(HOST\_ARCH).mk,其中HOST\_OS是主机操作系统，HOST\_ARCH是主机CPU类型，比如HOST\_linux\_x86.mk.在这个文件里修改以HOST\_开头的变量，主要是向HOST\_GLOBAL\_CFLAGS添加标志。

9.设置combo\_target := TARGET\_，包含include $(BUILD\_SYSTEM)/combo/select.mk。

根据操作系统和CPU类型设置以TARGET\_开头的变量，并包含include$(BUILD\_SYSTEM)/combo/TARGET\_$(TARGET\_OS)\_$(TARGET\_ARCH).mk,其中TARGET\_OS是目标操作系统，TARGET\_ARCH是目标CPU类型，比如TARGET\_linux\_arm.mk.在这个文件里修改以TARGET\_开头的变量，主要是设置交叉编译工具和参数和基本的系统头文件。定义了transform-o-to-shared-lib-inner，transform-o-to-executable-inner，transform-o-to-static-executable-inner三个函数，把.o文件分别转化成共享库文件，可执行文件，静态库文件。

10.包含 include$(BUILD\_SYSTEM)/combo/javac.mk。得到一个JAVAC编译器

11.检查BUILD\_ENV\_SEQUENCE\_NUMBER，这个是在前面的buildspec.mk设置或者通过envsetup.sh脚本设置。

12.设置主机通用工具变量。其中一些是主机自带的LEX:= flex

YACC:=bison -d   DOXYGEN:= doxygen,还有一些是在/out/target/$($(HOST\_OS)-$(HOST\_ARCH))/bin下的程序，MKBOOTIMG:=$(HOST\_OUT\_EXECUTABLES)/mkbootimg。

13.设置最终的编译连接参数。有如下参数变量：

HOST\_GLOBAL\_CFLAGS，   HOST\_RELEASE\_CFLAGS，     HOST\_GLOBAL\_CPPFLAGS，

HOST\_RELEASE\_CPPFLAGS， TARGET\_GLOBAL\_CFLAGS，   TARGET\_RELEASE\_CFLAGS，

TARGET\_GLOBAL\_CPPFLAGS，TARGET\_RELEASE\_CPPFLAGS， HOST\_GLOBAL\_LD\_DIRS，

TARGET\_GLOBAL\_LD\_DIRS， HOST\_PROJECT\_INCLUDES，   TARGET\_PROJECT\_INCLUDES，

13.获得sdk和ndk的版本号列表。TARGET\_AVAILABLE\_SDK\_VERSIONS和TARGET\_AVAILABLE\_NDK\_VERSIONS

**三.  envsetup.mk**

1.包含：include$(BUILD\_SYSTEM)/version\_defaults.mk 设置那些我们需要设置的变量的缺省值。这个文件我们不因该改动，改动应该在build\_id.mk里。

2.设置在文件buildspec.mk里或通过envsetup.sh设置的变量的缺省值。

3.包含：[include$(BUILD\_SYSTEM)/product\_config.mk][include_BUILD_SYSTEM_product_config.mk]。定义了两种MAKECMDGOALS参数形式，根据product和device目录下的mk文件生成相应的PRODUCTS\_xxx\_xxx和DEVICES\_xxx\_xxx变量。中间的是文件的路径，后面的是文件里定义的变量。

4.设置一些列路径变量。主机路径以HOST\_OUT\_\* 或HOST\_\*\_OUT\_\*形式，目标机路径以TARGET\_OUT\_\* 或TARGET\_\*\_OUT\_\*形式。

5.根据MAKECMDGOALS，若其中包含dumpvar-%或dumpvar-abs-%，就生成一个以dumpvar-%或dumpvar-abs-%命名的make目标。实现是打印出％所表示的变量的值。这个变量必须要在这之前已经定义了，后一种在前面还打印出当前的路径。这两种情况必须要先设置CALLED\_FROM\_SETUP=true。envsetup.sh的get\_build\_var和get\_abs\_build\_var()函数就是运用的这个原理打印变量的值。

[view plain][]

1.  \# Get the exact value of a buildvariable.  
2.  function get\_build\_var()  
3.  \{  
4.     T=$(gettop)  
5.     if \[ ! "$T" \]; then  
6.         echo "Couldn't locate the top of the tree.  Try setting TOP." **>**&2  
7.         return  
8.     fi  
9.     CALLED\_FROM\_SETUP=true BUILD\_SYSTEM=build/core \\  
10.    make--no-print-directory -C "$T" -f build/core/config.mk dumpvar-$1  
11. \}  
12. \# Get the value of a build variable asan absolute path.  
13. function get\_abs\_build\_var()  
14. \{  
15.   T=$(gettop)  
16.   if \[ ! "$T" \]; then  
17.        echo "Couldn't locate the top of the tree.  Try setting TOP." **>**&2  
18.        return  
19.    fi  
20.    CALLED\_FROM\_SETUP=true BUILD\_SYSTEM=build/core \\  
21.    make --no-print-directory -C "$T"-f build/core/config.mk dumpvar-abs-$1  
22. \}

**四. product\_config.mk**

1.定义两种命令形式:

makePRODUCT-<prodname>-<goal>

TARGET\_PRODUCT := prodname  TARGET\_BUILD\_VARIANT := goal

make APP-<appnames>

TARGET\_BUILD\_APPS := appnames

2.包含：include$(BUILD\_SYSTEM)/node\_fns.mk

include $(BUILD\_SYSTEM)/product.mk

include $(BUILD\_SYSTEM)/device.mk

这三个文件主要是定义了一些函数来相互调用或供product\_config.mk文件调用

3.调用import-products函数，判断TARGET\_BUILD\_APPS是否为空，若为空，只导入

$(SRC\_TARGET\_DIR)/product/AndroidProducts.mk里的mk文件。否则调用get-all-product-makefiles，导入全部mk文件。再调用check-all-products检查变量设置的正确性。

4.根据要编译的目标TARGET\_PRODUCT,通过调用resolve-short-product-name得到mk文件,结果存放在INTERNAL\_PRODUCT变量里。再将PRODUCTS.$(INTERNAL\_PRODUCT).PRODUCT\_xxx的值赋值给PRODUCT\_xxx。ADDITIONAL\_BUILD\_PROPERTIES追加PRODUCT\_PROPERTY\_OVERRIDES。这些PRODUCT\_变量都在product下的mk文件里定义。如下：

TARGET\_DEVICE,PRODUCT\_LOCALES ,PRODUCT\_BRAND, PRODUCT\_MODEL, PRODUCT\_MANUFACTURER, PRODUCT\_DEFAULT\_WIFI\_CHANNELS, PRODUCT\_POLICY,PRODUCT\_COPY\_FILES, PRODUCT\_PROPERTY\_OVERRIDES, PRODUCT\_PACKAGE\_OVERLAYS,  DEVICE\_PACKAGE\_OVERLAYS,  PRODUCT\_TAGS,PRODUCT\_OTA\_PUBLIC\_KEYS

**五.  cleanbuild.mk**

1. 定义了add-clean-step函数。有一个入口参数$(1)，执行删除操作的具体shell命令。  
一般add-clean-step应当在%/cleanspec.mk脚本中使用，命令会为$(1)定义一个变量保存，变量的名字是INTERNAL\_STEP.$(\_acs\_id)，所有的$(\_acs\_id)保存在INTERNAL\_STEPS中。$(\_acs\_id)的值分成3个部分构造：  
第一部分是有cleanspec.mk的路径转化而来，用'\_'替代'/'，'-'替代'.'，后缀\_acs。

第二部分是$(INTERNAL\_CLEAN\_BUILD\_VERSION)，默认是4。

第三部分是有'@'组成，cleanspec.mk中的第几个add- clean-step就用几个@。

例如，packages/apps/Camera/cleanspec.mk中定义了两个删除动作

$(call add-clean-step, rm -rf $(PRODUCT\_OUT)/obj/APPS/Camera\*)  
$(call add-clean-step, rm -rf $(OUT\_DIR)/target/common/obj/APPS/Camera\*)  
那么，对应的生成变量有:

INTERNAL\_STEP.packages\_apps\_Camera\_CleanSpec-mk\_acs4@:= rm -rf $(PRODUCT\_OUT)/obj/APPS/Camera\*  
INTERNAL\_STEP.packages\_apps\_Camera\_CleanSpec-mk\_acs4@@ := rm -rf$(OUT\_DIR)/target/common/obj/APPS/Camera\*

INTERNAL\_CLEAN\_STEPS+=packages\_apps\_Camera\_CleanSpec-mk\_acs4@:

INTERNAL\_CLEAN\_STEPS+packages\_apps\_Camera\_CleanSpec-mk\_acs4@@:

2.包含：$(BUILD\_SYSTEM)/cleanspec.mk。设置INTERNAL\_CLEAN\_BUILD\_VERSION :=3，并通过add-clean-step函数，加进一些默认的删除操作，在通过build/tools/findleaves.py枚举所有的CleanSpec.mk文件，并把它们包含进来。在这些文件里根据具体的模块加删除操作。

3.包含：$(PRODUCT\_OUT)/clean\_steps.mk。这个文件是自动生成的，设置CURRENT\_CLEAN\_BUILD\_VERSION :=INTERNAL\_CLEAN\_BUILD\_VERSION

4.比较CURRENT\_CLEAN\_BUILD\_VERSION和INTERNAL\_CLEAN\_BUILD\_VERSION若相等执行INTERNAL\_CLEAN\_STEPS里的命令，否则表示我们修改过cleanspec.mk， 删除整个$(OUT\_DIR)。

5.包含：$(PRODUCT\_OUT)/previous\_build\_config.mk。这个文件也是自动生成的，查看PREVIOUS\_BUILD\_CONFIG是否于当前的编译选项一致。不相同就强制删除中间文件，并将当前的编译选项写入文件。删除的文件是由installclean\_files，dataclean\_files定义。PREVIOUS\_BUILD\_CONFIG的格式是$(TARGET\_PRODUCT)-$(TARGET\_BUILD\_VARIANT)$(building\_sdk)-\{$(locale\_list)\}。

6.定义两个make目标installclean和dataclean。分别用来删除安装文件和数据文件。

**六.   Makefile**

1.生成一些记录文件

(1).生成$(OUT\_DOCS)/index.html文件，将frameworks/base/docs/docs-redirect-index.html文件内容拷贝进去。

(2).生成$(TARGET\_ROOT\_OUT)/default.prop文件，将ADDITIONAL\_DEFAULT\_PROPERTIES的值写入文件。生成$(TARGET\_OUT)/build.prop文

件，主要存放的是build.properties,主要来自于三个方面（1，通过执行build/tools/buildinfo.sh根据PRODUCT\_NAME变量值...获得2.文件$(TARGET\_DEVICE\_DIR)/system.prop3.ADDITIONAL\_BUILD\_PROPERTIES变量值）。

(3).生成文件$(PRODUCT\_OUT)/sdk/sdk-build.prop，拷贝$(TARGET\_OUT)/build.prop内容，并修改sdk\_build\_prop\_remove定义的属性列表值都为generic。

(4).生成文件$(PRODUCT\_OUT)/module-info.txt，列出全部模块的信息，需声明CREATE\_MODULE\_INFO\_FILE。

2.定义一些make target

3.包含$(BUILD\_SYSTEM)/tasks目录下的所有.mk文件。

**七.         模块下的Android.mk的说明**

以camera为例：

[view plain][]

1.  LOCAL\_PATH:= $(call my-dir)  
2.    
3.  ifeq ($(USE\_CAMERA\_STUB),)  
4.    
5.  USE\_CAMERA\_STUB:=**false**  
6.    
7.  ifneq ($(filter sooner genericsim,$(TARGET\_DEVICE)),)  
8.    
9.  USE\_CAMERA\_STUB:=**true**  
10.   
11. endif \#libcamerastub  
12.   
13. endif  
14.   
15. ifeq ($(USE\_CAMERA\_STUB),**true**)  
16.   
17. \#  
18.   
19. \# libcamerastub  
20.   
21.    
22.   
23. \#  
24.   
25. include $(CLEAR\_VARS)  
26.   
27. LOCAL\_SRC\_FILES:=               \\  
28.   
29.    CameraHardwareStub.cpp      \\  
30.   
31.    FakeCamera.cpp  
32.   
33. LOCAL\_MODULE:= libcamerastub  
34.   
35. ifeq ($(TARGET\_SIMULATOR),**true**)  
36.   
37. LOCAL\_CFLAGS += -DSINGLE\_PROCESS  
38.   
39. endif  
40.   
41. LOCAL\_SHARED\_LIBRARIES:= libui  
42.   
43. include $(BUILD\_STATIC\_LIBRARY)  
44.   
45. endif \# USE\_CAMERA\_STUB  
46.   
47. \#  
48.   
49. \# libcameraservice  
50.   
51. \#  
52.   
53. include $(CLEAR\_VARS)  
54.   
55. LOCAL\_SRC\_FILES:=               \\  
56.   
57.    CameraService.cpp  
58.   
59. LOCAL\_SHARED\_LIBRARIES:= \\  
60.   
61.    libui \\  
62.   
63.    libutils \\  
64.   
65.    libbinder \\  
66.   
67.    libcutils \\  
68.   
69.    libmedia \\  
70.   
71.    libcamera\_client \\  
72.   
73.    libsurfaceflinger\_client  
74.   
75. LOCAL\_MODULE:= libcameraservice  
76.   
77. LOCAL\_CFLAGS +=-DLOG\_TAG=\\"CameraService\\"  
78.   
79. ifeq ($(TARGET\_SIMULATOR),**true**)  
80.   
81. LOCAL\_CFLAGS += -DSINGLE\_PROCESS  
82.   
83. endif  
84.   
85. ifeq ($(USE\_CAMERA\_STUB), **true**)  
86.   
87. LOCAL\_STATIC\_LIBRARIES += libcamerastub  
88.   
89. LOCAL\_CFLAGS += -includeCameraHardwareStub.h  
90.   
91. **else**  
92.   
93. LOCAL\_SHARED\_LIBRARIES += libcamera  
94.   
95. endif  
96.   
97. include $(BUILD\_SHARED\_LIBRARY)

**1.   include $(CLEAR\_VARS)**

这一步一般都要在文件头部包含。CLEAR\_VARS=build/core/clear\_vars.mk,在这个文件里将所有以LOCAL\_开头的变量置为空，除了LOCAL\_PATH.因为每个模快都公用同一个LOCAL\_变量，防止干扰。

**2.    LOCAL\_PATH:=$(call my-dir)**

通过调用my-dir函数获得当前目录。

**3.    设置以LOCAL\_开头的变量**

LOCAL\_SRC\_FILES   需要的源文件，不需要包含它的依赖文件，因为编译时会自动的添加

LOCAL\_C\_INCLUDES  一些额外的头文件路径

LOCAL\_SHARED\_LIBRARIES  需要的共享库

LOCAL\_MODULE      C,C++ 本模块的名字，必须是唯一的

LOCAL\_PACKAGE\_NAME  JAVA的LOCAL\_MODULE

LOCAL\_MODULE\_TAGS   模块标记，一般的取值范围：debug eng tests optionalsamples shell\_ash shell\_mksh，默认optional

LOCAL\_MODULE\_CLASS 这个不用我们自己定义，系统会根据生成模块类型的不同赋值。取值：APPS,JAVA\_LIBRARIES,SHARED\_LIBRARIES,STATIC\_LIBRARIES,EXECUTABLES

LOCAL\_MODULE\_PATH 模块的生成后存放的路径，不用定义，有默认值

LOCAL\_MODULE\_SUFFIX 后缀名，不用定义，有默认值（.apk,.jar,.so,.a）

LOCAL\_BUILT\_MODULE\_STEM 编译目标要生成的文件名，如果我们定义了    LOCAL\_BUILT\_STEM值就是$(LOCAL\_BUILT\_STEM)$(LOCAL\_MODULE\_SUFFIX)，否则就是$(LOCAL\_MODULE)$(LOCAL\_MODULE\_SUFFIX)。若要编译JAVA的库文件和执行文件会被置为jablib.jar和package.apk。

LOCAL\_INSTALLED\_MODULE\_STEM  定义规则跟LOCAL\_BUILT\_MODULE\_STEM相同，但是不会有设置为单一值的情况。

LOCAL\_BUILT\_MODULE 编译目标完整的路径和文件名

LOCAL\_PRELINK\_MODULE只有在编译.so的时候才会有的选项，主要是通过预链接的方式来加快程序启动和执行的速度，如果设置是真的话，那你要在build/core/prelink-linux-arm.map中定义你的库需要使用的空间，空间不够的话会报错

**4.    include$(BUILD\_SHARED\_LIBRARY)**

BUILD\_SHARED\_LIBRARY在config.mk里有定义，指向相应的.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

主要分为两种类型：prebuilt和bin/lib文件。这些.mk文件都包含build/core/base\_rule.mk。这个文件的作用如下：

(1).  根据LOCAL\_IS\_HOST\_MODULE，LOCAL\_MODULE\_CLASS，LOCAL\_MODULE这三个变量的值来判断这个模块是否是全局唯一的，我们应该使LOCAL\_MODULE全局唯一的。

(2). 设置LOCAL\_MODULE\_PATH的默认值。LOCAL\_MODULE\_PATH:=$($(my\_prefix)OUT$(use\_data)\_$(LOCAL\_MODULE\_CLASS))若my\_prefix=TARGET\_ use\_data=””  LOCAL\_MODULE\_CLASS=APPS 则LOCAL\_MODULE\_PATH＝$(TARGET\_OUT\_APPS)。TARGET\_OUT\_APPS在envsetup.mk定义TARGET\_OUT\_APPS＝out/target/product/generic/system/app

(3). 设置LOCAL\_BUILT\_MODULE的默认值。LOCAL\_BUILT\_MODULE:=$(built\_module\_path)/$(LOCAL\_BUILT\_MODULE\_STEM)，built\_module\_path就是编译目标存放的路径。有两种路经built\_module\_path＝target/common/obj/$(LOCAL\_MODULE\_CLASS)/$(LOCAL\_MODULE)\_\_intermediates/，built\_module\_path＝/target/product/generic/obj/$(LOCAL\_MODULE\_CLASS)/$(LOCAL\_MODULE)\_\_intermediates/。以Camera为例：LOCAL\_BUILT\_MODULE＝out/target/product/generic/obj/APPS/Camera\_intermediates/Camera.apk。

(4).  设置LOCAL\_INSTALLED\_MODULE的默认值。LOCAL\_INSTALLED\_MODULE＝$(LOCAL\_MODULE\_PATH)/$(LOCAL\_MODULE\_SUBDIR)$(LOCAL\_INSTALLED\_MODULE\_STEM)，这里LOCAL\_MODULE\_SUBDIR留给我们自己定义一般为空。但是要记得的是当我们设置了它之后，要在每个模块的最后要将这个值清空，因为默认CLEAR\_VARS是不会清空这个值的。以Camera为例:LOCAL\_INSTALLED\_MODULE=out/target/product/generic/system/app/Camera.apk

(5).  将.aidl和.logtags文件转化为.java文件，存放在out/target/common/obj /src/,out/target/common/obj/目录是JAVA的中间文件的存放目录

(6). 定义.PHONY:$(LOCAL\_MODULE)目标规则.拷贝$(LOCAL\_BUILT\_MODULE)到$(LOCAL\_INSTALLED\_MODULE)，这两个变量的值前面都有说明。若不想把这个模块编译进系统的话，声明LOCAL\_UNINSTALLABLE\_MODULE即可（只适用于静态库）。在这里只是拷贝文件，真正的编译工作是在它的外层.mk文件做的，并把生成的目标文件放在$(LOCAL\_BUILT\_MODULE)。若是prebuild就不需要编译了，只是将已经存在的文件做简单的拷贝工作。当我们要安装指定的模块到系统的时候，只要make $(LOCAL\_MODULE)就行了。定义cleantarget目标规则，删除$(LOCAL\_BUILT\_MODULE),$(LOCAL\_INSTALLED\_MODULE), $(intermediates)文件或目录

(7).  定义或添加以ALL\_MODULES.开头的值,将本模块变量保存起来。

ALL\_MODULES.$(LOCAL\_MODULE).CLASS  
ALL\_MODULES.$(LOCAL\_MODULE).PATH  
ALL\_MODULES.$(LOCAL\_MODULE).TAGS  
ALL\_MODULES.$(LOCAL\_MODULE).CHECKED  
ALL\_MODULES.$(LOCAL\_MODULE).BUILT  
ALL\_MODULES.$(LOCAL\_MODULE).INSTALLED  
ALL\_MODULES.$(LOCAL\_MODULE).REQUIRED  
ALL\_MODULES.$(LOCAL\_MODULE).EVENT\_LOG\_TAGS

ALL\_MODULE\_TAGS

ALL\_MODULE\_TAGS.$(LOCAL\_MODULE\_TAGS)

ALL\_MODULE\_NAME\_TAGS

(8).  包含$(BUILD\_SYSTEM)/notice\_files.mk，这个我没细看估计是生成本模块的NOTICE文件

[0_1311081586v8sE.gif]: /images/20220214/87ba5f469d874e3b9170da647de00940.png
[20130524153832798]: /images/20220214/74cf029e60c74374ba7a9a3b25c422bb.png
[BUILD_SYSTEM_config.mk]: http://blog.csdn.net/kobeyxyx/article/details/postedit#config
[BUILD_SYSTEM_cleanbuild.mk]: http://blog.csdn.net/kobeyxyx/article/details/postedit#cleanbuild
[BUILD_SYSTEM_Makefile]: http://blog.csdn.net/kobeyxyx/article/details/postedit#makefile
[include_BUILD_SYSTEM_envsetup.mk]: http://blog.csdn.net/kobeyxyx/article/details/postedit#envsetup
[include_BUILD_SYSTEM_product_config.mk]: http://blog.csdn.net/kobeyxyx/article/details/postedit#product_config
[view plain]: http://blog.csdn.net/kobeyxyx/article/details/6614970