智能手机Smartphone开发从零起步

2005-07-26 10:16作者：楚云风出处：天极网责任编辑：方舟　　一些基本概念

　　因为在上面叙述中涉及了一些Smartphone的基本概念，作为入门的文章，下面，我对涉及到的一些概念进行解释。

　　1) Platform Manage

　　在安装Microsoft eMbedded C++ 4.0时候会提示你首先要安装Platform Manage，这是整个开发系统中非常核心的组件，它负责开发工具与实际的设备或者模拟的设备间所有的通讯。正是因为它屏蔽了信息交换的细节，才使得开发中模拟器可以作为一个真实的设备对待。

　　2) ActiveSync Transport与TCP/IP Transport

　　上面选择设备的Transport时候，有这样两种选择，ActiveSync Transport一般用于与真实smartphone设备的连接，而TCP/IP Transport既可以和真实设备也可以和模拟设备进行连接，因为TCP/IP Transport连接速度快且支持模拟设备，在开发调试的时候是首要选择。

　　3) ActiveSync Startup Server与Emulator Startup Server

　　所谓启动服务就是将编译好的程序download到所连接的设备上然后执行，ActiveSync Startup Server利用当前的ActiveSync连接来进行，设置可以通过ActiveSync程序进行；Emulator Startup Server必须使用TCP/IP Transport支持。开发调试的时候，一般选择Emulator Startup Server。

　　4) Virtual Radio与Radio Required

　　在配置Emulator Startup Server时候，有这两种Image选择，其中，Radio Required需要相应的无线发送设备支持而Virtual Radio则不需要，在最终测试时候，往往会需要Radio Required，开发和调试时候选择Virtual Radio。

　　实践开发

　　1、开发实例准备

　　鉴于本篇的定位，本文的例子是一个很简单的程序，运行后，程序主窗口会显示一行欢迎信息；程序底部会有两个菜单，一个是"关于"，一个是"选项"，"选项"是一个弹出式菜单，上面有两个菜单项"关于"和"退出"。

　　执行"关于"菜单会显示一个标准的信息对话框；执行"退出"菜单，会首先显示一个消息提示窗口，提醒你是否确认要退出，你可以选择"确定"退出本程序，也可以选择"取消"返回到程序的主界面。

　　下面是软件执行时的情况：


　　2、第一步：建立通用框架

　　因为Smartphone不支持MFC，因此，我们需要建立一个基于Windows CE API的编程框架，有过桌面开发或者Pocket PC开发经验的人会很清楚这个过程，包括注册窗口类、实例初始化、消息循环及窗口过程回调处理等，在Smartphone上也是一样的。

　　1) 打开eMbedded C++ 4.0 ，File -> New ，建立一个Smartphone 2003 工程：


　　注意，选择了WCE ARMV4 和WCE emulator 使我们可以编译在模拟器和真实设备运行的程序。

　　点击OK按钮进入下一步。

　　2) 选择建立一个空的工程。


　　确认后此工程被建立。

　　这里之所以不使用系统的标准框架是因为标准框架采用的是老式的消息处理方案，使用了很多的switch 语句来处理消息，不够灵活，也不方便程序的扩展，因此，这里从一个空的工程开始，仿照MFC消息映射的做法来构建一个结构良好，代码优美的框架，作为我们开发smartphone程序的基础。

　　3、选择File->New新建一个C++源文件First.cpp和C++头文件First.h，并同时加入First工程。

　　4、编写文件First.h和First.cpp如下，文件很短，关键的地方已经使用红色标注出来了，如果你有兴趣，可手工敲入下面的代码，以加深你对这个基本过程的了解。

//===============================================================
// first.h 文件

// 避免头文件的重复包含
#ifndef _CHUYUNFENG_FIRST_H_
#define _CHUYUNFENG_FIRST_H_

// 计算需要处理的消息数目
#define MSG_NUM(x) (sizeof(x) / sizeof(x[0]))

