疯壳-MTK智能穿戴入门篇-编程之资源

一、MTK开发环境搭建        3

二、MTK平台框架        6

三、MTK编译指令        11

四、MTK编程入门        11

五、资源        12

六、新增APP        22

        MTK的资源分为很多种，有图片资源、铃声资源、字符串资源、屏幕资源、菜单资源、定时器资源、nvram 资源，消息接收器等。所有的资源都定义在 .res 文件中，使用 XML 语句书写，所有的资源在 res 文件中都是用包含，而 APP_NAME 需要在mmi_pluto_res_range_def.h 文件中设置各个资源的个数。

（1）MMI_RES_DECLARE(APP_MAINMENU, 300, ".MMIMainMenuMainMenuRes")

        APP_MAINMENU定义在MainMenuRes.res 文件中，包含所有的资源。300 是指资源的最大个数，这里并不是所有资源相加的，而是图片、字串等资源各自可以添加300个。".MMIMainMenuMainMenuRes"表示APP_MAINMENU 所在资源文件的目录。

（2）#define MAIN_MENU_BASE                       ((U16) GET_RESOURCE_BASE(APP_MAINMENU))

        资源ID 的最小取值，所有资源ID 的数字大于MAIN_MENU_BASE

（3）#define MAIN_MENU_BASE_MAX                   ((U16) GET_RESOURCE_MAX(APP_MAINMENU))

        资源ID 的最大取值，所有资源ID 的数字小于MAIN_MENU_BASE，实际上MAIN_MENU_BASE + 300 = MAIN_MENU_BASE_MAX。

        添加完资源之后，都需要使用 make resgen（make  FengKe2502C_11C GPRS  resgen）编译资源，生成二进制。如果在真机上调试，在make resgen之后还需要使用 make r mmiresource 重新编译资源模块，或者直接使用 make u mmiresource 编译，在模拟器上调试可以不用编译mmiresource。

        资源编译之后，都会在plutommiCustomerCustomerInc目录下生成一个mmi_rp_app_name_def.h 的文件，比如上面的app_name 为APP_MAINMENU，则生成的文件名为mmi_rp_app_mainmenu_def.h 。在该文件中，所有同类型的资源都会生成一个enum枚举，枚举命名格式为mmi_rp_app_name_style_enum，style为资源类型，比如mmi_rp_app_mainmenu_str_enum 则为所有的字串资源ID。如果res文件中的ID，在这个文件里能够找到，说明资源生成成功。习惯上所有资源ID名称都用大写。

        在 MTK 设备上，每一个屏幕都对应唯一一个屏幕ID。屏幕之间的相互切换，屏幕历史堆栈管理，都是通过屏幕 ID 进行的。屏幕资源的添加方法使用如下语句：

        屏幕ID资源的命名方式，习惯上以 SCR_开头，比如 ，或者以GRP_ 开头。比如 。通常情况下，以SCR_开头的资源一般作为实际的单个屏幕，而以GRP_开头的资源都用于屏幕组（group），一个GRP屏幕组下面，可以包含多个SCR屏幕，当你关闭一个GRP屏幕组时，那么其下的所有SCR屏幕都被关闭了。实际上SCR 和 GRP 都是同类型的资源，在使用的时候反过来也没有问题，但我们反对这么做，因为从命名上来看会导致歧义，减弱代码的可读性和可维护性。在MTK中所有的屏幕是呈一个树形结构，（见下图）

1、 MMI_ID mmi_frm_group_create (MMI_ID parent_id, MMI_ID group_id, mmi_proc_func proc, void *user_data)

参数parent_id：屏幕组的父类，通常情况下可以填GRP_ID_ROOT。

参数group_id：是要创建的屏幕组ID。

参数proc：屏幕组的消息处理函数

参数user_data：用户需要传递的数据，通常情况下用 NULL

2、 MMI_BOOL mmi_frm_scrn_enter (MMI_ID parent_id, MMI_ID scrn_id, FuncPtr exit_proc, FuncPtr entry_proc, mmi_frm_scrn_type_enum scrn_type)

参数parent_id：屏幕的父类，可以是我们自定义的屏幕组，也可以填GRP_ID_ROOT。

参数scrn_id：屏幕ID。

参数exit_proc：退出屏幕时的处理函数，一般用于释放资源。如果没有退出函数，则填NULL。

参数entry_proc：屏幕的入口函数，当屏幕从历史堆栈中弹出时，会执行这个函数。

参数scrn_type：屏幕类型，一般常用的是MMI_FRM_FULL_SCRN 和MMI_FRM_UNKNOW_SCRN

3、 mmi_ret mmi_frm_group_close (MMI_ID group_id)

函数功能：关闭屏幕组group_id

4、 mmi_ret mmi_frm_scrn_close (MMI_ID parent_id, MMI_ID scrn_id)

函数功能：关闭屏幕组parent_id下的scrn_id屏幕

5、 void mmi_frm_scrn_close_active_id (void)

6、 U16 GetActiveScreenId(void)

