电竞比分网-中国电竞赛事及体育赛事平台

分享

android 系統(tǒng) makefile文件(Android.mk)組織結(jié)構(gòu)

 昵稱7491400 2011-09-16

下面是main.mk文件包含關(guān)系,本文檔主要說(shuō)明的就是這些文件里到底做了什么。(這個(gè)文件被根目錄下的makefile文件包含)


一. main.mk

1.檢查版本號(hào),設(shè)置環(huán)境變量(BUILD_SYSTEM)和缺省的目標(biāo)。$(MAKE_VERSION) >= 3.81,BUILD_SYSTEM= build/core

2.包含文件BUILD_SYSTEM/config.mk。根據(jù)配置信息和主機(jī)目標(biāo)機(jī)信息,設(shè)置一些變量。

3.包含文件BUILD_SYSTEM/cleanbuild.mk。如果當(dāng)前配置改變,強(qiáng)制刪除上次的編譯結(jié)果

4.包含文件OUT_DIR/version_check.mk。就設(shè)置了VERSIONS_CHECKED。如果版本序號(hào)改變,即VERSION_CHECK_SEQUENCE_NUMBER?。絍ERSIONS_CHECKED,檢查文件系統(tǒng)是否大小寫不敏感。文件路徑上是否沒有空格。JAVA,JAVAC的版本是否是1.6。

5.包含文件BUILD_SYSTEM/definitions.mk。定義了很多函數(shù)供makefile文件系統(tǒng)使用。

主要的是transform-xxx-to-xxx的形式,比如transform-cpp-to-o。并定義了一個(gè)make目標(biāo)dist,額外的拷貝一些重要的文件到目標(biāo)文件夾。

6.檢查MAKECMDGOALS和TARGE_BUILD_VARIANT.根據(jù)MAKECMDGOALS設(shè)置標(biāo)量is_sdk_build,是否編譯SDK。

7.根據(jù)TARGE_BUILD_VARIANT,設(shè)置tags_to_install,ADDITIONAL_DEFAULT_PROPERTIES

TARGE_BUILD_VARIANT tags_to_install ADDITIONAL_DEFAULT_PROPERTIES
user user ro.secure=1 ro.allow.mock.location=0
eng user debug eng ro.setupwizard.mode=OPTIONAL
tests user debug eng
sdk user debug eng xmpp.auto-presence=true ro.config.nocheckin=yes
user debug user debug ro.sercure=1 dalvik.vm.lockprof.threshold=500
ro.allow.mock.location=0
ro.debuggable=1 persist.service.adb=1

 

8.檢查PARDUCT_TAG是否包含dalvik.gc.type-precise,如果包含設(shè)置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.設(shè)置ADDITIONAL_BUILD_PROPERTIES+= net.bt.name=Android

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

11.如果MAKECMDGOALS僅包含showcommands或checkbuild,設(shè)置make目標(biāo)為DEFAULT_GOALS

12.如果MAKECMDGOALS不包含clean,clobber,dataclean,installclean,根據(jù)不同的主機(jī)平臺(tái)和處理器品平臺(tái),包含進(jìn)要編譯的模塊,設(shè)置subdirs。

13.通過build/tools/findleaves.py,把subdirs目錄下的Android.mk存在subdirs_makefiles。并包含這些文件。如果使用mm命令,只包含當(dāng)前目錄下的Android.mk。

14.若是全部編譯,包含frameworks/policies/base/PolicyConfig.mk。生成android.policy模塊,并定義了自己的make刪除操作policy_installclean。

15.根據(jù)tags_to_install和is_sdk_build,設(shè)置哪些模塊需要安裝,并存入modules_to_install.

這里主要有兩個(gè)函數(shù)要說(shuō)明一下:

get-tagged-modules $1 $2 這兩個(gè)參數(shù)一般都是ALL_MODULE_TAGS=debug eng gnuoptional samples testsuser里面的值,取得$1中不包括$2的列表,比如tests user,返回$(ALL_MODULE_TAGS.user)$(ALL_MODULE_TAGS.tests)即帶有user或tests標(biāo)記模塊的目標(biāo)文件路徑列表。

