MTK开发心得（四）－网友henry原创

只看该作者 · 2010-3-1 14:36

本帖最后由华禹支持于 2010-3-2 10:48 编辑

一、Hello World
上面一节我们建立好了开发环境，现在是时候实战一把了，在进行实质性的项目开发之前，我们先来了解下P1300上写程序的一般性做法。从“Hello World”开始吧，有句笑话讲：“会编程就是会Hello World，编程高手就是会写很多个Hello World”,虽然是句笑话，但是细想也是有道理的，麻雀虽小五脏俱全嘛，掌握了框架，剩下的就无非是些编程技巧的问题了。这和建房子一个道理，地基打的深不深，框架建的是否合理，决定房屋总体质量好不好，其他就是装修的功夫了，当然还有水电线路的铺设，这涉及到习惯和技巧了，设计不好会漏水漏电，哈哈。扯远了，下面开始Hello World。
下面为描述上的方便，我们将Hello World称为一个模块。首先建立新的模块目录，之后把模块相关文件都放到这个目录下统一进行管理，新的模块一般放到plutommi\MMI下面，这里我们新建一个目录“HelloWorld”，然后在模块目录“HelloWorld”下再建三个子目录：“Inc”、“Src”和“Res”，分别用来存放模块的头文件、源文件和资源文件，目录结构如下图所示：

接着我们在Inc下创建几个头文件：HelloWorldGprot.h，HelloWorldProt.h, HelloWorldTypes.h, HelloWorldDefs.h,
再在Src下创建一个源文件：HelloWorld.c，关于文件名和函数名等的命名标准每个公司及个人各有不同，统一就好，否则在进行大的项目开发时彼此协同会遇到问题，有时候弄不好光这些问题就能折腾你半天甚至数日或数月，呵呵。
上面几个文件的作用我大致讲下：
HelloWorldGprot.h

模块对外接口，供模块外部调用的函数原型在此申明，模块内部接口就不要放这里了
HelloWorldProt.h
模块内部接口，供模块内部调用的函数原型在此申明
HelloWorldTypes.h

本模块用到的一些常量、自定义数据类型、结构的定义
HelloWorldDefs.h

本模块用到的资源ID定义
HelloWorld.c
模块功能函数的实现部分

头文件HelloWorldGprot.h的内容大致如下：
/*************************************************************************/
#ifndef
__HELLOWORLD_GPROT_H__
#define
__HELLOWORLD_GPROT_H__

#include "PixtelDataTypes.h"
#include "HelloWorldTypes.h"

extern
void mmi_HelloWorld_entry(void);/* 模块入口，理解成dos程序的main好了 */

#endif
/* __HELLOWORLD_GPROT_H__ */
/*************************************************************************/

头文件HelloWorldProt.h的内容的大致如下：
/*************************************************************************/
#ifndef
__HELLOWORLD_PROT_H__
#define
__HELLOWORLD_PROT_H__

#include "HelloWorldGprot.h"
extern void mmi_HelloWorld_entry(void);
/* 本模块主界面入口例程 */
extern void mmi_HelloWorld_exit(void);
/* 本模块主界面退出例程 */

#endif
/* __HELLOWORLD_PROT_H__ */
/*************************************************************************/
其他几个文件的内容因模块功能而异，这里先略过，后面再讲。
紧接着，我们要修改的相关系统文件，使这个模块成为整个项目的一部分，需要修改的系统文件如下：
make\plutommi\plutommi.inc
所有mmi部分的头文件所在目录的相对路径列表
make\plutommi\plutommi.pth
所有mmi部分的源文件所在目录的相对路径列表
make\plutommi\plutommi.lis
所有mmi部分的源文件(相对路径)列表
在上述3个文件里面分别加上我们模块的对应内容，就现在讲的HelloWorld而言，所加内容如下：
make\plutommi\plutommi.inc文件追加一行“plutommi\mmi\HelloWorld\Inc”
make\plutommi\plutommi.pth文件追加一行“plutommi\mmi\HelloWorld\Src”
make\plutommi\plutommi.lis文件追加一行“plutommi\mmi\HelloWorld\Src\HelloWorld.c”
再接着，我们需要增加一个开关，以决定这个模块是否成为最终发布版本的一部分，这实际上是一个编译开关，需要修改系统文件及相关的模块源文件，需要修改的系统文件包括：
plutommi\Customer\CustResource\PLUTO_MMI\MMI_featuresPLUTO.h，这里我们用名字为“__MMI_HELLOWORLD_ENABLED__”这个开关好了，在这个文件里面追加一行：
#define
__MMI_HELLOWORLD_ENABLED__，同时在相关源文件里面用：
#ifdef
__MMI_HELLOWORLD_ENABLED__
#endif
来框住相关代码行就OK了，当不打算将这个模块发布的时候，注释掉“#define
__MMI_HELLOWORLD_ENABLED__”这一句重新make一次就好了。

只看该作者 · 2010-3-1 14:38

本帖最后由 xingyangqing 于 2010-3-2 10:50 编辑

下面讲具体实现的部分，为了简化描述，我们暂时先将我们的模块入口挂接到主菜单入口处(后面讲到资源的部分可将入口移到某个新建的子菜单下)，修改下文件“plutommi\mmi\mainmenu\mainmenusrc\MainMenu.c”中的goto_main_menu函数，如下所示红色字体部分：