函数功能：获取当前处于激活状态的屏幕ID。

屏幕ID树状结构

        接下来我们自己定义一个屏幕ID，屏幕组ID暂时不讲解。在Idle.res文件中找到，在后面添加一句，代码如下：

        然后用 make resgen 编译，编译完成之后打开mmi_rp_app_idle_def.h文件，在mmi_rp_app_idle_scr_enum枚举中看是否能找到SCR_ID_MY_MTK_FUNC，如果能找到说明资源添加成功了。接下来我们将mmi_my_mtk_func函数作为一个屏幕入口函数，让它进入一个屏幕，同样打印出"Hello MTK !"，并注册右软键功能关闭该屏幕，然后添加一个屏幕退出函数mmi_my_mtk_func_exit，在退出该屏幕时，我们打印"Exit Hello MTK !"，具体代码如下：

        在VS2008 中编译，运行模拟器。我们点击左软件的时候，屏幕上依旧会显示"Hello MTK !"，当我们点击右软键的时候，屏幕上会显示"Exit Hello MTK !"，但是会闪一下就消失，因为先执行退出函数，然后会立即执行idle界面的入口函数，绘制idle界面的内容，从而把"Exit Hello MTK !"覆盖掉了。读者可自己使用断点，查看代码执行流程。

        在上一个例子中，我们显示"Hello MTK !"直接使用的是字符常量，这样的方式在单一语言下是没有问题的，但如果系统包含多国语言，比如从英文切换到中文，如何把"Hello MTK !"直接显示成中文呢？这里就要用到字符资源，字符资源全部添加在plutommiCustomerCustResourcePLUTO_MMI
ef_list.txt 文件中，里面包含约80种语言字符，我们只要输入对应语言的字符，那么字符显示成何种语言就会随系统的语言设置而变化。MTK提供了一个专用于修改字符资源的工具——plutommiCustomer STMTView.exe。接下来我们把"Hello MTK !"添加成字符资源，然后通过GetString函数接口提取字符串。添加字符资源的语句格式为：

           "default string" 或

        字符资源ID命名通常以“STR_”开头，这两种方法的区别在于前者设置了默认值，如果STR_NAME在ref_list.txt不存在的话，那它在任何语言下都会显示"default string"（注意：此处添加的默认值只能是英文字符）。而后者没有默认值，如果STR_NAME在ref_list.txt不存在的话，请读者自己测试会显示什么内容。

        我们采用设置默认值的方式添加字符资源，在idle.res文件中添加字符资源ID——STR_ID_HELLO_MTK，代码如下：

        然后在plutommiCustomerCustResourceFengKe2502C_11C_MMIMMI_features_switchFengKe2502C_11C.h文件中找到宏开关CFG_MMI_LANG_SM_CHINESE把后面的(__OFF__)改为(__ON__)，这里是让系统支持简体中文，为方便我们验证字符资源的多国语言翻译问题。接下来还要为系统添加字库，在FengKe2502C_11C_GPRS.mak文件中设置FONT_ENGINE = FONT_ENGINE_ETRUMP，使用矢量字库。

        打开plutommiCustomerSTMTView.exe，点击File—>Open STMT… 会显示两个表格栏，随便选择一个，单击点击红色标注的图标 ，在弹出的文件选择对话框中，选择plutommiCustomerCustResourcePLUTO_MMI
ef_list.txt然后打开，出现如下界面：

        在打开文件的一栏中单击鼠标右键，选择Insert new row。如下图所示填充弹出框：

1、Enum value：字符资源的枚举ID，必须跟.res文件中添加的资源ID一一对应，否则资源无法加载。

2、Mode name：字符资源所在的功能模块，这个可以使用默认的值，仅作为描述。

3、Region ID：这个也仅是描述作用，可以手动输入，也可以点击旁边的按钮选择，也可以不填。

4、Description：这个也仅是描述作业，可以描述字符ID的用途。

5、Default value：字符资源ID的默认值，在任何语言下都是会默认使用这个值。

下面的复选框打勾，把资源ID添加到文件的最后一行，点击OK。在新增的一行，对应 Si_Chinese列把"Hello MTK !"改成“你好，MTK !”，添加效果如图：