Module-installed-files $1 $1一般的是一個(gè)短的模塊名,比如framework,Browers,返回這個(gè)模塊的目標(biāo)文件路徑

16.包含:$(BUILD_SYSTEM)/Makefile。主要是定義了一些偽目標(biāo)。

17.定義modules_to_check,文件路徑列表,若模塊沒有定義LOCAL_DONT_CHECK_MODULE,會(huì)把生成目標(biāo)的規(guī)則加入到這個(gè)變量,以便在modules_to_install后檢查目標(biāo)是否生成成功,目標(biāo)不存在的話再次生成目標(biāo)。

18.定義一些make target

target

說(shuō)明

.PHONY:checkbuilt

checkbuilt: $(modules-to-check)

生成沒有定義LOCAL_DONT_CHECK_MODULE的模塊并拷貝到系統(tǒng)目錄

.PHONY:prebuilt

prebuit: $(ALL_PREBUILT)

拷貝預(yù)遍野的文件(比如用include prebuild.mk編譯的)到系統(tǒng)目錄

.PHONY: files

files: prebuilt checkbuilt moduls-to-install $(INSTALLED_ANDROID_INFO_TXT_TARGET)

生成所有目標(biāo)文件(包括:prebuile,modules-to-install,modules-to-check,INSTALLED_ANDROID_INFO_TXT_TARGET)并拷貝到系統(tǒng)目錄。INSTALLED_ANDROID_INFO_TXT_TARGET在build/target/board/Android.mk定義=out/target/product/**/android-info.txt

.PHONY: ramdisk

ramdisk: $(INSTALL_RAMDISK_TARGET)

生成ramdisk.img

$(HOST_OUT_EXECUTABLES)/mkbootfs $(PRODUCT_OUT)/root|$(HOST_OUT_EXECUTABLES)/minizip > $(PRODUCT_OUT)/ramdisk.img

.PHONY: systemimage

systemimage: $(INSTALL_SYSTEMIMAGE)

生成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

.PHONY: userdataimage

userdataimage:$(INSTALL_USERDATAIMAGE_TARGET)

生成data.img

$(HOST_OUT_EXECUTABLES)/mkyaffs2image $(PRODUCT_OUT)/data $(PRODUCT_OUT)/data.img

.PHONY: bootimage

bootimage: $(INSTALL_BOOTIMAGE_TARGET)

生成boot.img

if(TARGET_NO_KERNEL=true), INSTALL_BOOTIMAGE_TARGET=$(PRODUCT_OUT)/boot.img else $(PRODUCT_OUT)/boot.img=.

參數(shù):

INTERNAL_BOOTIMAGE_ARGS := \

$(addprefix --second ,$(INSTALLED_2NDBOOTLOADER_TARGET)) \

--kernel $(INSTALLED_KERNEL_TARGET) \

--ramdisk $(INSTALLED_RAMDISK_TARGET)

$(HOST_OUT_EXECUTABLES)/mkbootimg --kernel $(PRODUCT_OUT)/kernel –ramdisk $(PRODUCT_OUT)/ramdisk.img >$(PRODUCT_OUT)/boot.img

.PHONY: recoveryimage

recoveryimage:$(INSTALL_RECOVERYIMAGE_TARGET)

生成ramdisk-recovery.img recovery.img

目錄$(PRODUCT_OUT)

rm -rf recovery

mkdir -p recovery

mkdir -p recovery/root

mkdir -p recovery/root/etc

mkdir -p recovery/root/tmp

cp -R root recovery/root

cp -f /bootable/recovery/init.rc recovery/root/

cp -f obj/EXECUTABLES/recovery_intermediates/recovery recovery/root/sbin/

cp -rf /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 > recovery/root/default.prop

$(HOST_OUT_EXECUTABLES)/mkbootfs$(PRODUCT_OUT)/recovery/root|$(HOST_OUT_EXECUTABLES)/minizip > $(PRODUCT_OUT)/ramdisk-recovery.img

$(HOST_OUT_EXECUTABLES)/mkbootimg --kernel $(PRODUCT_OUT)/kernel –ramdisk$(PRODUCT_OUT)/ramdisk-recovery.img > $(PRODUCT_OUT)/recovery.img

