MTK程序编译(二)
XXX.inc
XXX模块用到的头文件路径,需要将XXX模块引用的头文件及,头文件引用的头文件的路径均要包含进来。
如 plutommi/MMI/MyApp/MyAppInc
XXX_GPRS.mak
定义了需要编译的模块列表、编译中包含文件和生成文件的路径,定义trace的头文件路径,全局的编译开关,用户的一些编译选项,最后定义了编译路径和目录。用户可以在这个文件中定义配置。
Comp.mak
编译和集成模块源文件,编译生成库文件。构建目标代码依赖列表,设置每个模块的编译路径及编译选项,设置生成目标lib的路径,设置生成obj的路径。
~buildinfo.tmp
包含了在Gsm2.mak和Option.mak中用到的项目和平台名称。
~compbld.tmp
包含了编译每个模块时的编译信息。
目标文件
生成的目标文件为.bin文件,位于../build/proj目录下面,build目录为生成的一个目录。
Log文件
Log文件同.bin文件一样,也是位于build目录下,如果编译出错,可以在命令行中看到出错的模块,然后到build目录下找对应的Log文件。
MT6225r目录
包括了每个模块的依赖文件(由mak产生的.dep)。
MT6225o目录
包含所有生成的obj文件和lib文件。
C. 文件命名规则
一般来说MMI程序在plutommi/mmi或者mtkapp下面,程序源文件及头文件命名有一定的规律。
以工具箱模块为例,有三个相关目录。
Organizer 程序总目录
OrganizerInc 头文件目录
OrganizerSrc 源文件目录
在OrganizerSrc下创建源程序文件
Ebook2.c
在OrganizerInc下创建程序头文件
EbookProt.h
EbookDefs.h
EbookTypes.h
EbookGprot.h
下面介绍每个文件的作用:
**Src.c/**.c
本程序的主源程序
**Gprot.h
用来放本程序的所有函数声明,但此头文件是被别的程序所加载的,也就是说此文件所申明的都是对外接口;
**Gtype.h
用来放本程序所需的类型、结构、常量宏定义,此头文件同时被别的程序所加载;
**Gdcl.h
包括被其它程序调用的全局变量定义;
**Gexdcl.h
包括全局变量的声明,该头文件被别的程序所加载;
**Prot.h
用来放本程序的所有函数声明,但此头文件只被本程序的源程序所加载;
**Dcl.h
定义仅被本程序所调用的全局变量;
**ExDcl.h
包括全局变量的声明,但此头文件只被本程序的源程序所加载;
**Types.h
用来放本程序所需的类型、结构、常量定义;
**Def.h
用来放本程序的资源ID定义;
*.*
也可以自己定义程序的命名规则。
5. 配置编译选项
XXX_GPRS.mak是用户配置文件,用户可以通过修改该文件配置编译选项。
1) 增减编译的模块
牵涉到XXX_GPRS.mak中的两个变量:
COMPLIST
列出所有可以被编译成.lib库文件的模块。
当在COMPLIST中增加编译的模块时,注意要在make下相应的目录中创建相应的.lis,.inc,.path,.def文件。
CUS_REL_MTK_COMP
列出所有只提供.lib库文件的模块。
这些库文件要位于../mtk.lib中。
2) 将含有源文件的模块以库文件的形式编译
从COMPLIST中去除该模块;
将该模块加入CUST_REL_MTK_COMP;
将.lib库文件拷贝至../mtk.lib中;
删除make下相应的模块目录。
3) 配置编译MoDIS
MoDIS作为MTK软件开发的重要工具,常常被使用。但是由于在PC端与手机端不可避免存在一定的区别,因此在编译MoDIS时,其配置选项有一些与手机端编译存在一定的区别。
在配置好手机端编译的基础上,相应MoDIS的配置还牵涉到:
CreateMoDIS.ini
Module.ini
CreateMoDIS.pl
以下分别介绍这三个文件
a) CreateMoDIS.ini
MoDIS的全局配置,有7个部分配置编译:
GLOBAL_SETTING
变量disbale_libs关闭MoDIS编译中不需的手机端模块,例如bootloder模块,此模块在手机端上用于引导系统,但是在MoDIS上,由于并不是真实的目标板环境,因此该模块需要取消。
变量enable_libs增加MoDIS编译中所独有的模块,例如modis_fs,由于采用了模拟的文件系统,因此在disbale_libs中加入fs模块后,在enbale_libs上加入modis_fs。
ENABLE_INC_PATH/ DISABLE_INC_PATH
增加或减少头文件的搜索路径,其中global为全局路径,其他为相应模块的路径。
ENABLE_OPTION/ DISABLE_OPTION
增加或减少宏定义,其中global为全局宏,其他为相应模块或文件的宏。
ENABLE_FILE/ DISABLE_FILE
增加或减少相应模块的文件。
b) Module.ini
MoDIS目录下各模块都有.ini文件,通过此类文件,用户可以修改相应模块编译时的头文件搜索路径、宏定义选项。
c) CreateMoDIS.pl
编译MoDIS的批处理文件,在修改一些模块,如增加国笔时需要修改。
6. 常见编译错误
1) mtk_resgenerator.exe不能正常运行。可能是ResGenerator文件夹中的某些文件有错误。一个原因是在ResGenerator文件夹中缺少temp.rgb这个文件,并且不能自动生成。
2) 240X320屏的Font_res.c文件的错误,因为打开了中文字体的编译开关,只需要将mmi_featurespluto.h文件中__MMI_LANG_SM_CHINESE__的编译开关关闭即可。
3) 出现以下错误,"plutommi/mmi/FunAndGames/FunAndGamesSrc/Game.c", line 349: Error: C2455E: array [0] found
"plutommi/mmi/FunAndGames/FunAndGamesSrc/Game.c", line 350: Error: C2455E: array [0] found
因为默认的240X320屏幕打开的关于游戏的编译开关下没有游戏,所以需要打开mmi_featurespluto.h文件中的__MMI_GAME_VSMJ_240x320__编译开关。
4) 现象:mmiresource模块生成错误:
"plutommi/Customer/custresource/custimgmapext.c", line 31: Error: C2456E: undeclared name, inventing 'extern int MAX_IMAGE_IDS'
"plutommi/Customer/custresource/custimgmapext.c", line 31: Serious error: C2958E: illegal in constant expression: non constant 'MAX_IMAGE_IDS'
plutommi/Customer/custresource/custimgmapext.c: 0 warnings, 1 error, 1 serious error
原因:改变了屏幕大小后,128X160目录下的图片资源有问题。
解决办法:更换128X160目录下的图片资源,重新编译此模块。
5) 现象:Free clusters are NOT enough . Check ckSysDrv.log for detail !
Tools/make.exe: *** [cksysdrv] Error 1
解决办法:删除掉/custom/system/CCDH26_05C_BB目录下的
custom_EMI.c
custom_EMI.h
flash_opt.h
三个文件。
6) 现象:在新加模块的.c文件中引用一个b.h,产生b.h中的aaa变量没有定义的错误,具体错误如下:
原因:没有包含定义aaa变量的头文件a.h。
解决办法:在include b.h之前include a.h
7) 现象:"plutommi/Customer/custresource/CustImgDataHW.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: C2933E: type disagreement for 'mmi_phb_info_entry_list'
原因:调用mmi_phb_info_entry_list函数时传递的参数不正确,或者是函数mmi_phb_info_entry_list在调用时还未定义。
解决办法:修改custominfo.pl文件。
10) 现象:编译时出现字符串未定义的错误,
enum_list.h:2046:
error: `STR_ENTERTAINMENT_EXPLAIN_WOMANKNOWLEDGE' undeclareere (not in a function)
原因:可能是编译开关没打开,或者是正在使用excel表,readexcel.c中没有添加相关的头文件。还有一种可能是在使用这个字符串ID的模块的make底下的.inc文件中没有将定义这个字符串的头文件路径加上。还要注意防止头文件引用的宏定义是不是重复。
11) 现象:执行ResGenerator.bat时到输出第一份记录文本文件时当机,并且每次都过不去。
原因:安装了Windows的更新程序导致的,具体的可能是因为两个原因,一是安装了MSN最新版的补丁,也有可能是安装了SP3补丁所致。