// 整个程序的消息映射结构
typedef struct tagMSG_MAP_MAIN
{
UINT nMsg;
LRESULT (*pMsgProcess)(HWND, UINT, WPARAM, LPARAM);

}MSG_MAP_MAIN_S;

// 命令消息(WM_COMMAND)的消息映射结构，因为两者处理函数
// 的参数不同，调用场合也不同，因此这里需要单独建立，类似的有
// WM_NOTOFY消息，本程序中不涉及
typedef struct tagMSG_MAP_CMD
{
UINT nMsg;
LRESULT (*pMsgProcess)(HWND, WORD, HWND, WORD);

}MSG_MAP_CMD_S;

// 声明程序中用到的全局变量
extern const TCHAR g_szAppName[];
extern HINSTANCE g_hInstance;
extern HWND g_hMainWnd;
extern const MSG_MAP_MAIN_S g_mainMsg[];
extern const MSG_MAP_CMD_S g_cmdMsg[];

// 窗口处理函数原型
LRESULT CALLBACK mainWndProc(HWND, UINT, WPARAM, LPARAM);

// 需要处理的主框架消息定义函数
LRESULT onCreate(HWND hWnd, UINT wMsg, WPARAM wParam, LPARAM lParam);
LRESULT onPaint(HWND hWnd, UINT wMsg, WPARAM wParam, LPARAM lParam);
LRESULT onCommand(HWND hWnd, UINT wMsg, WPARAM wParam, LPARAM lParam);
LRESULT onDestroy(HWND hWnd, UINT wMsg, WPARAM wParam, LPARAM lParam);

// 需要处理的菜单命令消息定义函数
LRESULT onAbout(HWND hWnd, WORD idItem, HWND hwndCtl,WORD wNotifyCode);
LRESULT onExit(HWND hWnd, WORD idItem, HWND hwndCtl,WORD wNotifyCode);

#endif //_CHUYUNFENG_FIRST_H_

//=================================================================
// First.cpp 文件

#include
#include
#include
#include "resource.h"

#include "First.h"

// 定义程序中用到的全局变量
const TCHAR g_szAppName[] = _T("First");
HINSTANCE g_hInstance;
HWND g_hMainWnd;

// 程序中需要处理的消息映射,如果要增加,在此处增加一
// 对{msgID,onMsgProcFun},然后写对应的消息处理函数即可。
const MSG_MAP_MAIN_S g_mainMsg[] =
{
{WM_PAINT, onPaint},
{WM_COMMAND, onCommand},
{WM_CREATE, onCreate},
{WM_DESTROY, onDestroy}
};

//此处放置需要处理的命令消息
const MSG_MAP_CMD_S g_cmdMsg[] =
{
{IDM_ABOUT, onAbout},
{IDM_EXIT,onExit}
};


//=================================================================
// WinMain，入口函数，由操作系统调用
//=================================================================
int WINAPI WinMain (HINSTANCE hInstance, HINSTANCE hPrevInstance,
LPWSTR lpCmdLine, int nCmdShow)
{
WNDCLASS wc;
MSG msg;

// 注册窗口类
wc.style = 0; // 窗口样式
wc.lpfnWndProc = mainWndProc; // 回调函数
wc.cbClsExtra = 0; // 扩展的类数据
wc.cbWndExtra = 0; // 扩展的窗口数据
wc.hInstance = hInstance; //实例句柄
wc.hIcon = NULL, // 图标
wc.hCursor = NULL; // 鼠标
wc.hbrBackground = (HBRUSH) GetStockObject (WHITE_BRUSH);
wc.lpszMenuName = NULL; //菜单
wc.lpszClassName = g_szAppName; //窗口类的名字

if ( 0 == RegisterClass (&wc))
return 0; //注册窗口类失败

// 建立并显示程序主窗口
g_hInstance = hInstance;
g_hMainWnd = CreateWindow (g_szAppName, // 窗口类
_T("第一个演示程序"), //窗口标题
WS_VISIBLE, //样式
CW_USEDEFAULT, // x坐标
CW_USEDEFAULT, // y 坐标
CW_USEDEFAULT, // 初始宽度
CW_USEDEFAULT, // 初始高度
NULL, // 父窗口
NULL, //菜单，必须为NULL，WINCE窗口不支持菜单。
hInstance, // 实例
NULL); //建立参数的指针，用于WM_CRATE消息期间。

if ( !IsWindow (g_hMainWnd)) //建立窗口失败
return 0;

ShowWindow (g_hMainWnd, nCmdShow);
UpdateWindow (g_hMainWnd);

// 消息循环
while (GetMessage (&msg, NULL, 0, 0))
{
TranslateMessage (&msg);
DispatchMessage (&msg);
}

// WinMain函数成功则返回退出消息的wParam
return msg.wParam;
}