.PHONY: droidcore

droidcore: files \

systemimage \

$(INSTALLED_BOOTIMAGE_TARGET) \

$(INSTALLED_RECOVERYIMAGE_TARGET) \

$(INSTALLED_USERDATAIMAGE_TARGET) \

$(INSTALLED_FILES_FILE)

生成整個(gè)系統(tǒng)

system.img ramdisk.img/boot.img ramdisk-recovery.img recovery.img userdata.img installed-files.txt

.PHONY: apps_only

生成TARGET_BUILD_APPS指定的APPS模塊.

若TARGET_BUILD_APPS包含all就編譯全部APPS模塊

droid

默認(rèn)target。

ifneq ($(TARGET_BUILD_APPS),)

droid: apps_only

else

droid:droidcore

.PHONY: sdk

生成sdk

.PHONY: clean

.PHONY: clobber

刪除生成文件

.PHONY: modules

顯示所有模塊名

.PHONY: showcommands

顯示命令

 

二. config.mk

1.設(shè)置一些原文件路徑,以SRC_開頭

2.包含文件$(BUILD_SYSTEM)/pathmap.mk,定義了一些短名到長(zhǎng)路徑名的影射,

存放在pathmap_INCL,通過include-path-for $1 根據(jù)短名獲取到長(zhǎng)路徑名FRAMEWORKS_BASE_JAVA_SRC_DIRS 保存了所有要編進(jìn)Android.jar的framework/base下的文件路徑。

3.設(shè)置編譯目標(biāo),.jar,.bin,.so,.a,.apk,...。以BUILD_開頭,指向具體的mk文件。比如BUILD_STATIC_LIBRARY:= $(BUILD_SYSTEM)/static_library.mk

4.設(shè)置一般編譯選項(xiàng)和不同類型的文件后綴名。以COMMON_開頭。COMMON_GLOBAL_CFLAGS,COMMON_RELEASE_CFLAGS。COMMON_PACKAGE_SUFFIX:=.zip

5.包含include$(TOPDIR)buildspec.mk。設(shè)置一些主要的變量,比如目標(biāo)產(chǎn)品名稱。這些都要我們?cè)趍ake之前設(shè)置。這個(gè)文件有個(gè)模版是build/buildspec.mk.default。

6.包含include$(BUILD_SYSTEM)/envsetup.mk。設(shè)置一些跟product相關(guān)的變量。

7.在build/target/board/$(TARGET_DEVICE)/BroadConfig.mk,device/*/$(TARGET_DEVICE)/BroadConfig.mk veror/*/$(TARGET_DEVICE)/BroadConfig.mk 這三個(gè)路徑下,查找product的目標(biāo)設(shè)備的BroadConfig.mk文件。并包含進(jìn)來(lái)。BroadConfig.mk設(shè)置了每個(gè)設(shè)備的自己的一些變量值,來(lái)區(qū)別編譯時(shí)的行為。TARGET_CPU_ABI 必須要設(shè)置。這些設(shè)備是被product.mk中 TARGET_DEVICE指定,一個(gè)設(shè)備信息可以被很多個(gè)product使用。

8.設(shè)置combo_target := HOST_,包含include $(BUILD_SYSTEM)/combo/select.mk。

根據(jù)操作系統(tǒng)和CPU類型設(shè)置以HOST_開頭的變量,并包含include$(BUILD_SYSTEM)/combo/HOST_$(HOST_OS)_$(HOST_ARCH).mk,其中HOST_OS是主機(jī)操作系統(tǒng),HOST_ARCH是主機(jī)CPU類型,比如HOST_linux_x86.mk.在這個(gè)文件里修改以HOST_開頭的變量,主要是向HOST_GLOBAL_CFLAGS添加標(biāo)志。

9.設(shè)置combo_target := TARGET_,包含include $(BUILD_SYSTEM)/combo/select.mk。

