MTK 软件工程的配置说明

本文详解MTK的编译过程，并会根据我的理解来更新。阅读上文对本文的一些文件和术语会有很好的帮助。

导读：
　　Comp.mak 完成模块编译连接，生成bin
　　Gsm2.mak 主编译文件，完成clean,remake,new等工作
　　XXX_GPRS.mak 客户私有的配置，根据客户的不同，而设定不同的配置文件
　　Option.mak 工程中的基本配置及宏定义文件
　　Verno_XXX.bld 版本文件
　　Custom.bld 要保证在客户版本中都使用相同的配置的地方要写在这里，这个里面的一些文件不能被改变
　　第一步：
　　1.Make.bat命令首先调用ChgFileMode.bat，将编译过程中需要用到的文件的只读属性修改为可读写，再调用make2.pl。
　　2.Make2.pl的主要工作就是匹配gsm2.mak的参数，然后通过命令
　　system("${makeCmd} -f${makeFolder}${myMF} -r -R CUSTOMER=$custom PROJECT=$project $action");来调用gsm2.mak。
　　具体解析出来就是
　　make -f make/gsm2.mak -r –R CUSTOMER=工程名 PROJECT=gprs new|update|remake
　　第二步：整个过程如图
　　Gsm2.mak
　　Option.mak
　　XXX_GPRS.mak
　　REL_CR_MMI_GPRS.mak
　　USER_SPECIFIC.mak
　　
　　1.在Gsm2.mak文件的开始处调用了option.mak文件。
　　2.Option.mak又将make/$(strip $(CUSTOMER))_$(strip$(PROJECT)).mak文件包含进来，这个模式匹配结果为：make目录下，工程名称_GPRS.mak，如K500GSD_GPRS.mak。
　　3.在$(strip $(CUSTOMER))_$(strip$(PROJECT)).mak文件中又调用了REL_CR_MMI_$(strip$(PROJECT)).mak文件，这个文件模式具体被解析为make目录下的REL_CR_MMI_GPRS.mak文件。
　　REL_CR_MMI_GPRS.mak这个文件定义了哪些文件需要加入到编译目录中。
　　其中定义了MMI部分的编译目录为MMIDIR = plutommi。
　　在变量CUS_REL_BASE_COMP中定义了资源的编译目录：
　　CUS_REL_BASE_COMP += $(strip $(MMIDIR))/mmi $(strip $(MMIDIR))/mtkapp $(strip$(MMIDIR))/tool $(MMIDIR)/WIN32FS
　　CUS_REL_BASE_COMP += $(strip$(MMIDIR))/Customer/CustomerInc /
　　$(strip $(MMIDIR))/Customer/Customize /
　　$(strip $(MMIDIR))/Customer/CustResource/$(strip $(MMI_VERSION))/
　　$(strip $(MMIDIR))/Customer/debug /
　　$(strip $(MMIDIR))/Customer/Images/GameImages /
　　$(strip $(MMIDIR))/Customer/Images/decoder /
　　$(strip $(MMIDIR))/Customer/Res_MMI /
　　$(strip $(MMIDIR))/Customer/ResGenerator /
　　$(strip $(MMIDIR))/Customer/ResourceDLL /
　　$(strip $(MMIDIR))/Customer/Resources /
　　$(strip $(MMIDIR))/Customer/Audio
　　客户的资源需要编译如下文件：CUS_REL_SRC_COMP += mmiresource mtkapp gdi_arm plutommi vendorapp
　　图片名称为：CUS_REL_BASE_COMP += $(strip$(MMIDIR))/Customer/Images/$(strip $(MMI_PROJ))$(strip$(MAIN_LCD_SIZE))，可解析为如：
　　plutommi/customer/images/K500GSD176X220
　　
　　REL_CR_MMI_$(strip $(PROJECT)).mak
　　其中CUS_REL_OBJ_LIST这个变量存储了连接过程中所需要的文件名称
　　
　　4．make/$(strip $(CUSTOMER))_$(strip$(PROJECT)).mak文件的功能。
　　CUSTOM_OPTION定义了所有需要编译进去的功能模块的宏。
　　COMPLIST变量的功能：
　　ifeq ($(strip $(RTOS)),NUCLEUS)
　　COMPLIST = nucleus nucleus_int nucleus_ctrl_code nucleus_critical_data
　　Endif
　　如果操作系统为NUCLEUS，那么COMPLIST为后面的值，COMPLIST为所要编译的文件列表，里面存放了很多*.inc文件，展开后就变为
　　config/include
　　stacklib/include
　　adaptation/include
　　kal/include等等
　　
　　5． option.mak文件的在后面调用了make/USER_SPECIFIC.mak
　　如果使用CPU为ARM，则编译工具目录为如下定义
　　ifeq ($(strip $(COMPILER)),ADS)
　　DIR_ARM = c:/progra~1/arm/adsv1_2
　　DIR_ARM := $(strip $(DIR_ARM))
　　DIR_TOOL = $(DIR_ARM)/bin
　　DIR_ARMLIB = $(DIR_ARM)/lib
　　DIR_ARMINC = $(DIR_ARM)/include
　　Endif
　　连接打包工具等为如下几个：
　　DIR_TOOL := $(strip $(DIR_TOOL))
　　LINK = $(DIR_TOOL)/armlink.exe # Linker
　　ASM = $(DIR_TOOL)/armasm.exe # ARM assembler
　　LIB = $(DIR_TOOL)/armar.exe # Library tool
　　BIN_CREATE = $(DIR_TOOL)/fromelf.exe # Binary tool
　　下面这段代码告诉我们需要用什么编译工具来编译
　　ifeq ($(strip $(COMPILER)),ADS)
　　ifeq ($(strip $(COMPILE_MODE)),INST16)
　　CC = $(DIR_TOOL)/tcc.exe # Thumb Mode(16bits), use tcc
　　CC32 = $(DIR_TOOL)/armcc.exe # ARM Mode(32bits), use armcc
　　CPPC = $(DIR_TOOL)/tcpp.exe # Thumb Mode(16bits), use tcc
　　CPPC32 = $(DIR_TOOL)/armcpp.exe # ARM Mode(32bits), use armcc
　　else
　　ifeq ($(strip $(COMPILE_MODE)),INST32)
　　CC = $(DIR_TOOL)/armcc.exe # ARM Mode(32bits), use armcc
　　CPPC = $(DIR_TOOL)/armcpp.exe # ARM Mode(32bits), use armcc
　　else
　　CC = $(DIR_TOOL)/tcc.exe # Default tcc
　　CC32 = $(DIR_TOOL)/armcc.exe # ARM Mode(32bits), use armcc
　　CPPC = $(DIR_TOOL)/tcpp.exe # Thumb Mode(16bits), use tcc
　　CPPC32 = $(DIR_TOOL)/armcpp.exe # ARM Mode(32bits), use armcc
　　endif
　　endif
　　endif
　　
　　ifeq ($(strip $(PLATFORM)),MT6223P)
　　AFLAGS := -g -littleend -cpu ARM7EJ-S
　　Endif
　　
　　COMMINCDIRS变量在先包含了基本功能模块的inc目录后再包含如下文件
　　COMMINCDIRS += $(DIR_ARMINC) $(CUSTOM_COMMINC)，
　　
　　6．Option.mak中定义了一些附加功能模块的编译模式（是否被编译，被编译成什么样的结果），比如说蓝牙，UART3，WIFI，USB，WAP等等，还有一些编译器的设置。
　　我们的版本号和Scat文件被定义在这个变量中：5056L
　　SCATTERFILE = custom/system/$(strip$(BOARD_VER))/scat$(strip $(PLATFORM)).txt
　　VERNOFILE = make/Verno_$(CUSTOMER).bld
　　.bin文件的名称设置在这个变量TARGNAME = $(CUSTOMER)_$(strip$(SUB_BOARD_VER))_$(PROJECT)_$(strip $(PLATFORM))_$(strip$(CHIP_VER))
　　TST_DB := $(strip $(TSTDIR))/database_classb
　　然后被包含到Option.mak文件中来，include $(strip$(VERNOFILE))。
　　
　　7．Gsm2.mak文件中new执行的指令
　　new : cleanall cmmgen mmi_feature_check asngen codegen asnregen operator_check_lite update
　　
　　update所执行的指令
　　update : cleanlog cleanbin mcddll_update codegen resgen cksysdrv remake
　　
　　remake所执行的指令
　　remake : mcp_check cleanlog cleanbin genverno libs $(BIN_FILE) done
　　
　　resgen用来编译资源文件：Res_XXX.c
　　
　　(echo CUSTOM_OPTION = $(foreach def,$(BOARD_VER) $(PLATFORM) $(LCD_MODULE) $(EXT_CAM_MODULE)$(CMOS_SENSOR),-D "$(def)") />$(MMIDIR)/customer/resGenerator/custom_option.txt)
　　首先将CUSTOM_OPTION重定向到custom_option.txt中
　　
　　(type make/~cus_opt.tmp >>$(MMIDIR)/customer/resGenerator/custom_option.txt)
　　使用tools/strcmpex.exe生成~cus_opt.tmp, ~tgt_opt.tmp,~inc.tmp三个文件
　　将~cus_opt.tmp 重定向到custom_option.txt中
　　
　　(@del $(MMIDIR)/mmi/TargetOption.txt) &/
　　(copy /Y make/~tgt_opt.tmp $(MMIDIR)/MMI/TargetOption.txt)
　　再将TargetOption.txt更新一下，将~tgt_opt.tmp重定向到TargetOption.txt中
　　
　　(type make/~inc.tmp >$(MMIDIR)/customer/resGenerator/custom_include.tmp)
　　再将~inc.tmp重定向到custom_include.tmp中，
　　
　　执行replace_project_name.pl文件，编译Res_XXX.c
　　再执行ResGenerator_HW.bat，编译资源文件。
　　
　　8．Remake中的编译过程是在libs中完成的
　　目标依赖：libs: cleanlib startbuildlibs $(COMPLIBLIST)
　　Cleanlib在这个依赖中做的动作是清掉上次生成的.bin，.elf，.lis等文件，接着清掉需要重新来生成的.lib文件。$(COMPLIBLIST)这个依赖就是我们需要重新生成的.lib文件。
　　.lib文件的依赖关系：%.lib:
　　在这个依赖关系中所做的动作是设置编译器，链接器以及这个过程的参数等其他信息，然后将这些信息输出到：~compbld.tmp临时文件中。
　　
　　(tools/make.exe -fmake/comp.mak -k -r -R $(strip $(CMD_ARGU)) COMPONENT=$* >$(strip $(COMPLOGDIR))/$*.log) /
　　调用了make命令来执行comp.mak文件，并且可以看到> $(strip$(COMPLOGDIR))/$*.log
　　该语句将执行comp.mak文件时产生的信息存放在当前编译部分的.log文件中，通常看编译信息的比如custom.log等就是该中类型的文件。
　　
　　依赖关系：update_lib: $(TARGLIB)
　　$(TARGLIB) : $(COBJS) $(CPPOBJS) $(AOBJS) $(ARMOBJS)
　　$(TARGLIB)依赖很多.c和.obj
　　.c.obj:
　　@echo Compiling $< ...
　　@tools/strcmpex.exe $(ACTION) remake e $(*F).via $(CINTWORK) -c $(CFLAGS) $(CDEFS) $(CINCDIRS) -o $(COMPOBJS_DIR)/$@$<
　　@tools/strcmpex.exe $(ACTION) remake n $(*F).via $(CINTWORK) -c $(CFLAGS) $(CDEFS) $(CINCDIRS) $(MD) -o$(COMPOBJS_DIR)/$@ $<
　　@if exist $(*F).via tools/warp.exe $(*F).via
　　@if exist $(*F).via $(CMPLR) $(VIA) $(*F).via
　　@if not $(ACTION)==remake if exist $(FIXPATH)/$(*F).d perl./tools/pack_dep.pl $(FIXPATH)/$(*F).d >$(RULESDIR)/$(COMPONENT)_dep/$(*F).det
　　@if not $(ACTION)==remake if exist $(FIXPATH)/$(*F).d del /f /q$(FIXPATH)/$(*F).d >nul
　　@if exist $(*F).via del /f /q $(*F).via
　　要生成.o依赖于.c文件，如果我的.c文件经过更新，那么该.o就需要重新生成，该.c就需要重新来编译。
　　@tools/strcmpex.exe $(ACTION) remake e$(*F).via $(CINTWORK) -c $(CFLAGS) $(CDEFS)$(CINCDIRS) -o $(COMPOBJS_DIR)/$@ $<
　　@tools/strcmpex.exe $(ACTION) remake n $(*F).via $(CINTWORK) -c $(CFLAGS) $(CDEFS) $(CINCDIRS) $(MD) -o$(COMPOBJS_DIR)/$@ $<
　　有两个编译环节，针对不同的编译动作，两者的不同点在于中间有个$(MD)编译选项，在有该选项的时间编译的时候就会生成依赖关系文件.d。
　　@if not $(ACTION)==remake if exist $(FIXPATH)/$(*F).d perl./tools/pack_dep.pl $(FIXPATH)/$(*F).d >$(RULESDIR)/$(COMPONENT)_dep/$(*F).det
　　在这个的语句中有$(FIXPATH)/$(*F).d >$(RULESDIR)/$ (COMPONENT)_dep/$(*F).det该动作又将.d文件作为.pl文件的参数，执行该perl文件后将结果输出放在.det文件中。
　　@if not $(ACTION)==remake if exist $(FIXPATH)/$(*F).d del /f /q$(FIXPATH)/$(*F).d >nul
　　然后又执行这个语句，将.d文件删除。
　　在make文件中可以看到-include$(RULESDIR)/$(COMPONENT).dep
　　在查看各个.o的依赖关系的时间要查看该.dep文件来决定是否需要来重新编译生成该.o。
　　如果新添加了.h文件又没有来更新.dep文件就可能导致该.o查找依赖时没有依赖该.h。不去更新该.o。
　　@if exist $(FIXPATH)/$(CUS_MTK_LIB)/$(COMPONENT).lib /
　　(copy /z $(FIXPATH)/$(CUS_MTK_LIB)/$(COMPONENT).lib $(subst/,/,$(TARGLIB))) &/
　　($(LIB) -r $(TARGLIB) $(COMPOBJS_DIR)/*.obj) /
　　else /
　　($(LIB) -create $(TARGLIB) $(COMPOBJS_DIR)/*.obj)
　　在生成了.o文件后在.lib的依赖中可以看到($(LIB) -r$(TARGLIB) $(COMPOBJS_DIR)/*.obj)
　　该语句将生成的.o文件打包成.lib库文件。
　　
　　连接过程：$(BIN_FILE)：
　　最后完成编译：done:
　　# -----------------------------
　　# Clean temporary files in make directory
　　# -----------------------------
　　@echo Cleaning make/~*.tmp files ...
　　@if exist make/~*.tmp /
　　del make/~*.tmp
　　@echo Done.
　　@perl tools/time.pl -n
　　清掉临时文件，打出done信息，最后打出时间标签。