void goto_main_menu(void)

{

#ifdef    __MMI_HELLOWORLD_ENABLED__

   mmi_HelloWorld_entry();

   return;

#else

   … // 此处为之前goto_main_menu的代码

#endif

}

同时我们需要在文件MainMenu.c中包含头文件HelloWorldGprot.h，所以再在这个文件的头文件包含代码块(通常是文件的顶部区域)追加这一句：#include "HelloWorldGprot.h"。
下面是HelloWorld.c的内容：

/*************************************************************************/

#include "stdC.h"

#include "MMI_Features.h" /* 编译开关会出现在这个由make update生成的文件里面 */

#include "L4Dr.h"

#include "L4Dr1.h"

#include "AllAppGprot.h"

#include "FrameworkStruct.h"

#include "GlobalConstants.h"

#include "EventsGprot.h"

#include "mmiappfnptrs.h"

#include "HistoryGprot.h"

#include "HelloWorldProt.h"

#include "HelloWorldTypes.h"

#include "HelloWorldDefs.h"

#include "MainMenuDef.h"

#include "wgui_categories.h"

#include "Unicodexdcl.h"

/* 模块入口 */

void mmi_HelloWorld_entry(void)

{

#ifdef    __MMI_HELLOWORLD_ENABLED__

   /* 强制退出当前屏幕，之后进入到我们的模块了 */

   /* 上电缺省是idle屏幕，现进入MAIN_MENU_SCREENID屏 */

   /* 注意看第二个参数，这个是当我们模块被强制退出时执行的一些操作 */

   EntryNewScreen(MAIN_MENU_SCREENID, mmi_HelloWorld_exit, NULL, NULL);

   /* 关掉屏幕顶部的状态条，我们要用整个屏幕 */

   entry_full_screen();

   /* 擦除当前背景 */

   clear_screen();

   /* 移动文本输出光标 */

   gui_move_text_cursor(50, 100);

   /* 设置字体颜色 */

   gui_set_text_color(UI_COLOR_RED);

   /* 输出文本到显示缓冲, 注意是Unicode编码 */

   gui_print_text(L"Hello, World");

   /* 刷新屏幕显示，MMI用的是双缓冲绘图方式，而且需要显式刷新 */

   gui_BLT_double_buffer(0, 0, UI_device_width - 1, UI_device_height - 1);

   /* 注册一个按键处理，右软键弹起时返回到之前被我们强制退出的模块 */

   SetKeyHandler(GoBackHistory, KEY_RSK, KEY_EVENT_UP);

#endif

}

/* 模块出口

* 当我们的模块被其他模块强制退出时会执行这个函数，

* 这个函数的常见写法，包括：

* 1、模块已申请资源的释放(如果需要的话)，这一步可选

* 2、手动把自己压栈到窗口(实际是整个屏)堆栈里面，

*    便于强制我们退出的模块执行完后重新把我们叫出来

*    不像Window的窗口管理是自动压栈的，Pluto MMI需要手动压栈

* 3、其他一些清理动作

*/

void mmi_HelloWorld_exit(void)

{

#ifdef    __MMI_HELLOWORLD_ENABLED__

   history currHistory;

   S16 nHistory = 0;

   currHistory.scrnID = MAIN_MENU_SCREENID;

   currHistory.entryFuncPtr = mmi_HelloWorld_entry;

   pfnUnicodeStrcpy( (S8*)currHistory.inputBuffer, (S8*)&nHistory);

   AddHistory(currHistory);

#endif

}

/*************************************************************************/

编码的部分基本上就是这些了，然后我们开始make，这次要用“make update”,基于上述对相关系统文件的改动，make update会自动将刚才的模块加入到整个项目中去，同时也会更新仿真器VC工程文件，如下图所示，HelloWorld模块的相关文件已经被自动加入到MMI库里面了：

MTK开发心得－网友Henry原创（连载）
2009-6-16 23:04

后续的make，如果是不涉及到系统相关文件的修改，用“make remake”就可以了，以节省编译时间，因为make一次太耗时间了。

注意：对于仿真程序的编译，“make update”似乎缺少一些处理，导致可能还需要手工在文件“plutommi\mmi\GlobalSimulatorPathDef”中追加一行，以便模块的头文件能被顺利找到，如下所示：

/I ".\HelloWorld\Inc"

只看该作者 · 2010-3-1 14:39

本帖最后由 xingyangqing 于 2010-3-2 10:51 编辑

好，现在编译仿真程序开始看下效果，编译 (make update会清除掉仿真程序之前编译的中间文件，这样仿真程序会整个重新编译) 完后运行仿真器程序，如下图所示，点选File->Network Simulator启动仿真，启动后手机模拟器进入Idle画面，点选手机模拟画面上的“菜单”，就进入到我们的Hello World了，而不是之前的主菜单，然后点右按钮，画面回到Idle画面。

MTK开发心得－网友Henry原创（连载）
2009-6-16 23:04

至此，Hello World基本完成，这是一个相对完整的模块框架，在此基础之上我们可以逐步开始进入真正有意义的项目开发了。

未完待续……

MTK开发心得（四）－网友henry原创

相关下载

相关帖子