根據(jù)操作系統(tǒng)和CPU類型設(shè)置以TARGET_開頭的變量,并包含include$(BUILD_SYSTEM)/combo/TARGET_$(TARGET_OS)_$(TARGET_ARCH).mk,其中TARGET_OS是目標(biāo)操作系統(tǒng),TARGET_ARCH是目標(biāo)CPU類型,比如TARGET_linux_arm.mk.在這個(gè)文件里修改以TARGET_開頭的變量,主要是設(shè)置交叉編譯工具和參數(shù)和基本的系統(tǒng)頭文件。定義了transform-o-to-shared-lib-inner,transform-o-to-executable-inner,transform-o-to-static-executable-inner三個(gè)函數(shù),把.o文件分別轉(zhuǎn)化成共享庫(kù)文件,可執(zhí)行文件,靜態(tài)庫(kù)文件。

10.包含 include$(BUILD_SYSTEM)/combo/javac.mk。得到一個(gè)JAVAC編譯器

CUSTOM_JAVA_COMPILER

COMMON_JAVAC

eclipse

=java -Xmx256m -jar prebuilt/common/ecj/ecj.jar -5 \ -maxProblems 9999999 -nowarn

openjdk

= prebuilt/common/openjdk/bin/javac -target 1.5 \ -Xmaxerrs 9999999

others

Windows: = development/host/windows/prebuilt/javawrap.exe -J-Xmx256m \ -target 1.5 -Xmaxerrs 9999999

Other:=javac -J-Xmx512M -target 1.5 -Xmaxerrs 9999999

 

11.檢查BUILD_ENV_SEQUENCE_NUMBER,這個(gè)是在前面的buildspec.mk設(shè)置或者通過envsetup.sh腳本設(shè)置。

12.設(shè)置主機(jī)通用工具變量。其中一些是主機(jī)自帶的LEX:= flex

YACC:=bison -d DOXYGEN:= doxygen,還有一些是在/out/target/$($(HOST_OS)-$(HOST_ARCH))/bin下的程序,MKBOOTIMG:=$(HOST_OUT_EXECUTABLES)/mkbootimg。

13.設(shè)置最終的編譯連接參數(shù)。有如下參數(shù)變量:

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的版本號(hào)列表。TARGET_AVAILABLE_SDK_VERSIONS和TARGET_AVAILABLE_NDK_VERSIONS

 

三. envsetup.mk

1.包含:include$(BUILD_SYSTEM)/version_defaults.mk 設(shè)置那些我們需要設(shè)置的變量的缺省值。這個(gè)文件我們不因該改動(dòng),改動(dòng)應(yīng)該在build_id.mk里。

PLATFORM_VERSION

2.2.1

PLATFORM_SDK_VERSION

8

PLATFORM_VERSION_CODENAME

REL

DEFAULT_APP_TARGET_SDK

PLATFORM_SDK_VERSION

BUILD_ID

MASTER

BUILD_NUMBER

eng.$(USER).$(date)

 

2.設(shè)置在文件buildspec.mk里或通過envsetup.sh設(shè)置的變量的缺省值。

TARGET_PRODUCT

generic(TARGET_SIMULATOR := false)

sim(TARGET_SIMULATOR:=false)

TARGET_BUILD_VARIANT

eng

HOST_OS

windows/linux/darwin

HOST_ARCH

x86/ppc

HOST_BUILD_TYPE

release

TARGET_OS

linux

TARGET_ARCH

arm

TARGET_BUILD_TYPE

release

3.包含:include$(BUILD_SYSTEM)/product_config.mk。定義了兩種MAKECMDGOALS參數(shù)形式,根據(jù)product和device目錄下的mk文件生成相應(yīng)的PRODUCTS_xxx_xxx和DEVICES_xxx_xxx變量。中間的是文件的路徑,后面的是文件里定義的變量。

4.設(shè)置一些列路徑變量。主機(jī)路徑以HOST_OUT_* 或HOST_*_OUT_*形式,目標(biāo)機(jī)路徑以TARGET_OUT_* 或TARGET_*_OUT_*形式。

