一个应用在不同类型BREW 手机上的移植主要是处理手机之间的差异性,这里的差异性包括硬件差异性和软件差异性。硬件差异性是指手机自身的内存和存储空间大小,屏幕尺寸和色深,键盘布局以及手机中的特殊硬件的支持(如照相机,游戏手柄等)。软件差异性包括BREW的版本,手机软件编译器的版本,一些多媒体编解码器的异同,以及对某些BREW API是否支持等等。由此可见,了解运营商所制定的手机相关规范对移植BREW应用是非常有益的。
针对手机的硬件差异性,为了减少应用移植中的工作,可以在应用中采用自适应的方法。每个手机都有各自的类型标识——平台标识,如果应用自身根据平台标识以及相应硬件信息动态加载相应的资源,无疑可以实现某些应用的零工作量移植。获得手机平台标识和相关硬件信息的方式之一是使用ISHELL_GetDeviceInfo()和ISHELL_GetDeviceInfoEx()。
ISHELL_GetDeviceInfo()可以在 AEE层中查询有关手机性能的信息,例如所支持的 RAM 总量、屏幕显示等其它项目。要获取 AEEDeviceInfo结构中的 dwNetLinger 和 dwSleepDefer值,在调用此函数之前,wStructSize 必须等于sizeof(AEEDeviceInfo)。其中AEEDeviceInfo是这样一个数据结构:
typedef struct
{
uint16 cxScreen; // 实际屏幕大小 (像素)
uint16 cyScreen; // 实际屏幕大小 (像素)
uint16 cxAltScreen; // 第二显示屏幕的屏幕大小
uint16 cyAltScreen; // 第二显示屏幕的屏幕大小
uint16 cxScrollBar; // 标准滚动条的宽度
uint16 wEncoding; // 字符集编码 (AEE_ENC_UNICODE, ....)
uint16 wMenuTextScroll; // 应该用于自动滚动的毫秒
uint16 nColorDepth; // 色深 (1表示黑色,2表示灰色等)
EmptyEnum unused2;
uint32 wMenuImageDelay; // 应该用于影像延迟的毫秒
uint32 dwRAM; // 已安装的 RAM 总量 (RAM)
flg bAltDisplay:1; // 设备具有备选显示屏幕 (寻呼机)
flg bFlip:1; // 设备为翻盖电话
flg bVibrator:1; // 安装了振动器
flg bExtSpeaker:1; // 安装了外部扬声器
flg bVR:1; // V支持语音识别
flg bPosLoc:1; // 支持定位
flg bMIDI:1; // 支持 MIDI 文件格式
flg bCMX:1; // 支持 CMX 音频
uint32 dwPromptProps; // 默认提示属性
uint16 wKeyCloseApp; // 关闭当前应用的按键
uint16 wKeyCloseAllApps; // 关闭所有应用的按键 (默认为 AVK_END)
uint32 dwLang; // 由 Resource Loader 使用 (见下方的 AEE_LNG_XXX)
//
// 注:要使用以下各字段,必须先将结构的
// wStructSize 填用才能将其传送到 GetDeviceInfo调用
//
uint16 wStructSize; // 该结构的大小1
uint32 dwNetLinger; // PPP 振铃定时器 (毫秒)
uint32 dwSleepDefer; // 激活的非睡眠模式 (毫秒)
uint16 wMaxPath; // 文件路径最大长度
uint32 dwPlatformID; // 平台 ID
} AEEDeviceInfo;
ISHELL_GetDeviceInfoEx()用于获取有关设备的特定信息(AEEDeviceItem)。此函数使用 ID 指定所需的信息,返回时在缓冲区中包含对应的信息。这些ID所表示的含义如表15-2所示。
ID的名称 |
含义说明 |
AEE_DEVICEITEM_CHIP_ID |
标识芯片组 ID 的字符串 |
AEE_DEVICEITEM_MOBILE_ID |
标识手持设备的移动 ID 的一个 ASCII 字符串 |
AEE_DEVICEITEM_AMR_VOCODER_SUPPORT |
是否支持 AMR (Adaptive Multi-Rate) 声码器 |
AEE_DEVICEITEM_EVRC_VOCODER_SUPPORT |
是否支持 EVRC(增强型变速率编码)声码器 |
AEE_DEVICEITEM_IS96_VOCODER_SUPPORT |
否支持 QCELP-IS96(8K)(Qualcomm 码激励线性预测编码)声码器 |
AEE_DEVICEITEM_IS96A_VOCODER_SUPPORT |
否支持 QCELP-IS96A(8K)(Qualcomm 码激励线性预测编码)声码器 |
AEE_DEVICEITEM_IS733_VOCODER_SUPPORT |
是否支持 QCELP-IS733(Qualcomm 码激励线性预测编码)声码器 |
AEE_DEVICEITEM_SMV_VOCODER_SUPPORT |
是否支持可选择模式的声码器 |
AEE_DEVICEITEM_SYS_COLORS_DISP1 AEE_DEVICEITEM_SYS_COLORS_DISP2 AEE_DEVICEITEM_SYS_COLORS_DISP3 AEE_DEVICEITEM_SYS_COLORS_DISP4 |
返回与特定显示屏幕关联的系统颜色列表 |
AEE_DEVICEITEM_DISPINFO1 AEE_DEVICEITEM_DISPINFO2 AEE_DEVICEITEM_DISPINFO3 AEE_DEVICEITEM_DISPINFO4 |
返回特定显示屏幕的相关信息 |
AEE_DEVICEITEM_CARRIER_ID |
标识手持设备的运营商 ID 的一个 uint32 值 |
AEE_DEVICEITEM_SIDHASH |
返回手持设备的支付帐户的一个散列。 可用于确定是否已更换了支付帐户,例如在调换了 RUIM 卡时。 请注意,不会返回具体的帐号,而只是返回一个帐户字符串的散列。 |
AEE_DEVICESTATE_KEYS_PRESSED |
返回处于按下状态的按键的值 |
AEE_DEVICESTATE_FLIP_OPEN |
在设备翻盖处于打开状态时返回 TRUE,否则返回 FALSE |
AEE_DEVICESTATE_HEADPHONE_ON |
如果设备耳机是打开的,返回 TRUE,否则返回 FALSE |
AEE_DEVICESTATE_KEYGUARD_ON |
如果设备的键盘是打开,将返回 TRUE,否则返回 FALSE |
AEE_DEVICESTATE_SPEAKER_ON |
如果设备的扬声器为打开则返回 TRUE,否则返回 FALSE |
AEE_DEVICEITEM_USER |
OEM 定义项目的起始点 |
表 15-2:可以用ISHELL_GetDeviceInfoEx()获取的有关设备的特定信息
根据AEEDeviceInfo和AEEDeviceItem中的信息,应用可以做到动态加载资源文件。当然这些资源信息也可以保存在服务器上,应用程序通过网络通信的方式获得这些资源数据,从而完成一个应用在不同手机上的适配。
如果某些手机不支持某些接口,应用程序可以通过判断该接口是否创建成功获得该信息。例如在内存没有问题的情况下,创建IPosDet接口失败,很可能是由于该手机不支持定位功能造成的。这时,应用程序就应该不提供定位功能,从而成为只具备浏览查询功能的一个LBS应用。
如果是两台手机对同一接口的功能存在差异(一般出现在IRingerMgr或者IAddrBook),这时需要应用程序多做一些工作。例如采用一个配置文件来定义地址簿或者铃声目录中的域,应用程序在启动时根据手机信息来读取配置文件,这样就能够进一步弥补手机间的差异进而很好的实现移植了。