//======================================================================
// MainWndProc，窗口过程，回调函数，由操作系统调用
//======================================================================
LRESULT CALLBACK mainWndProc (HWND hWnd, UINT wMsg, WPARAM wParam, LPARAM lParam)
{
// 处理我们需要处理的消息
int i;
for (i = 0; i < MSG_NUM(g_mainMsg); i++)
{
if (wMsg == g_mainMsg[i].nMsg)
return (*g_mainMsg[i].pMsgProcess)(hWnd, wMsg, wParam, lParam);
}

// 有编写对应的函数则调用默认的
return DefWindowProc (hWnd, wMsg, wParam, lParam);
}

//=================================================================
// onCreate,WM_CREATE 消息的处理函数
//=================================================================
LRESULT onCreate(HWND hWnd, UINT wMsg, WPARAM wParam, LPARAM lParam)
{
SHMENUBARINFO mbi;

// 初始化menubar结构
memset(&mbi, 0, sizeof(SHMENUBARINFO));
mbi.cbSize = sizeof(SHMENUBARINFO); // 必须填充
mbi.hwndParent = hWnd;
mbi.nToolBarId = IDR_MAIN_MENUBAR;
mbi.hInstRes = g_hInstance;

// 建立menubar控制
if (!SHCreateMenuBar(&mbi))
{
MessageBox (hWnd, _T("建立menubar失败"),
g_szAppName, MB_OK);
DestroyWindow(hWnd);
}

//
return 0;
}

//=================================================================
// onPaint,WM_PAINT 消息的处理函数
//=================================================================
LRESULT onPaint(HWND hWnd, UINT wMsg, WPARAM wParam, LPARAM lParam)
{
PAINTSTRUCT ps;
HDC hdc;

RECT rtClient;
GetClientRect (hWnd, &rtClient);

// 开始绘图
hdc = BeginPaint (hWnd, &ps);

// 在屏幕中间写一句话
DrawText (hdc, _T("Smartphone第一个程序^_^"), -1,
&rtClient, DT_CENTER | DT_VCENTER | DT_SINGLELINE);

// 结束绘图
EndPaint (hWnd, &ps);

return 0;
}

//=================================================================
// onCommand,WM_COMMAND 消息的处理函数
//=================================================================
LRESULT onCommand(HWND hWnd, UINT wMsg, WPARAM wParam, LPARAM lParam)
{
//处理我们需要处理的命令消息
WORD wID, wNotifyCode;
HWND hwndCtl;
int i;

// 解析出参数
wID = (WORD) LOWORD (wParam);
wNotifyCode = (WORD) HIWORD (wParam);
hwndCtl = (HWND) lParam;

// 寻找消息映射结构，调用对应的消息处理函数
for (i = 0; i < MSG_NUM(g_cmdMsg); i++)
{
if (wID == g_cmdMsg[i].nMsg)
return (*g_cmdMsg[i].pMsgProcess)( hWnd, wID, hwndCtl,wNotifyCode);
}
return 0;
}

//=================================================================
// onDestroy,WM_DESTROY 消息的处理函数
//=================================================================
LRESULT onDestroy (HWND hWnd, UINT wMsg, WPARAM wParam, LPARAM lParam)
{
DestroyWindow(hWnd);
return 0;
}

