MTK之10A1032版本解读

 

申明：本文系原创，转载时请注明出处，本人保留追究责任的权利。 原文地址：http://hi.baidu.com/surfmygod/blog/item/6f3a66900cbb195ad0135e7d.html   最近公司有个项目，要用MTKMTK10A1032版本出软件。今天刚刚拿到了MTK10A1032版本的软件，大致了解了一下，感觉比之前的版本改动要大很多，可以说是脱胎换骨了。改动后的版本C源文件明显比原来减小，而附加了很多xml、res文件，各模块资源定义和文件结构也做了较大改动。对于程序员来说，由于资源和操作分离了，加些资源什么的比之前要容易一些，程序也简洁了很多。当然老MTK程序员需要用一段时间来适应新版本，一段时间内可能不是很顺手。本文从创建一个APP为例逐步探讨该平台的开发流程。由于水平有限，不保证所有内容均准确无误，只是抛砖引玉给想尝试新版本的同仁们（那些想第一个吃螃蟹的人，嘿嘿，偶也是）。若有疏忽遗漏错误之处，欢迎指正，欢迎交流。 PS：10A开发环境为VC9+RVDS3.1，bin档编译只能单机（目前暂不知道怎么用分布式，开启分布式会报错，MTK的人说好像要使用浮动IP才可以，俺不懂，暂且不管，我们用四核Q8200重新new一遍大概在半个小时左右，还可以接受），模拟器可以使用分布式。编译bin档前请卸载分布式编译（目前确认关闭分布式服务也可以，这样就可以不必卸载分布式了。关闭方法：右键点分布式的小图标，选择“Agent Settings”，左侧选择“Agent”－“General”，右侧“Agent Service”一栏点“Stop”按钮关闭服务。需要打开的时候按同样方式点选“Start”）。有谁知道10A下分布式怎么配的，留言告诉我，谢谢！至于环境的配置我就不罗嗦了，VC9很好装，RVDS也不是很困难，网上找找资料就可以搞定。   1、文件结构 目录一：plutommi\MMI\FirstApp 目录二：plutommi\MMI\FirstApp\FirstAppInc（该结构未改变） 文件列表： FirstAppDefs.h：用于存放本程序所需要的类型，结构，常量的定义 FirstAppProt.h：用于存放本程序中的所有函数声明，但此文件只被本文件的源程序所加载 FirstAppGprot.h：也是用于存放函数声明，但是此文件是用于别的程序加载，即此文件中的函数声明的都是对外的接口 FirstAppResDef.h：用于存放本资源ID的定义接口 目录三：plutommi\MMI\FirstApp\FirstAppSrc（该结构未改变） FirstAppSrc.c程序的主源文件 目录四：plutommi\MMI\FirstApp\FirstAppRes（新的目录） FirstApp.res：资源文件定义，包含字串、图片、菜单、屏幕等的定义，该文件实际为一个标准xml文件 ref_list_FirstApp.txt：该模块多国语言字串定义（目前发现该文件并未生效，不知道是否是设置问题）   2、将文件加入项目 修改make\plutommi\mmi_app\下的三个文件： 1）mmi_app.lis:此文件用来申明MMI所要编译的所有源文件，添加如下一行： plutommi\MMI\FirstApp\FirstAppSrc\FirstAppSrc.c 2）mmi_app.inc：此文件用来指明MMI所有头文件所在目录，同样添加： plutommi\MMI\FirstApp\FirstAppInc 3）mmi_app.pth：此文件用来指明MMI所有源文件所在目录，添加： plutommi\MMI\FirstApp\FirstAppSrc 4）在plutommi\Customer\ResGenerator\MakeFile文件中添加如下一行： -I "../../MMI/FirstApp/FirstAppInc"\   3、应用程序ID定义 1）在基础ID 统一定义文件plutommi\MMI\Inc\mmi_res_range_def.h（原来为MMIDataType.h）中找到如下定义块： RESOURCE_BASE_ENUM_BEGIN()     /**************************************************************************************      * Declare resource ID range below      **************************************************************************************/ ……     /**************************************************************************************      * Declare resource ID range above      **************************************************************************************/ RESOURCE_BASE_ENUM_END() 在其中添加： #ifdef __MMI_FIRSTAPP__ RESOURCE_BASE_RANGE(FIRSTAPP, 50), #endif 2）找到如下定义块： /* Beginning of resource table */ RESOURCE_BASE_TABLE_BEGIN() …… /* End of resource table */ RESOURCE_BASE_TABLE_END() 在块中间末尾位置添加： /**************************************************************************** * FirstApp *****************************************************************************/ #ifdef __MMI_FIRSTAPP__ #define FIRSTAPP_BASE ((U16) GET_RESOURCE_BASE(APP_FIRSTAPP)) #define FIRSTAPP_BASE_MAX ((U16) GET_RESOURCE_MAX(APP_FIRSTAPP)) RESOURCE_BASE_TABLE_ITEM_PATH(APP_FIRSTAPP, ".\\MMI\\FirstApp\\FirstAppRes\\")//这里较之前有所变化 #endif 3）最后在plutommi\mmi\Resource\PopulateRes.c中void PopulateResData(void)函数相关区域加入： #ifdef __MMI_FIRSTAPP__ ADD_APPLICATION(APP_FIRSTAPP,"FirstApp", FIRSTAPP_BASE, FIRSTAPP_BASE_MAX);//添加应用程序 #endif   4、字串、图片、屏幕资源的添加 先来说字串、图片、屏幕资源ID的添加。10A版本中对资源定义的改动比较大，稍微对比一下新老版本，你会发现很多原来很大的文件变小了，而多出来了很多.res后缀的文件，这就是新版本的资源定义文件。10A版本仍部分保持了老版本的定义方式，不过笔者建议采用新版本的方式来定义资源，而且与之前相比新版本的资源定义要方便不少。读者可以随便找一个res文件，会看到如下定义格式： /* Needed header files of the compile option in XML files, if you need others need to add here */ #include "mmi_features.h" #include "custresdef.h" /* Need this line to tell parser that XML start, must after all #include. */ <?xml version="1.0" encoding="UTF-8"?> /* APP tag, include your app name defined in MMIDataType.h */ <APP id="APP_FIRSTAPP">/* 这里定义的id必须和之前定义的APP的ID一致 */     /* When you use any ID of other module, you need to add        that header file here, so that Resgen can find the ID */     <!--Include Area-->     <!-----------------------------------------------------String Resource Area----------------------------------------------------->     /* String ID of you Application, we will get string from ref_list.txt for all languages */        <STRING id="STR_ID_APP_FIRSTAPP_HELLO"/>/* 在这里添加自己的字串ID */     /* 这里说下，字串的内容定义和之前的版本一样放在YourProjectPath\plutommi\Customer\CustResource\PLUTO_MMI\ref_list.txt下，为了更好的兼容，最好将你自己定义的字串重新规整到YourProjectPath\plutommi\MMI\FirstApp\FirstAppRes\ref_list_FirstApp.txt下，具体定义方式和ref_list.txt类似，参考本博客文章《MTK编程起步——建立新APP和资源定义》 */     <!-----------------------------------------------------Image Resource Area------------------------------------------------------>     /* Image Id and path of you Application , you can use compile option in Path, but need out of "" */         <IMAGE id="IMG_ID_APP_FIRSTAPP_HELLO">CUST_IMG_PATH"\\\\MainLCD\\\\FirstApp\\\\HELLO.BMP"</IMAGE>     /* 这里定义自己的图片ID和路径，注意图片现在的CUST_IMG_PATH路径是在YourProjectPath\plutommi\Customer\Images\FTE320x480，请将图片文件夹放在这里，然后打包整个MainLCD文件夹为image.zip（改了mtk_resgenerator.cpp的可以不用打包） */     <!------------------------------------------------------Menu Resource Area------------------------------------------------------>     /* Only MENUITEM need compile option, MENUITEM_ID does not need */     /* 这里定义你的菜单ID，具体定义方法稍后给出 */     <!------------------------------------------------------Other Resource---------------------------------------------------------->     <SCREEN id="SCR_ID_APP_FIRSTAPP_HELLO"/>/* 这里定义你的屏幕ID */ </APP> 这个res文件类似与xml文件，不过你可以在其中使用一些C的预处理命令和注释。使用这种方式你不需要自己去定义res_app_firstapp.c，系统会在这个文件中搜索ID并自动生成名为mmi_rp_app_firstapp_def.h和mmi_rp_app_firstapp.c的文件，并在后者中定义对应的populate函数。至于res文件中各标签和其属性定义，请参看MTK官方文档10A_MMI_Resource_Training.pdf。   5、菜单添加 菜单由于有上下级关系，定义要相对复杂些，这里先介绍几个标签：MENU、MENUITEM和MENUITEM_ID。MENU是用来定义菜单树的标签，MENUITEM是用来定义单个菜单项的标签，MENUITEM_ID是用来在MENU树中安置菜单项的标签。下面来讨论菜单的定义。 新版本中菜单的定义方式有很多种，现介绍最常用的三种方式，其它方式请读者参看上面给出的MTK官方文档。 方法一：MENU中包含MENUITEM_ID方式定义 这种方式采用如下格式： <MENUITEM id="SUBMENU1" str="STR_SUBMENU1"/> <MENUITEM id="SUBMENU2" str="STR_SUBMENU2"/> <MENU id="MENU1" type="OPTION" str="STR_MENU1" highlight="HighlightMenu1" hint="HintMenu1">         <MENUITEM_ID>SUBMENU1</MENUITEM_ID>         <MENUITEM_ID>SUBMENU2</MENUITEM_ID> </MENU> 采用这种方式要在MENU体外申明对应MENUITEM的定义，可以放在引用MENU之前也可在其后，但MENU中MENUITEM_ID包含的内容必须是已定义的MENUITEM的ID，如果不存在系统将会将该菜单忽略。另外提一点，为了和先前的版本兼容，MTK提供了@OID:前缀，用来引用原先在c文件中定义的菜单ID，使用方法是将其放在<MENUITEM_ID></MENUITEM_ID>标签对之间即可，例如：<MENUITEM_ID>@OID:SUBMENU3</MENUITEM_ID>。不过引用前请使用<INCLUDE file="XXXResDef.h"/>引用你ID所在文件，将其至于<!--Include Area-->下。 方法二：直接将MENUITEM定义在MENU中，格式如下：  <MENU id="MENU1" type="OPTION" str="STR_MENU1" highlight="HighlightMenu1" hint="HintMenu1">         <MENUITEM id="SUBMENU1" str="STR_SUBMENU1">SUBMENU1</MENUITEM_ID>         <MENUITEM id="SUBMENU2" str="STR_SUBMENU2">SUBMENU2</MENUITEM_ID> </MENU> 这种方式不需要在MENU体外定义对应MENUITEM，只需要放在MENU标签内同时定义MENUITEM信息即可。 方法三：嵌套MENU，格式如下： <MENU id="MENU1" type="OPTION" str="STR_MENU1" highlight="HighlightMenu1" hint="HintMenu1">         <MENU id="SUBMENU1" type="OPTION" str="STR_SUBMENU1" highlight="HighlightSubMenu1" hint="HintSubMenu1"></MENU>         <MENU id="SUBMENU2" type="OPTION" str="STR_SUBMENU2" highlight="HighlightSubMenu2" hint="HintSubMenu2"></MENU> </MENU> 采用这种方式使得菜单的定义一次完成，也易于理解，但是当属性较多层次较深的时候可能显得较乱。这种方式是直观的MENU树表现方式，显示了子菜单与父级菜单的对应关系。有些读者可能对MENU和MENUITEM有些迷茫，笔者认为，在大部分时候MENU和MENUITEM可以通用，你可以把他们看成一种东西（MENU）。你可以将方法三第二行替换成方法一或方法二的形式。不过如果有SUBMENU1有子菜单的时候，方法三可以直接嵌套在对应MENU体之中，而方法一或方法二则需在MENU方法体外做如下定义： <MENU id="SUBMENU1" type="OPTION" str="STR_SUBMENU1" highlight="HighlightSubMenu1" hint="HintSubMenu1"> …… </MENU> 以上三种方法可以根据需要混合使用。最后为了完整实现菜单功能，别忘了添加对应菜单的highlight和hint函数。说到highlight和hint函数，这里有必要提一下，不是所有菜单都可以直接在res文件中添加highlight和hint选项来实现的，如果你发现你的highlight和hint不起作用，请使用模拟器跟踪一下同类高亮函数，会发现其高亮处理在类似mmi_ret mmi_phnset_gpio_menu_handler(cui_menu_event_struct *menu_evt, MMI_ID parent_gid)和static void mmi_phnset_gpio_select_menu(mmi_menu_id id, MMI_ID parent_id)的函数中使switch (menu_evt->highlighted_menu_id){case SUBMENU1:}或switch (id){case SUBMENU1:}进行多分支进行的。其中前一个函数的作用是点选左键或点触该菜单项所执行的事件即原来高亮函数中的SetLeftSoftkeyFunction，而后一个函数则是高亮该菜单项所执行的函数即原来的高亮函数。而hint函数存在于类似static mmi_ret mmi_phnset_disp_setup_sub_menu_entry_handler(cui_menu_event_struct *param)中，switch (param->parent_menu_id){case MENU1:}对父级菜单ID进行判断并执行相应初始化函数，hint函数位于对应父级菜单的初始化函数中。注意这里一定是父级菜单而不是本菜单，因为hint函数的加载都是在进入包含该菜单的父级菜单中进行的。