在mmi_my_mtk_func 函数中把L"Hello MTK !" 改成GetString(STR_ID_HELLO_MTK)，暂且把mmi_my_mtk_func_exit函数中的代码清空，具体代码如下：

        上面我们修改了MMI_features_switchFengKe2502C_11C.h和FengKe2502C_11C_GPRS.mak这两个文件，只要修改了这两个文件的任意一个，都必须执行make new编译，再用make gen_modis重新生成模拟器。如果这两个文件没有修改，则make resgen就可以了。编译完后打开plutommiCustomerResGeneratordebugstring_resource_usage.txt 文件看是否能找到STR_ID_HELLO_MTK，系统中所有的字符资源ID编译成功之后都可以在这个文件中找到，如果找不到则说明资源添加失败。字符资源编出来之后就是UCS2编码。在VS2008中运行模拟器，点击 KEY_LSK，运行效果如下：

        系统默认是英语环境，所以依旧显示"hello MTK !"，接下来我们把系统切换成中文。打开GeneralSettingSrv.c文件，在srv_setting_get_language函数中把return data;改为return 1;再次运行模拟器，点击KEY_LSK，运行效果如下：

        字符资源的最大优势，就是可以支持多国语言，而对于程序员来说，只有一个资源ID。在调用GetString时，它会根据系统环境的语言设置，获取对应的字符串指针。

        MTK中显示的图片有三种，一是通过资源加载的，二是显示磁盘中的文件，三是直接把图片转成二进制数组显示，这种方式常用于SP游戏或应用开发。此处我们只讲图片资源。图片资源跟字符资源一样，也是添加在 .res文件中，添加图片资源的语句格式为：

            CUST_IMG_PATH"image_filepath\image_filename"

        图片资源ID命名通常以“IMG_”开头，所有的图片资源都放在plutommiCustomerImage文件夹中，在这个文件夹中包含不同屏幕尺寸的图片资源，每个屏幕尺寸对于的文件夹下都有一个image.zip压缩包中，系统中的图片资源就放在这个压缩包中，我们添加的图片也要放到压缩包对应的目录中，在编译资源的时候，系统会将其解压成MainLCD目录。CUST_IMG_PATH是一个宏，定义在plutommiCustomerCustResourcePLUTO_MMI CustResDefPLUTO.h文件中，它指向image.zip所在的目录，比如当前屏幕尺寸为240X320（屏幕尺寸的配置在FengKe2502C_11C_GPRS.mak文件中查看MAIN_LCD_SIZE宏定义），则CUST_IMG_PATH 定义指向plutommiCustomerImagesPLUTO240x320目录，系统中定义的代码如下：

        image_filepath是相对于MainLCD的目录，image_filename就是图片的文件名，包含后缀名。图片资源的格式可以是bmp、png、jpg、gif还有MTK系统特定的一些图片格式。系统中添加成功的图片资源，其资源ID都可以在文件plutommiCustomerResGeneratordebug image_resource_usage.txt中找到。如果资源加载失败，则资源ID会被添加到相同目录的image_load_fail.txt文件中，这种情况通常都是图片的目录错误，或者image.zip中没有这个图片文件。

        接下来我们添加一个图片资源，在plutommiCustomerImagesPLUTO240x320MainLCDIdleScreenWallpaper目录下，随便找一张图片，或者自己随便找一张图片放到image.zip对应的目录中。这里我就使用WALL01.jpg来做测试。在idle.res文件中添加一个资源ID——IMG_ID_HELLO_MTK，并加载WALL01.jpg图片，代码如下：

        然后使用 make resgen 编译，编译完成之后在image_resource_usage.txt看是否能找到IMG_ID_HELLO_MTK，如果能找到，说明资源加载成功。接下来在mmi_my_mtk_func函数中调用gdi_image_draw_id接口把图片显示出来。因图片是黑色，所以我们把字符颜色改为白色（UI_COLOR_WHITE），代码如下：

1、 gdi_image_draw_id(OFFSET_X,OFFSET_Y,IMAGE_ID)   

函数功能：这是一个宏函数，根据图片ID在屏幕上显示图片

OFFSET_X：图片的显示的X坐标。

OFFSET_Y：图片的显示的Y坐标。

IMAGE_ID：图片资源ID

2、 gdi_image_draw_resized_id(OFFSET_X,OFFSET_Y,RESIZED_WIDTH,RESIZED_HEIGHT,IMAGE_ID)

OFFSET_X：图片的显示的X坐标。

OFFSET_Y：图片的显示的Y坐标。

RESIZED_WIDTH：图片显示的宽度，如果大于这个宽度则缩小，如果小于这个宽度则放大。

RESIZED_HEIGHT：图片显示的高度，同RESIZED_WIDTH一样缩放图片。

IMAGE_ID：图片资源ID

3、 gdi_image_draw(OFFSET_X,OFFSET_Y,IMAGE_PTR)

函数功能：这个函数的执行效果跟gdi_image_draw_id函数是一样的，只不过参数需传入一个图片的数组

OFFSET_X：图片的显示的X坐标。

OFFSET_Y：图片的显示的Y坐标。

IMAGE_PTR ：图片二进制数组，通常可通过GetImage(IMAGE_ID)获取。

        另外，图片资源还有gif动画，动画资源的添加方式跟图片资源是一样的，只不过显示的函数接口有点区别，动画的接口包含在gdi_include.h文件中，通常是以gdi_anim_ 开头的函数，比如gdi_anim_draw_id，关于动画的使用本章暂时不做过多的讲解，有兴趣的读者可以自己看代码学习。

1、        菜单中包含子菜单。

        < MENU        ……[item  value]…… >

                MENU_ITEM_ID或

                …………………………

        

        如果不包含子菜单则可以写成：

        < MENU        ……[item  value]…… /> 或< MENU        ……[item  value]…… > MENU >