//=================================================================
// onAbout,菜单消息IDM_ABOUT处理函数
//=================================================================
LRESULT onAbout(HWND hWnd, WORD idItem, HWND hwndCtl,WORD wNotifyCode)
{
TCHAR szAboutMsg[] = _T("\n\n\n\t\tFirst\n\tfor smartphone 2003");
MessageBox(hWnd,szAboutMsg,_T("关于First"),MB_OK);
return 0;
}

//=================================================================
// onExit,菜单消息IDM_Exit处理函数
//=================================================================
LRESULT onExit(HWND hWnd, WORD idItem, HWND hwndCtl,WORD wNotifyCode)
{
if ( IDOK == MessageBox(hWnd, _T("真的要退出这个程序？"),
_T("退出确认"),MB_OKCANCEL | MB_ICONASTERISK) )
{
PostQuitMessage(0);
}

return 0;
}
　　关键代码分析：

　　代码中最关键的地方就是使用消息映射的办法来处理消息，这主要体现在定义消息映射结构和在窗口处理函数以及命令消息处理函数中进行消息分发上面，实现可以参看代码中的红色部分。

　　5) 在框架上的开发。

　　我们构建这个基本框架，是想使用这个框架进行后续开发的，上述代码中的绿色部分标示出了增加WM_PAINT消息处理的整个过程：

　　1、 在.h文件中声明消息处理函数；

　　2、 在.c文件的消息映射结构中增加一个消息映射对；

　　3、 然后，在.c文件中实现此函数的功能即可。

　　3、第二步：建立菜单

　　现在，我们来建立左右软键对应的菜单。

　　1) 确认使用中文资源

　　因为要使用资源，因此，首先确认我们项目所使用的是中文资源：选择菜单项 Project ->Settings…,设置资源为中文：


　　2) 增加resource script文件并修改Evc的一个bugs

　　菜单File -> new ->增加一个resource script文件，名字为first.rc。


　　当你在IDE中打开这个RC文件时，会发现一个错误，这是eMbedded C++处理smartphone上的一个bugs，微软对此的修正方案是，提供了一个newRes.h的文件，你将First.rc中的#include "afxres.h"修改为 #include "newRes.h"即可，newRes.h文件你可以自行在程序目录下建立，下面是newRes.h文件内容：

#ifndef __NEWRES_H__
#define __NEWRES_H__

#if !defined(UNDER_CE)
#define UNDER_CE _WIN32_WCE
#endif

#if defined(_WIN32_WCE)
#if !defined(WCEOLE_ENABLE_DIALOGEX)
#define DIALOGEX DIALOG DISCARDABLE
#endif
#include
#define SHMENUBAR RCDATA
#if defined(WIN32_PLATFORM_WFSP) && (_WIN32_WCE >= 300)
#include
#define AFXCE_IDR_SCRATCH_SHMENU 28700
#else
#define I_IMAGENONE (-2)
#define NOMENU 0xFFFF
#define IDS_SHNEW 1

#define IDM_SHAREDNEW 10
#define IDM_SHAREDNEWDEFAULT 11
#endif // _WIN32_WCE_PSPC
#define AFXCE_IDD_SAVEMODIFIEDDLG 28701
#endif // _WIN32_WCE

#ifdef RC_INVOKED
#ifndef _INC_WINDOWS
#define _INC_WINDOWS
#include "winuser.h" // extract from windows header
#include "winver.h"
#endif
#endif

#ifdef IDC_STATIC
#undef IDC_STATIC
#endif
#define IDC_STATIC (-1)

#endif //__NEWRES_H__
　　3、 增加menubar资源：

类型 ID Caption Menubar IDR_MAIN_MENUBAR   Left menu IDM_ABOUT 关于 Right menu IDM_OPTION 选项 Right menu subitem 1 IDM_ABOUT 关于（和左建菜单是同一个ID） Right menu subitem 2 IDM_EXIT 退出
　　这是first.rc的内容，大家可以看到，与我们桌面windows下的资源脚本文件相差无几。