5.根據(jù)MAKECMDGOALS,若其中包含dumpvar-%或dumpvar-abs-%,就生成一個(gè)以dumpvar-%或dumpvar-abs-%命名的make目標(biāo)。實(shí)現(xiàn)是打印出%所表示的變量的值。這個(gè)變量必須要在這之前已經(jīng)定義了,后一種在前面還打印出當(dāng)前的路徑。這兩種情況必須要先設(shè)置CALLED_FROM_SETUP=true。envsetup.sh的get_build_var和get_abs_build_var()函數(shù)就是運(yùn)用的這個(gè)原理打印變量的值。

  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

這三個(gè)文件主要是定義了一些函數(shù)來(lái)相互調(diào)用或供product_config.mk文件調(diào)用

函數(shù)名

說(shuō)明

node_fns.mk Import- nodes $(1) $(2) $(3)

import-nodes需要3個(gè)入口參數(shù):
$(1)是一個(gè)字串,是輸出變量的主干名。例如”PRODUCTS"和”DEVICES“。
$(2)是一個(gè)makefile文件列表,這些文件中應(yīng)該含有對(duì)$(3)中變量的定義。
$(3)是一個(gè)變量列表。

import- nodes會(huì)創(chuàng)建這樣形式的變量,以$(1)="PRODUCTS",$(2)中含有"build/target/product/core.mk", $(3)中含有"PRODUCT_NAME",而且core.mk中定義了PRODUCT_NAME:=core為例,
PRODUCT.build/target/product/core.mk.PRODUCT_NAME:=core

import-nodes中還考慮了inherit的問題,如果某個(gè)PRODUCT.xxx.xxx變量的值中有‘@inherit:<mk文件>’標(biāo)識(shí)后面跟的是mk文件名,則會(huì)把那個(gè)mk文件中相應(yīng)的變量的屬性添加到PRODUCT.xxx.xxx中。'@inherit:<mk文件>'是inherit-product命令添加的。這個(gè)函數(shù)在product.mk。

product.mk
_find-android-products-files

得到device/和vendor/, 包括子目錄,以及build/target/product/下的AndroidProducts.mk文件列表

product.mk
get-all-product-makefiles

得到所有AndroidProducts.mk文件中 PRODUCT_MAKEFILES變量定義的mk文件列表

product.mk
import-products

調(diào)用import-nodes(node_fns.mk),設(shè)置$1=PRODUCTS,設(shè)置$3=$(_product_var_list),_product_var_list是以PRODUCT_開頭的變量名。

product.mk
inherit-product

將在所有的PRODUCT_xxx變量值后綴加上'@inherit:<mk文件>'

product.mk
check-all-products

檢查PRODUCT_NAME,PRODUCT_BRAND,PRODUCT_COPY_FILES定義的是否正確

product.mk
resolve-short-product-name

根據(jù)product的名字,得到定義它的mk文件路徑

(resolve-short-product-name generic → /build/target/product/generic.mk)

device.mk
import-devices

調(diào)用import-nodes(node_fns.mk),設(shè)置$1=DEVICES,設(shè)置$3=$(_device_var_list),_device_var_list是以DEVICE_開頭的變量名。

device.mk
inherit-device

將在所有的DEVICE_變量值后綴加上'@inherit:<mk文件>'

device.mk
resolve-short-device-name

根據(jù)device的名字,得到定義它的mk文件路徑

 

 

3.調(diào)用import-products函數(shù),判斷TARGET_BUILD_APPS是否為空,若為空,只導(dǎo)入

$(SRC_TARGET_DIR)/product/AndroidProducts.mk里的mk文件。否則調(diào)用get-all-product-makefiles,導(dǎo)入全部mk文件。再調(diào)用check-all-products檢查變量設(shè)置的正確性。

4.根據(jù)要編譯的目標(biāo)TARGET_PRODUCT,通過調(diào)用resolve-short-product-name得到mk文件,結(jié)果存放在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函數(shù)。有一個(gè)入口參數(shù)$(1),執(zhí)行刪除操作的具體shell命令。
一般add-clean-step應(yīng)當(dāng)在%/cleanspec.mk腳本中使用,命令會(huì)為$(1)定義一個(gè)變量保存,變量的名字是INTERNAL_STEP.$(_acs_id),所有的$(_acs_id)保存在INTERNAL_STEPS中。$(_acs_id)的值分成3個(gè)部分構(gòu)造:
第一部分是有cleanspec.mk的路徑轉(zhuǎn)化而來(lái),用'_'替代'/','-'替代'.',后綴_acs。

