MTK 开发心得--P1300 Hello World 网友Henry原创

只看该作者 · 2009-7-3 14:50

Hello World
上面一节我们建立好了开发环境，现在是时候实战一把了，在进行实质性的项目开发之前，我们先来了解下P1300上写程序的一般性做法。从“Hello World”开始吧，有句笑话讲：“会编程就是会Hello World，编程高手就是会写很多个Hello World”,虽然是句笑话，但是细想也是有道理的，麻雀虽小五脏俱全嘛，掌握了框架，剩下的就无非是些编程技巧的问题了。这和建房子一个道理，地基打的深不深，框架建的是否合理，决定房屋总体质量好不好，其他就是装修的功夫了，当然还有水电线路的铺设，这涉及到习惯和技巧了，设计不好会漏水漏电，哈哈。扯远了，下面开始Hello World。
下面为描述上的方便，我们将Hello World称为一个模块。首先建立新的模块目录，之后把模块相关文件都放到这个目录下统一进行管理，新的模块一般放到plutommiMMI下面，这里我们新建一个目录“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__ */
    /*************************************************************************/
    其他几个文件的内容因模块功能而异，这里先略过，后面再讲。
    紧接着，我们要修改的相关系统文件，使这个模块成为整个项目的一部分，需要修改的系统文件如下：
    makeplutommiplutommi.inc   所有mmi部分的头文件所在目录的相对路径列表
    makeplutommiplutommi.pth   所有mmi部分的源文件所在目录的相对路径列表
    makeplutommiplutommi.lis    所有mmi部分的源文件(相对路径)列表
    在上述3个文件里面分别加上我们模块的对应内容，就现在讲的HelloWorld而言，所加内容如下：
    makeplutommiplutommi.inc文件追加一行“plutommimmiHelloWorldInc”
    makeplutommiplutommi.pth文件追加一行“plutommimmiHelloWorldSrc”
    makeplutommiplutommi.lis文件追加一行“plutommimmiHelloWorldSrcHelloWorld.c”
    再接着，我们需要增加一个开关，以决定这个模块是否成为最终发布版本的一部分，这实际上是一个编译开关，需要修改系统文件及相关的模块源文件，需要修改的系统文件包括：
    plutommiCustomerCustResourcePLUTO_MMIMMI_featuresPLUTO.h，这里我们用    名字为“__MMI_HELLOWORLD_ENABLED__”这个开关好了，在这个文件里面追加一行：
    #define    __MMI_HELLOWORLD_ENABLED__，同时在相关源文件里面用：
    #ifdef    __MMI_HELLOWORLD_ENABLED__
    #endif
    来框住相关代码行就OK了，当不打算将这个模块发布的时候，注释掉“#define    __MMI_HELLOWORLD_ENABLED__”这一句重新make一次就好了。
    下面讲具体实现的部分，为了简化描述，我们暂时先将我们的模块入口挂接到主菜单入口处(后面讲到资源的部分可将入口移到某个新建的子菜单下)，修改下文件“plutommimmimainmenumainmenusrcMainMenu.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库里面了：

    后续的make，如果是不涉及到系统相关文件的修改，用“make remake”就可以了，以节省编译时间，因为make一次太耗时间了。
    注意：对于仿真程序的编译，“make update”似乎缺少一些处理，导致可能还需要手工在文件“plutommimmiGlobalSimulatorPathDef”中追加一行，以便模块的头文件能被顺利找到，如下所示：
    /I ".HelloWorldInc"
    好，现在编译仿真程序开始看下效果，编译 (make update会清除掉仿真程序之前编译的中间文件，这样仿真程序会整个重新编译) 完后运行仿真器程序，如下图所示，点选File->Network Simulator启动仿真，启动后手机模拟器进入Idle画面，点选手机模拟画面上的“菜单”，就进入到我们的Hello World了，而不是之前的主菜单，然后点右按钮，画面回到Idle画面。

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

    未完待续……