///////////////////////////////////////////////////////////////////////////
// first.rc ， resource script for first.

#include "resource.h"

#define APSTUDIO_READONLY_SYMBOLS
/////////////////////////////////////////////////////////////////////////////
//
// Generated from the TEXTINCLUDE 2 resource.
//
#include "newres.h"

/////////////////////////////////////////////////////////////////////////////
#undef APSTUDIO_READONLY_SYMBOLS

/////////////////////////////////////////////////////////////////////////////
// Chinese (P.R.C.) resources

#if !defined(AFX_RESOURCE_DLL) || defined(AFX_TARG_CHS)
#ifdef _WIN32
LANGUAGE LANG_CHINESE, SUBLANG_CHINESE_SIMPLIFIED
#pragma code_page(936)
#endif //_WIN32

#ifdef APSTUDIO_INVOKED
/////////////////////////////////////////////////////////////////////////////
//
// TEXTINCLUDE
//

1 TEXTINCLUDE DISCARDABLE
BEGIN
"resource.h\0"
END

2 TEXTINCLUDE DISCARDABLE
BEGIN
"#include ""afxres.h""\r\n"
"\0"
END

3 TEXTINCLUDE DISCARDABLE
BEGIN
"\r\n"
"\0"
END

#endif // APSTUDIO_INVOKED


/////////////////////////////////////////////////////////////////////////////
//
// Menubar
//

IDR_MAIN_MENUBAR MENU DISCARDABLE
BEGIN
MENUITEM "关于", IDM_ABOUT
POPUP "选项"
BEGIN
MENUITEM "关于", IDM_ABOUT
MENUITEM SEPARATOR
MENUITEM "退出", IDM_EXIT
END
END


/////////////////////////////////////////////////////////////////////////////
//
// Data
//

IDR_MAIN_MENUBAR SHMENUBAR DISCARDABLE
BEGIN
IDR_MAIN_MENUBAR, 2,
I_IMAGENONE, IDM_ABOUT, TBSTATE_ENABLED, TBSTYLE_AUTOSIZE,
IDS_MENUITEM40002, 0, NOMENU,
I_IMAGENONE, IDM_OPTION, TBSTATE_ENABLED,
TBSTYLE_DROPDOWN | TBSTYLE_AUTOSIZE, IDS_MENUITEM40007, 0, 1,
END


/////////////////////////////////////////////////////////////////////////////
//
// String Table
//

STRINGTABLE DISCARDABLE
BEGIN
IDS_MENUITEM40002 "关于"
IDS_MENUITEM40004 "x"
IDS_MENUITEM40007 "选项"
END

#endif // Chinese (P.R.C.) resources
/////////////////////////////////////////////////////////////////////////////



#ifndef APSTUDIO_INVOKED
/////////////////////////////////////////////////////////////////////////////
//
// Generated from the TEXTINCLUDE 3 resource.
//


/////////////////////////////////////////////////////////////////////////////
#endif // not APSTUDIO_INVOKED
　　4、 在onCreate函数中建立此菜单

//==================================================================
// onCreate,WM_CREATE 消息的处理函数
//==================================================================
LRESULT onCreate(HWND hWnd, UINT wMsg, WPARAM wParam, LPARAM lParam)
{
SHMENUBARINFO mbi;

// 初始化menubar结构
memset(&mbi, 0, sizeof(SHMENUBARINFO));
mbi.cbSize = sizeof(SHMENUBARINFO); // 必须填充
mbi.hwndParent = hWnd;
mbi.nToolBarId = IDR_MAIN_MENUBAR;
mbi.hInstRes = g_hInstance;

// 建立menubar
if (!SHCreateMenuBar(&mbi))
{
　MessageBox (hWnd, _T("建立menubar失败"), g_szAppName, MB_OK);
　DestroyWindow(hWnd);
}

// 确定menubar的位置，这些语句是可选的
RECT rect, rectDesk;
int cx, cy;
GetWindowRect (mbi.hwndMB, &rect);
GetWindowRect (GetDesktopWindow (), &rectDesk);
cx = rectDesk.right-rectDesk.left;
cy = (rectDesk.bottom - rectDesk.top) - (rect.bottom - rect.top);
SetWindowPos (hWnd, NULL, 0, 0, cx, cy, SWP_NOMOVE | SWP_NOZORDER);

return 0;
}
　　4、第三步：实现菜单功能

