MTK添加资源(含52_11B情况的说明)

1、文件结构
目录一:plutommi\MMI\FirstApp
目录二:plutommi\MMI\FirstApp\FirstAppInc
文件列表:
FirstAppDef.h:用于存放本程序所需要的类型,结构,常量的定义
FirstAppProt.h:用于存放本程序中的所有函数声明,但此文件只被本文件的源程序所加载
FirstAppGprot.h:也是用于存放函数声明,但是此文件是用于别的程序加载,即此文件中的函数声明的都是对外的接口
FirstAppResDef.h:用于存放本资源ID的定义接口

目录三:plutommi\MMI\FirstApp\FirstAppSrc
FirstApp.c程序的主源文件

目录四:plutommi\MMI\FirstApp\FirstAppRes

FirstApp.res:资源文件定义,包含字串、图片、菜单、屏幕等的定义,该文件实际为一个标准xml文件

ref_list_FirstApp.txt:该模块多国语言字串定义

#########################################################
注:
目前字符串定义还是在ref_list.txt文件中定义,在ref_list_FirstApp.txt文件中定义发现没有生效。
文件是plutommi\Customer\CustResource\PLUTO_MMI\ref_list.txt,而不是plutommi\Customer\CustResource\ref_list.txt
#########################################################


2、将文件加入项目

修改make\plutommi\mmi_app\下的三个文件:
1)mmi_app.lis:此文件用来申明MMI所要编译的所有源文件,添加如下一行:
plutommi\MMI\FirstApp\FirstAppSrc\FirstApp.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"\

#########################################################
注:
在52_11B中,需要直接修改mmi_app.mak文件,在SRC_LIST、INC_DIR、和SRC_PATH三个变量中分别添加上述三个文件,而分别在mmi_app.lis、mmi_app.inc和mmi_app.pth三个文件中添加是没有效果的。
#########################################################


3、应用程序ID定义

1)在基础ID 统一定义文件plutommi\MMI\Inc\mmi_res_range_def.h(原来为MMIDataType.h)中找到如下定义块:
RESOURCE_BASE_ENUM_BEGIN()
   
……

   
RESOURCE_BASE_ENUM_END()

在其中添加:

#ifdef __MMI_FIRSTAPP__
RESOURCE_BASE_RANGE(APP_FIRSTAPP, 50),
#endif

2)找到如下定义块:

RESOURCE_BASE_TABLE_BEGIN()
……

RESOURCE_BASE_TABLE_END()
在块中间末尾位置添加:

#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

#########################################################
注:
宏__MMI_FIRSTAPP__相当于功能开关,如果不需要,可以删除。功能开关的定义在6中说明。
#########################################################


4、字串、图片、屏幕资源的添加

先来说字串、图片、屏幕资源ID的添加。10A版本中对资源定义的改动比较大,稍微对比一下新老版本,你会发现很多原来很大的文件变小了,而多出来了很多.res后缀的文件,这就是新版本的资源定义

文件。10A版本仍部分保持了老版本的定义方式,不过笔者建议采用新版本的方式来定义资源,而且与之前相比新版本的资源定义要方便不少。读者可以随便找一个res文件,会看到如下定义格式:

#include "mmi_features.h"
#include "custresdef.h"

<?xml version="1.0" encoding="UTF-8"?>

<APP id="APP_FIRSTAPP">

    <!-----------------------------------------------------String Resource Area----------------------------------------------------->
       <STRING id="STR_ID_APP_FIRSTAPP_HELLO"/>

    <!-----------------------------------------------------Image Resource Area------------------------------------------------------>
    <IMAGE id="IMG_ID_APP_FIRSTAPP_HELLO">CUST_IMG_PATH"\\\\MainLCD\\\\FirstApp\\\\HELLO.BMP"</IMAGE>
   

    <!------------------------------------------------------Menu Resource Area------------------------------------------------------>
   

    <!------------------------------------------------------Other Resource---------------------------------------------------------->
    <SCREEN id="SCR_ID_APP_FIRSTAPP_HELLO"/>

</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函数。

6、 功能模块开关定义

如果没有定义功能开关宏定义,可以不看词部分。

功能模块开关的宏可以定义在两个地方。
1)MMI_feature.h
文件在plutommi\mmi\inc下,可以再最后的地方添加如下代码:
#ifndef __MMI_FIRSTAPP__
#define __MMI_FIRSTAPP__
#endif

2)Option.mak
在文件最后可以添加如下代码:
COM_DEFS += __MMI_FIRSTAPP__

猜你喜欢

转载自blog.csdn.net/sierllen/article/details/7486087
MTK