第二部分是$(INTERNAL_CLEAN_BUILD_VERSION),默認(rèn)是4。

第三部分是有'@'組成,cleanspec.mk中的第幾個(gè)add- clean-step就用幾個(gè)@。


例如,packages/apps/Camera/cleanspec.mk中定義了兩個(gè)刪除動(dòng)作


$(call add-clean-step, rm -rf $(PRODUCT_OUT)/obj/APPS/Camera*)
$(call add-clean-step, rm -rf $(OUT_DIR)/target/common/obj/APPS/Camera*)
那么,對(duì)應(yīng)的生成變量有:

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。設(shè)置INTERNAL_CLEAN_BUILD_VERSION :=3,并通過add-clean-step函數(shù),加進(jìn)一些默認(rèn)的刪除操作,在通過build/tools/findleaves.py枚舉所有的CleanSpec.mk文件,并把它們包含進(jìn)來(lái)。在這些文件里根據(jù)具體的模塊加刪除操作。

3.包含:$(PRODUCT_OUT)/clean_steps.mk。這個(gè)文件是自動(dòng)生成的,設(shè)置CURRENT_CLEAN_BUILD_VERSION :=INTERNAL_CLEAN_BUILD_VERSION

4.比較CURRENT_CLEAN_BUILD_VERSION和INTERNAL_CLEAN_BUILD_VERSION若相等執(zhí)行INTERNAL_CLEAN_STEPS里的命令,否則表示我們修改過cleanspec.mk, 刪除整個(gè)$(OUT_DIR)。

5.包含:$(PRODUCT_OUT)/previous_build_config.mk。這個(gè)文件也是自動(dòng)生成的,查看PREVIOUS_BUILD_CONFIG是否于當(dāng)前的編譯選項(xiàng)一致。不相同就強(qiáng)制刪除中間文件,并將當(dāng)前的編譯選項(xiàng)寫入文件。刪除的文件是由installclean_files,dataclean_files定義。PREVIOUS_BUILD_CONFIG的格式是$(TARGET_PRODUCT)-$(TARGET_BUILD_VARIANT)$(building_sdk)-{$(locale_list)}。

6.定義兩個(gè)make目標(biāo)installclean和dataclean。分別用來(lái)刪除安裝文件和數(shù)據(jù)文件。

 

六. Makefile

1.生成一些記錄文件

(1).生成$(OUT_DOCS)/index.html文件,將frameworks/base/docs/docs-redirect-index.html文件內(nèi)容拷貝進(jìn)去。

(2).生成$(TARGET_ROOT_OUT)/default.prop文件,將ADDITIONAL_DEFAULT_PROPERTIES的值寫入文件。生成$(TARGET_OUT)/build.prop文

件,主要存放的是build.properties,主要來(lái)自于三個(gè)方面(1,通過執(zhí)行build/tools/buildinfo.sh根據(jù)PRODUCT_NAME變量值...獲得2.文件$(TARGET_DEVICE_DIR)/system.prop3.ADDITIONAL_BUILD_PROPERTIES變量值)。

(3).生成文件$(PRODUCT_OUT)/sdk/sdk-build.prop,拷貝$(TARGET_OUT)/build.prop內(nèi)容,并修改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的說(shuō)明