　　1) 实现 "退出"菜单项的功能

　　步骤如下：

　　·在first.h中增加函数原型定义：

LRESULT onExit(HWND hWnd, WORD idItem, HWND hwndCtl,WORD wNotifyCode);
　　·在first.cpp中实现此函数：

LRESULT onExit(HWND hWnd, WORD idItem, HWND hwndCtl,WORD wNotifyCode)
{
　if ( IDOK == MessageBox(hWnd, _T("真的要退出这个程序？"),_T("退出确认"),MB_OKCANCEL | MB_ICONASTERISK) )
　{
　　PostQuitMessage(0);
　}
}
　　·在g_cmdMsg中增加相应的消息映射入口：

const CMD_MSG_MAP_S g_cmdMsg[] =
{
　{IDM_EXIT, onExit}
};
　　2) 实现"关于"菜单项功能

　　步骤如下：

　　·在first.h中增加函数原型定义：

LRESULT onAbout(HWND hWnd, WORD idItem, HWND hwndCtl,WORD wNotifyCode);
　　·在first.cpp中实现此函数：

LRESULT onAbout(HWND hWnd, WORD idItem, HWND hwndCtl,WORD wNotifyCode)
{
　TCHAR szAboutMsg[] = _T("\n\n\n\t\tFirst\n\tfor smartphone 2003");
　MessageBox(hWnd,szAboutMsg,_T("关于First"),MB_OK);

　return 0;
}
　　·在g_cmdMsg中增加相应的消息映射入口：

const CMD_MSG_MAP_S g_cmdMsg[] =
{
　{IDM_ABOUT, onAbout}
};
　　5、编译运行

　　首先要设置工程的编译选项，在开发过程中，我们将编译成模拟器的Debug版本来调试。


　　6、模拟器的使用

　　因为程序在模拟器上进行运行调试，因此，这里来谈一下对模拟器的操作：


　　大家知道，smartphone手机可以使用外置的存储卡来进行扩充，一般采用SD卡或者Mini SD卡，因为手机本身的存储空间非常有限，因此，我们一般会把资源、程序等放在存储卡上。Folder Sharing的作用就是让你指定一个PC机上的目录，然后，模拟器会把这个目录内容解释成你的存储卡内容。


　　其他的菜单选项很简单了，"Hard Reset…"相当于重新启动设备，"Soft Reset…"相当于重新启动Smartphone操作平台，"Shut Down"..是关闭模拟器，这些功能在你调试程序的时候会常常用到。

　　程序安装

　　现在例子程序已经完成了，我们已经可以在编译器上进行运行了，要做的事情还剩下最后一件，那就是做一个安装程序将我们的软件安装到我们的Smartphone设备上去。

　　1、绿色安装

　　我们构建的例子程序很小，只有一个文件，也不涉及到修改注册表等操作，因此，我们完全可以采用如下的方法进行绿色安装：

　　·将例子程序first.exe拷贝到smartphone设备的某个目录下。

　　·使用手机内置的文件管理器找到此文件，为它在smartphone的启动菜单中建立一个快捷方式，这样你就可以在开始菜单中找到这个程序。

　　·OK，现在你可以使用文件管理器或者启动菜单来执行这个程序了

　　2、扩展安装

　　采用上面的方法确实可以解决我们的问题，但在稍微复杂一点的场合下，比如，程序有多个分散的文件，程序需要写注册信息或者需要提供安全签名等，使用上面的方法就力不从心了。限于篇幅和本文定位，这部分内容将在我的另一篇文章中专门讲述。