MTK程序编译方法.doc

MTK程序编译 徐亦朱1. 编写目的本文编写的目的主要是从整体上理解MTK的编译过程，以便较快的处理编译中遇到的问题，同时为以后可能的优化编译过程提供参考。2. 简介MTK的编译过程主要是在windows命令行下通过Makefile文件执行相应的prel脚本或c程序，将资源包生成c源程序，并与相应模块的c程序.o,.lib或.obj的中间代码，最终生成在手机上使用的.bin文件和在模拟器上使用的mmiresource.dll资源文件。3. 编译前的准备工作A. 编译工具和辅助工具l ADS1.2l ADS1.2_update_848.exel MSYSl MinGWl ImageMagickl 7zB. 编译环境搭建l 按默认路径安装ADS1.2，并安装848补丁包l 按默认路径安装Perll 按默认路径安装7_zipl 安装MinGWl 安装MSYSl 安装ImageMagick，注意：按默认提示安装到Select Additional Tasks时，所有的选择全取消，后面再按默认安装。l 复制7z.exe拷贝.7_Zip7z.exe 至.plutommiCustomerResGenerator，并改名为7za.exe。l 复制MinGW拷贝.MinGW至.ToolsMinGW。l 复制MSYS拷贝.msys1.0至.ToolsMSYS。l 复制ImageMagick拷贝.ImageMagick-6.2.5-Q16文件夹下全部文件至.plutommiCustomerResGenerator目录下l 设置make.exe改名mingw32-make.exe(.ToolsMinGW)为make.exe，并放在tools目录下。C. 编译环境检查l 检查第三方软件安装情况如果确认全部安装，可跳过此步。将custom3rdParty.pl文件拷贝到本机，修改4$sevenZipPath = C:Progra117-Zip; 5$MinGWPath = C:MinGW; 6$MSYSPath = C:MSYS;然后退回到MAUI文件夹，运行在Toolschk_env.exel 检查windows环境变量l 检查MTK中Makefile变量是否正确打开.makeoption.make，检查关于ADS编译器的路径设置ifeq ($(strip $(COMPILER),ADS) DIR_ARM = c:adsv1_2 DIR_ARM := $(strip $(DIR_ARM) DIR_TOOL = $(DIR_ARM)bin DIR_ARMLIB = $(DIR_ARM)lib DIR_ARMINC = $(DIR_ARM)includeEndifD. 结束现在可以执行MAKE了，例如Make proj_name gprs new_modisMake PROJ_NAMEgprs new4. 编译命令与文件MTK编译分资源的编译和代码的编译。1) 资源的编译a) 在如下的情况下，需要重新编译资源：l 修改了字符串资源文件(Ref_list.txt)、字库文件(FontRes.c,L_*.h)、MMI配置文件(MMI_featuresPLUTO.h)等，这些文件位于.plutommiCustomerCustResourcePLUTO_MMI；l 修改了MMI资源装载配置文件，这些文件位于.plutommiCustomerCustResourcePLUTO_MMIRes_MMI 目录下，这个目录下都是Res_*.*文件，是各个AP或模块的资源装载文件，包括菜单、图片和字符串资源的装载配置；l 注意：Cust*.*文件是资源编译生成的，不能手动修改。b) 编译方法进入.plutommiCustomer目录，执行remakeResource.bat。若是在模拟器上使用，则还需要在VC环境下build一下，就可以看到效果了。c) 与资源编译相关的文件l ResGenerator_HW.bat在编译手机目标板工程时，有“new”，“resgen”等选项时，自动调用；l ResGenerator.bat手机PC模拟器工程中，添加新资源后，需要手动调用；l remakeResource.bat手机PC模拟器工程中，只替换图片或更新字符串等情况下，需要手动调用；l res_gen.txt资源编译的log文件，在build目录下；l Makefile.plutommiCustomerResGeneratorMakefile此文件是资源装载预编译程序的Makefile；l PopulateRes.c.plutommiMMIResourcePopulateRes.c执行资源装载，主体是函数PopulateResData()，mtk_resgenerator.exe在执行时会调用该函数；l MMIDataType.h.plutommimmiIncMMIDataType.h定义AP的ID范围。2) 代码的编译A. 编译命令命 令说 明Clean清除所有的目标文件、库文件和日志文件，保留目录结构New清除并重新编译所有的文件主要完成工作 gsm2.makcleanall cmmgen mmi_feature_check asngen codegen asnregen operator_check_lite updateUpdate扫描资源、代码的改变，有改变的重编，无改变的不编主要完成的工作 gsm2.makcleanlog cleanbin mcddll_update codegen resgen cksysdrv remakeRemake不扫描资源，只扫描代码的改变，有改变的重编，无改变的不编主要完成的工作 gsm2.makmcp_check cleanlog cleanbin genverno libs $(BIN_FILE) doneB. 编译相关的文件编译用到的文件主要放在make文件夹中。各个文件的简要说明如下：文件名说 明Gsm2.mak编译过程中主要执行的make文件，这个文件从命令行获得编译参数，做出相应的处理。它定义了各个参数的执行过程，包括：new、remake、update等。以及调用其它perl或c程序生成目标文件。Option.mak定义了编译环境中用到的工具及相关的目录，根据大的编译开关定义了小的编译和链接选项，编译中包含文件和生成文件的路径，定义trace的头文件路径，全局的编译开关，用户的一些编译选项，最后定义了编译路径和目录。XXX.lisXXX模块的.c文件如 plutommiMMIMyAppMyAppSrcMyAppSrc.cXXX.pthXXX模块的.c文件存放的路径如 plutommiMMIMyAppMyAppSrcXXX.defXXX模块用到的编译开关，当XXX模块引用其它模块中在编译开关下定义的变量、函数或宏时，就需要将这个编译开关加进来。XXX.incXXX模块用到的头文件路径，需要将XXX模块引用的头文件及，头文件引用的头文件的路径均要包含进来。如 plutommiMMIMyAppMyAppIncXXX_GPRS.mak定义了需要编译的模块列表、编译中包含文件和生成文件的路径，定义trace的头文件路径，全局的编译开关，用户的一些编译选项，最后定义了编译路径和目录。Comp.mak编译和集成模块源文件，编译生成库文件。构建目标代码依赖列表，设置每个模块的编译路径及编译选项，设置生成目标lib的路径，设置生成obj的路径。buildinfo.tmp包含了在Gsm2.mak和Option.mak中用到的项目和平台名称。compbld.tmp包含了编译每个模块时的编译信息。目标文件生成的目标文件为.bin文件，位于.buildproj目录下面，build目录为生成的一个目录。Log文件Log文件同.bin文件一样，也是位于build目录下，如果编译出错，可以在命令行中看到出错的模块，然后到build目录下找对应的Log文件。MT6225r目录包括了每个模块依赖的头文件。 MT6225o目录包含所有生成的obj文件和lib文件。C. 文件命名规则一般来说MMI程序在plutommimmi或者mtkapp下面，程序源文件及头文件命名有一定的规律。以工具箱模块为例，有三个相关目录。Organizer 程序总目录OrganizerInc 头文件目录OrganizerSrc 源文件目录 在OrganizerSrc下创建源程序文件Ebook2.c 在OrganizerInc下创建程序头文件 EbookProt.h EbookDefs.h EbookTypes.h EbookGprot.h 下面介绍每个文件的作用:u *Src.c/*.c本程序的主源程序u *Gprot.h用来放本程序的所有函数声明，但此头文件是被别的程序所加载的，也就是说此文件所申明的都是对外接口；u *Gtype.h用来放本程序所需的类型、结构、常量宏定义，此头文件同时被别的程序所加载；u *Gdcl.h包括被其它程序调用的全局变量定义；u *Gexdcl.h包括全局变量的声明，该头文件被别的程序所加载；u *Prot.h用来放本程序的所有函数声明，但此头文件只被本程序的源程序所加载；u *Dcl.h定义仅被本程序所调用的全局变量；u *ExDcl.h包括全局变量的声明，但此头文件只被本程序的源程序所加载；u *Types.h用来放本程序所需的类型、结构、常量定义；u *Def.h用来放本程序的资源ID定义；u *.*也可以自己定义程序的命名规则。5. 常见编译错误1) mtk_resgenerator.exe不能正常运行。可能是ResGenerator文件夹中的某些文件有错误。一个原因是在ResGenerator文件夹中缺少temp.rgb这个文件，并且不能自动生成。2) 240X320屏的Font_res.c文件的错误，因为打开了中文字体的编译开关，只需要将mmi_featurespluto.h文件中_MMI_LANG_SM_CHINESE_的编译开关关闭即可。3) 出现以下错误，plutommimmiFunAndGamesFunAndGamesSrcGame.c, line 349: Error: C2455E: array 0 foundplutommimmiFunAndGamesFunAndGamesSrcGame.c, line 350: Error: C2455E: array 0 found因为默认的240X320屏幕打开的关于游戏的编译开关下没有游戏，所以需要打开mmi_featurespluto.h文件中的_MMI_GAME_VSMJ_240x320_编译开关。4) 现象：mmiresource模块生成错误：plutommiCustomercustresourcecustimgmapext.c, line 31: Error: C2456E: undeclared name, inventing extern int MAX_IMAGE_IDSplutommiCustomercustresourcecustimgmapext.c, line 31: Serious error: C2958E: illegal in constant expression: non constant MAX_IMAGE_IDSplutommiCustomercustresourcecustimgmapext.c: 0 warnings, 1 error, 1 serious error原因：改变了屏幕大小后，128X160目录下的图片资源有问题。解决办法：更换128X160目录下的图片资源，重新编译此模块。5) 现象：Free clusters are NOT enough . Check ckSysDrv.log for detail ! Toolsmake.exe: * cksysdrv Error 1 解决办法：删除掉customsystemCCDH26_05C_BB目录下的 custom_EMI.ccustom_EMI.hflash_opt.h 三个文件。6) 现象：在新加模块的.c文件中引用一个b.h，产生b.h中的aaa变量没有定义的错误，具体错误如下： 原因：没有包含定义aaa变量的头文件a.h。 解决办法：在include b.h之前include a.h7) 现象：plutommiCustomercustresourceCustImgDataHW.h, line 19361: Serious error: C2934E: duplicate definition of _CUSTOMER_IMAGES_EMPTYIMAGE_BMP 原因： 解决办法：删掉CustImgDataHW.h这个文件重新编译8) 现象：在链接bin文件时，出现以下错误：Error: L6218E: Undefined symbol custom_setAdvEMI (referred from bootarm.obj).原因：custominfo.pl文件没有修改，默认只打开CCDH26_05C_GPRS.mak一个文件，并不打开其它定义编译开关的文件，导致custom模块中的有些文件没有编译，所以一些变量在最后链接时显示未定义。 解决办法：修改custominfo.pl文件。9) 现象：编译某个模块，出现错误：Error: L6218E: Error: C2933