以camera為例:

  1. LOCAL_PATH:= $(call my-dir)
  2. ifeq ($(USE_CAMERA_STUB),)
  3. USE_CAMERA_STUB:=false
  4. ifneq ($(filter sooner genericsim,$(TARGET_DEVICE)),)
  5. USE_CAMERA_STUB:=true
  6. endif #libcamerastub
  7. endif
  8. ifeq ($(USE_CAMERA_STUB),true)
  9. #
  10. # libcamerastub
  11. #
  12. include $(CLEAR_VARS)
  13. LOCAL_SRC_FILES:= \
  14. CameraHardwareStub.cpp \
  15. FakeCamera.cpp
  16. LOCAL_MODULE:= libcamerastub
  17. ifeq ($(TARGET_SIMULATOR),true)
  18. LOCAL_CFLAGS += -DSINGLE_PROCESS
  19. endif
  20. LOCAL_SHARED_LIBRARIES:= libui
  21. include $(BUILD_STATIC_LIBRARY)
  22. endif # USE_CAMERA_STUB
  23. #
  24. # libcameraservice
  25. #
  26. include $(CLEAR_VARS)
  27. LOCAL_SRC_FILES:= \
  28. CameraService.cpp
  29. LOCAL_SHARED_LIBRARIES:= \
  30. libui \
  31. libutils \
  32. libbinder \
  33. libcutils \
  34. libmedia \
  35. libcamera_client \
  36. libsurfaceflinger_client
  37. LOCAL_MODULE:= libcameraservice
  38. LOCAL_CFLAGS +=-DLOG_TAG=\"CameraService\"
  39. ifeq ($(TARGET_SIMULATOR),true)
  40. LOCAL_CFLAGS += -DSINGLE_PROCESS
  41. endif
  42. ifeq ($(USE_CAMERA_STUB), true)
  43. LOCAL_STATIC_LIBRARIES += libcamerastub
  44. LOCAL_CFLAGS += -includeCameraHardwareStub.h
  45. else
  46. LOCAL_SHARED_LIBRARIES += libcamera
  47. endif
  48. include $(BUILD_SHARED_LIBRARY)

1. include $(CLEAR_VARS)

這一步一般都要在文件頭部包含。CLEAR_VARS=build/core/clear_vars.mk,在這個(gè)文件里將所有以LOCAL_開頭的變量置為空,除了LOCAL_PATH.因?yàn)槊總€(gè)??於脊猛粋€(gè)LOCAL_變量,防止干擾。

2. LOCAL_PATH:=$(call my-dir)

通過調(diào)用my-dir函數(shù)獲得當(dāng)前目錄。

3. 設(shè)置以LOCAL_開頭的變量

LOCAL_SRC_FILES 需要的源文件,不需要包含它的依賴文件,因?yàn)榫幾g時(shí)會(huì)自動(dòng)的添加

LOCAL_C_INCLUDES 一些額外的頭文件路徑

LOCAL_SHARED_LIBRARIES 需要的共享庫(kù)

LOCAL_MODULE C,C++ 本模塊的名字,必須是唯一的

LOCAL_PACKAGE_NAME JAVA的LOCAL_MODULE

LOCAL_MODULE_TAGS 模塊標(biāo)記,一般的取值范圍:debug eng tests optionalsamples shell_ash shell_mksh,默認(rèn)optional

LOCAL_MODULE_CLASS 這個(gè)不用我們自己定義,系統(tǒng)會(huì)根據(jù)生成模塊類型的不同賦值。取值:APPS,JAVA_LIBRARIES,SHARED_LIBRARIES,STATIC_LIBRARIES,EXECUTABLES

LOCAL_MODULE_PATH 模塊的生成后存放的路徑,不用定義,有默認(rèn)值

LOCAL_MODULE_SUFFIX 后綴名,不用定義,有默認(rèn)值(.apk,.jar,.so,.a)

LOCAL_BUILT_MODULE_STEM 編譯目標(biāo)要生成的文件名,如果我們定義了 LOCAL_BUILT_STEM值就是$(LOCAL_BUILT_STEM)$(LOCAL_MODULE_SUFFIX),否則就是$(LOCAL_MODULE)$(LOCAL_MODULE_SUFFIX)。若要編譯JAVA的庫(kù)文件和執(zhí)行文件會(huì)被置為jablib.jar和package.apk。

LOCAL_INSTALLED_MODULE_STEM 定義規(guī)則跟LOCAL_BUILT_MODULE_STEM相同,但是不會(huì)有設(shè)置為單一值的情況。

LOCAL_BUILT_MODULE 編譯目標(biāo)完整的路徑和文件名

LOCAL_PRELINK_MODULE只有在編譯.so的時(shí)候才會(huì)有的選項(xiàng),主要是通過預(yù)鏈接的方式來(lái)加快程序啟動(dòng)和執(zhí)行的速度,如果設(shè)置是真的話,那你要在build/core/prelink-linux-arm.map中定義你的庫(kù)需要使用的空間,空間不夠的話會(huì)報(bào)錯(cuò)

4. include$(BUILD_SHARED_LIBRARY)

BUILD_SHARED_LIBRARY在config.mk里有定義,指向相應(yīng)的.mk文件,根據(jù)要生成的模塊的類型,包含相應(yīng)的文件。

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。這個(gè)文件的作用如下:

(1). 根據(jù)LOCAL_IS_HOST_MODULE,LOCAL_MODULE_CLASS,LOCAL_MODULE這三個(gè)變量的值來(lái)判斷這個(gè)模塊是否是全局唯一的,我們應(yīng)該使LOCAL_MODULE全局唯一的。

(2). 設(shè)置LOCAL_MODULE_PATH的默認(rèn)值。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). 設(shè)置LOCAL_BUILT_MODULE的默認(rèn)值。LOCAL_BUILT_MODULE:=$(built_module_path)/$(LOCAL_BUILT_MODULE_STEM),built_module_path就是編譯目標(biāo)存放的路徑。有兩種路經(jīng)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). 設(shè)置LOCAL_INSTALLED_MODULE的默認(rèn)值。LOCAL_INSTALLED_MODULE=$(LOCAL_MODULE_PATH)/$(LOCAL_MODULE_SUBDIR)$(LOCAL_INSTALLED_MODULE_STEM),這里L(fēng)OCAL_MODULE_SUBDIR留給我們自己定義一般為空。但是要記得的是當(dāng)我們?cè)O(shè)置了它之后,要在每個(gè)模塊的最后要將這個(gè)值清空,因?yàn)槟J(rèn)CLEAR_VARS是不會(huì)清空這個(gè)值的。以Camera為例:LOCAL_INSTALLED_MODULE=out/target/product/generic/system/app/Camera.apk

(5). 將.aidl和.logtags文件轉(zhuǎn)化為.java文件,存放在out/target/common/obj /src/,out/target/common/obj/目錄是JAVA的中間文件的存放目錄

(6). 定義.PHONY:$(LOCAL_MODULE)目標(biāo)規(guī)則.拷貝$(LOCAL_BUILT_MODULE)到$(LOCAL_INSTALLED_MODULE),這兩個(gè)變量的值前面都有說(shuō)明。若不想把這個(gè)模塊編譯進(jìn)系統(tǒng)的話,聲明LOCAL_UNINSTALLABLE_MODULE即可(只適用于靜態(tài)庫(kù))。在這里只是拷貝文件,真正的編譯工作是在它的外層.mk文件做的,并把生成的目標(biāo)文件放在$(LOCAL_BUILT_MODULE)。若是prebuild就不需要編譯了,只是將已經(jīng)存在的文件做簡(jiǎn)單的拷貝工作。當(dāng)我們要安裝指定的模塊到系統(tǒng)的時(shí)候,只要make $(LOCAL_MODULE)就行了。定義cleantarget目標(biāo)規(guī)則,刪除$(LOCAL_BUILT_MODULE),$(LOCAL_INSTALLED_MODULE), $(intermediates)文件或目錄

(7). 定義或添加以ALL_MODULES.開頭的值,將本模塊變量保存起來(lái)。

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,這個(gè)我沒細(xì)看估計(jì)是生成本模塊的NOTICE文件

 

 

    本站是提供個(gè)人知識(shí)管理的網(wǎng)絡(luò)存儲(chǔ)空間,所有內(nèi)容均由用戶發(fā)布,不代表本站觀點(diǎn)。請(qǐng)注意甄別內(nèi)容中的聯(lián)系方式、誘導(dǎo)購(gòu)買等信息,謹(jǐn)防詐騙。如發(fā)現(xiàn)有害或侵權(quán)內(nèi)容,請(qǐng)點(diǎn)擊一鍵舉報(bào)。
    轉(zhuǎn)藏 分享 獻(xiàn)花(0

    0條評(píng)論

    發(fā)表

    請(qǐng)遵守用戶 評(píng)論公約

    類似文章 更多