BREW™ SDK入门篇(一)

本文介绍了使用BREW SDK开发应用的预备知识,包括所需环境。重点介绍了三款重要工具:BREW应用程序向导可创建项目框架;BREW MIF编辑器用于创建模块信息文件;BREW资源编辑器可创建应用程序资源。还提及了开发中的文件命名、ID设置、资源保存路径等要点。
第一部分 -  预备知识

在跟随本文学习相关知识点之前,你需要以下环境:

Microsoft Visual C++ 6.0®(或更高版本)

1.1版的BREW SDK(或更高版本).

要了解系统最低要求,和获得更细节的资料,SDK的安装指导,请查看SDK 1.1的README文件。注意,在这里我假设你已经读过了本系列中之前的一篇文章,“什么是BREW”。

在以下的例子中,你需要知道,文件名是非常重要的。确切的说,应用模块的信息文件(.mif文件)必须与该模块的dll文件同名。基本上,用BREW你需要选择一个名字并且自始至终使用它。当你读完这篇文章后,你会很清楚地知道.mif文件后缀的重要性。

BREW应用程序向导

1.1版的SDK包括了一个BREW应用程序向导(BREW Application Wizard™),这在1.0版本里是没有的。这个应用程序向导设置了大部分的可应用的项目选项,并且为BREW应用程序生成最小的框架代码,该向导假设你将用C进行开发。项目的设置和初始代码与1.0版的SDK兼容。在US,目前有4款BREW话机,两款是安装了1.0版本的BREW AEE(Application Execution Environment),另外两款是1.1版本的。为了保证对这些以及以后发布的话机兼容,建议你采用1.0版的SDK开发将来准备商业化的项目。在本课程中,你可以用SDK1.1来生成基本的项目,然后将应用程序相关的文件移至安全位置,反安装SDK 1.1,下载并安装SDK1.0,完成剩余的开发。这样你可以保证项目是对SDK1.0兼容的,并且能够运行在当前和以后的话机中。


安装完SDK后,打开Visual C++点击“文件>新建”,打开新建对话框,选中“项目“选项卡。选择BREW Application Wizard,确认位置栏输入的是/yourBREWdir/Examples(BREW SDK安装目录下的Examples目录),在工程栏输入“helloBREW”作为项目名称。点击OK开始BREW应用程序向导。对于最简单的应用,我们不需要这个对话框里所涉及到的任何一项,所以在这里我们不作选择。如果我们需要加入这些项的支持,必须明确一点:仅仅选择这个对话框里的选项可能是不够的。这些多选框为的是确保在向导生成的代码中包含了合适的接口头文件。应用程序需要在BREW MIF Editor™的常规选项卡中拥有相应的优先级。MIF编辑器我们将在下面讨论。以后的文章里我们会介绍相关界面,将详细讨论这里提到的优先级。


MIF 编辑器

在向导的第二步,有一个“Note”提醒我们需要为BREW应用程序创建一个模块信息文件(.mif)。点击写有“MIF Editor”的按钮启动BREW MIF编辑器。


在MIF编辑器主对话框的小程序选项卡上,点击新建小程序按钮来打开如图3显示的生成ClassID对话框(在本文中“小程序”和“应用程序”指的是同一个事物,可能交替用到)。注意classID必须是唯一的。名称框里,我们输入“helloBrew”作为类名。在快速查看BREW安装目录下inc目录(/yourBREWdir/inc/)中的头文件:AEEClassIDS.h、AEEUsageAppIDs.h和AEESampleAppIDs.h后,我们知道0x1234ABCD不会与SDK中包含的任何其它ID有冲突。于是我们在这里选择“本地”并在ClassID文本框中输入“1234ABCD”或者其他不会出现冲突的ID。如果今后需要做商业化的应用,必须从BREW开发者外联网获得全球唯一的ID。点击“生成”按钮,并在接下来的确认对话框中点击“是”以确定生成本地ClassID。

此时,MIF编辑器创建了一个BREW ID(.bid)文件。该文件只是简单的包括了刚才生成的本地ClassID的“#define”定义语句。在下面的文章里,我们必须确认“helloBREW.bid”文件被“helloBREW.c”源文件引用(#include)。图4显示的是BREW MIF编辑器的“小程序”选项卡。在名称中输入“Hello BREW”,小程序类型里选择“工具”。我们还没有给出图标文件。现在不要关闭MIF Editor,我们很快回来。

在我们的.mif文件里,将用到三个位图(.bmp)文件:一个大约为85×40象素,一个是26×26象素,还有一个缩略图是16×16象素。你可以用Windows附件中的画笔程序或者Visual Studio®中的资源编辑器来创建这几个位图。当然,你可以用任何你顺手的工具。(注:将这几个位图文件另存为256色的位图文件,否则无法在Emulator中显示。)

完成并保存这三张位图后,返回MIF编辑器,现在你可以在“图标”栏输入刚刚创建的26×26象素的图片。下一步,在MIF编辑器的小程序选项卡中点击“高级”按钮。这个对话框里要求你提供一个“图像”文件和“缩略图”文件。“图像”是85×40象素的那个文件,而“缩略图”是16×16的。这个例程即将应用于夏普(Sharp)Z800手机,这款手机有一个128×144象素的显示屏,可以显示最大为108×72象素的图像。注意这个最大值只适用于MIF编辑器中。基于SDK的IImage接口的图像尺寸仅受限于设备物理屏幕的尺寸。不同手机有不同的屏幕尺寸和最大图像尺寸。认证的BREW开发者可以在BREW外联网上获得详细的手机规格说明。要了解如何才能成为BREW认证开发者,请参考Qualcomm® BREW 网站.

题外话,如果你想在模拟器或者手机上显示动画,你可以创建更大的图片。在MIF编辑器里,你可以很简单地创建一个大图片,这个图片由多张水平方向排列、大小一致的帧组成。在任何时候,动画只显示1帧,这样,这张位图的总宽度可能大于设备的显示宽度。需要注意的是,为了让动画很好显示,位图的宽度必须正好是它高度的几倍。

现在我们已经创建了一个基本的模块信息文件,可以关闭MIF编辑器继续我们的探险。记住以前提过的要点,.mif文件必须跟应用程序的.dll文件同名。注意刚刚创建的“helloBREW.mif”文件必须拷贝至.../yourBREWdir/Examples/MIF/256Color/目录,这样AEE才能找到并且适当地初始化hellBREW应用程序。下一次,当我们在BREW应用程序向导生成的源代码中添加自己的代码并让应用在BREW模拟器上运行时,这一点变得尤其重要。

资源编辑器

大多数的应用程序需要字符串和图像资源,不要涉及一些由不同屏幕组成的用户接口。BREW的小程序资源文件(BREW Applet Resource )(.bar)就象你的应用程序存放这些资源文件的中央仓库。在本系列之后的文章里,我们将学习图像和用户接口资源。在这个介绍性的应用程序里,我们需要的只是一个包含了两个字符串的简单资源文件。我们将加载该文件,并在运行阶段显示出来。点击BREW程序组中的“资源编辑器”,运行BREW资源编辑器。图6显示的是输入了两个字符串后的资源编辑器。初始的,这个对话框右边的面板是空的。


要熟悉资源编辑器的所有细节,可以阅读SDK文档里的相关章节。现在右键点击左边面板,并选择“新建字符串…”,或者简单敲键盘快捷方式,ALT-S.将出现图7所示的对话框。按照图6中的内容填入对话框中的必填项。填完后,选择“文件”>“保存”或者在工具条上点击磁盘图标将BREW资源载体文件(BREW Resource Intermediate)(.bri)保存为“helloBREW.bri”。注意.bri文件都要用资源编辑器打开,进行修改。只要你创建或者编辑了应用程序的资源,就必须在完成后点击工具栏中的蓝色“Q”字样。这个操作将产生两个文件:“helloBREW.bar”和“helloBREW_res.h”。

你必须将生成的“helloBREW_res.h”文件拷到“.../yourBREWdir/examples/helloBREW”目录下,并且用#include语句在“helloBREW.c”文件中引用。将“helloBREW.bar”文件拷到“.../yourBREWdir/Examples/en/256Color/”下。在模拟器上运行的时候,helloBREW应用程序将以 “依据需要”为基础从 “helloBREW.bar”中访问字符串资源。在一个话机上,至少在大多数的不是太普通的情况下,一个应用不会需要并发地访问所有资源。这样,大的字符串、图像和用户接口元素可以转移到话机的内嵌文件系统(EFS)而不是放在非常昂贵的RAM里。另外,资源文件的概念使得应用国际化的过程也变得比较简单。

总结

在这篇文章里,我们介绍了3种重要的BREW SDK tools:BREW应用程序向导,BREW MIF编辑器,BREW资源编辑器。BREW应用程序向导创建了可以作为我们的BREW项目基础的框架。BREW MIF编辑器创建包括了项目的基本信息的模块信息文件(.mif),其中包括应用程序的Unique class ID、应用类型以及三个图标对应的图象文件。BREW资源编辑器用于创建应用程序资源。这些资源将被编译到BREW小程序资源文件(.bar)文件中,当应用程序有请求时这个文件将为其提供资源。下一次,我们将对应用程序向导生成的“helloBREW.c”文件进行处理,加入我们自己的代码以实现简单的功能,并且用BREW模拟器运行这个应用程序。同时我们还将看到如何用Visual C++结合BREW模拟器去调试一个BREW的应用程序。

© Copyright 2002, Golden Creek Software Inc.

作者:By Murray Bonner
认识手机的的存储区间 11  手机系统的组成 11  NOR 11  RAM 12  NAND 12  什么是BootLoader? 12  BootLoader 12  引导系统启动 13  下载BIN文件 13  关机充电 13  如何下载BootLoader 13  应用BIN数据区存在哪里? 13  BIN文件数据区 13  般文件数据保存在哪里? 13  EFS文件系统数据。 13  NAND的数据存储区 13  USB盘区 14  软件开发人员需要做的工作 14  开发人员的工作流程 14 安装开发环境 14  安装VC6++开发工具 14  安装BREW3.15的开发环境 15  安装BUIW开发包 15  设备文件 15  环境变量 16  安装ARM编译器 16  安装调试工具 16  安装其它编译工具 16  安装USB驱动程序 16 应用基本规范 16  应用名称规范 17  应用名称 17  现在的目录状况 17  提示 17  模拟器的dll 17  dll应该小写 17  提示 18  mif文件和资源文件名称 18  mif文件 18  提示 18  应用的目录规范 18  级目录 18  二级目录 18  注意 19  应用的.c和.h文件 19  文件名称格式 19  文件名称长度 19  文件内容 19  项目文件 19  开发环境的目录宏定义和环境变量定义 20  开发环境 20  错误的开发方式 20  如何设置开发环境 21  应用中的测试窗口 22  功能测试窗口 22  不显示功能窗口 22 开始应用开发 22  新建应用 22  使用VC6++向导 22  手工修改项目文件 23  BID和MIF文件 23  创建BID文件 23  定义宏名称和CLSID值 23  模拟器mif文件的作用 24  创建应用的mif文件 24  创建扩展对象的mif文件 26  通过mif文件设置应用或者对象是否可见 26  编译mif文件 27  VC编译应用 27  必须去掉警告信息 27  区分调试环境和手机环境 27  代码检查 28  设置模拟器应用 28  设置设备文件 29  模拟器调试应用 30  应用开发基本问题(初学者问答) 31  为什么启动不了应用 31  为什么创建对象总是失败 31 程序架构基本规范 31  程序结构标准化的需要 31  主程序结构不合理 31  窗口参数结构传递不合理 32  应用释放所有窗口过程不合理 33  主程序数据结构 34  窗口独立数据结构 34  窗口间参数传递 34  程序结构图示 34 数据结构规范 36  数据结构名称定义 36  结构的名称 36  公共的数据结构 36  曾经的问题 36  数据结构中内存注意事项 37  中英文版本内存不样。 37  大数据量时内存重复使用问题 37 代码编码规范(简要) 37  编码基本事项 37  示例 38  调试信息问题 40  DBGPRINTF调试信息 40  写文件调试信息 40  调试信息不应该放的地方 40 程序内存和堆栈 41  程序总的可用内存 41  总的内存 41  误区 41  内存需求空间检查 41  应用需求内存检查 41  接口需求内存检查 41  函数内栈空间问题和错误rex.c 841 42  著名的841错误 42  使用数组的情况 42  数组改用指针 42  使用异步消息 42  入参使用指针 42  参数错误例子 43 中英文版本资源规范 43  版本目录和资源ID 43  版本资源文件 43  资源ID 43  载入过程 43  加速载入过程 44  调试环境和手机环境的资源 44  应用直接替换 44  OEM层替换 44  编译到BIN文件 44  下载到手机目录 45  优缺点 45  资源不可采用的方式 45  错误的资源处理方式 45  资源载入失败(ISHELL_LoadResString)现象。 46  文件路径错误。 46  数据缓冲区内存分配太小。 46  系统内部解析错误。 47 程序CLSID规范 48  CLSID是什么? 48  CLSID的定义 48  CLSID和BID文件的位置 48  应用引用CLSID 49  CLSID错误的做法 49 窗口和事件处理 49  应用程序组成和事件处理 49  基本组成 49  窗口消息和事件 50  事件传递过程 50  创建根窗口(ROOTFORM) 50  创建根窗口 50  释放根窗口 51  释放根窗口和注意事项 51  建议 51  白屏问题 51  白屏闪现问题 51  解决白屏问题 51  错误的解决方式 51  创建窗口 52  窗口和根窗口的关系 52  创建窗口对象 52  释放窗口 53  窗口处理 53  设置窗口处理函数(XXX_HandleEvent)和关闭窗口处理函数(XXX_FormDelete) 53  把窗口(FORM)加入根窗口(ROOTFORM) 54  把窗口从根窗口(ROOTFORM)移出来 54  窗口函数处理规范 55  窗口事件处理示例 56  窗口的其它事件 57 控件和事件处理 58  控件列表 58  控件、容器和窗口关系 59  与WINDOWS同类控件的区别 60  控件的基本属性 60  创建控件和使用控件 60  列表控件(LIST)使用和示例 60  容器控件(IXYCONTAINER) 65  比例容器 67  VIEWPORT控件 68  网格控件(GRID) 68  按钮(非标准) 68  显示图片控件 70  静态文本控件 70  TEXT控件 71  滚动条控件 73  菜单控件 73  CheckBox控件 73  TAB控件 73  Radio控件 73  如何把CheckBox和Static控件捆绑起 75  引用计数问题。 75  认识引用计数 75  为什么这么强调引用计数 75  哪些操作增加了引用计数 76  哪些窗口减少了引用计数 79  替换控件默认函数 81  如何让静态控件响应焦点事件 82  控件响应点击事件的前提 82  如何修改默认函数 82  处理事件 82  焦点和5向键顺序 83  控件的焦点 83  键盘操作规则 83  5向键顺序 83  如何创建个自定义控件 84 应用窗口规范 84  正常窗口 84  大小 84  按钮位置 84  应用菜单 84  编辑菜单 84  进度条窗口 84  进度条窗口的关闭和任务取消 84  进度条标题 84  内容或者进度显示 84  窗口大小 85  进度条按钮大小 85  进度条窗口的错误现象 85  半屏幕窗口 85  位置 86  按钮位置 86  全屏窗口 86  哪些应用使用了全屏窗口 86  设置全屏窗口 86  全屏窗口规范 86  应用内部 86  协同应用 86 程序<关于>版本号管理规范 86 程序版权规范 86  版权 86  作者和修改内容 87 程序划屏处理规范 87  135度斜线线划屏 87  90度斜线线划屏(改变私密状态) 87  应用该如何处理收到的私密消息 87 程序异常处理 88  程序异常意识 88  内存没释放 88  内存不足的异常 88  用户强制关闭应用的异常(AVK_END) 88  资源数据错误的异常 88  用户数据错误的异常 89  使用goto处理异常 89  正确使用goto语句 89  不要滥用goto语句 89  异常的提示信息 89  准确标题信息 89  准确的内容提示 89  准确的图标 89 程序互斥规范 90 程序自动化编译规范 90 程序宏定义规范 90  应用内部的宏定义 90  应用间的宏定义 91  宏定义的名称 91 调试信息规范 91  日志文件 91  日志文件的目录和大小。 91  否写日志 91  正式版本 91  QDXM调试信息 91  不要频繁打印调试信息 91  使用中文 91  内容准确不罗嗦 92 全局变量和__inline函数 92  全局变量 92  慎用全局变量 92  命名全局变量 92  修改全局变量 92  __inline函数 92  优缺点 92  哪些函数建议使用__inline 92 大数据量处理CPU时间限制 92  为什么不能使用FOR、WHILE连续处理大数据量 93  CPU时间限制 93  提示 93  使用ISHELL_POSTEVENT消息处理。 93  消息机制 93  处理消息位置 93  消息丢失问题 93  性能问题 93  休眠状态 93  使用ISHELL_SETTIMER 93  休眠挂起状态 94  解决系统休眠 94  取消定时器 94  定时器间隔周期 94  周期和暴力测试问题 94  ISHELL_Resume函数处理重复执行的过程 94  效率问题 94  休眠问题 94  取消回调 94  暴力测试问题 95  如何使用 95 带窗口的接口或对象规范 95  单实例对象 95  单实例对象优缺点 96  优点 96  缺点 96  多实例对象 97  多实例对象优缺点 97  数据安全 97  内存需求较大 97  应用程序更为复杂 97  更多的异常处理 97  释放更为麻烦 98 多实例对象的标准规范: 98  标准创建接口 98  标准Release接口 98  能被动态移出(_REMOVE) 98  能动态移出所有窗口 98  不能只移出个顶部窗口 98  多窗口Release 98  对象内部有多个窗口 98  对象中还创建其它对象 98  内存 99  应用检查内存 99  对象需要检查内存 99  对象示例 99  应用程序和对象创建前 100  应用创建了对象后 100  把所有窗口都释放 100  先释放对象 100  释放函数示例 101  释放函数该处理过程 101  对象的数据 102  误区 102 ARM编译项 102  如何在把应用编译入手机BIN文件 102  把应用放到编译目录下 102  在OEMModTableExt.c文件中增加 102  在incpath.min文件中增加 102  在dmss_qsc60x0.mak文件中增加: 102  在dmss_objects.min文件中增加: 102  在dmss_rules.min中增加, 103  如何修改min文件 103  min文件的意义 103  增加C文件 103  注意事项 103  nand和nor的区别 103  设置文件系统区 103  性能优化 103  性能优化的需求 103  显示过程的优化 103  资源载入的优化 103 开发注意事项 104  如何在模拟上调试唤醒挂起 104  如何让系统不进入休眠状态 104  获取当前系统的背光值 104  取消背光 104  图示 104  UI界面应用和底层应用交互的过程 105  向底层注册回调函数 105  开始向底层写入数据 105  底层调用回调函数 105  更新数据和相关模块数据 105  从底层取消 105  图示 105  ClearCase上应该保存哪些文件 106  应用的源代码 106  应用完整的资源文件 106  应用的批处理文件 107  应用配置文件 107  完整的测试代码 107  误区 107  RELEASEIF和IWIDGET_Release的异同 107  共同点 107  区别 107  ModelListener的取消问题。 107  使用监听对象(ModelListener) 107  不取消监听对象可能产生的结果 107  注意 108  BPOINT1和BPOINT 3的错误。 108  内存泄露(BPOINT1) 108  内存重复释放(BPOINT3) 108  内存越界 109  内存问题的建议 109  采取的措施 109  OEM层不应该处理UI的事情 109  文件操作注意 109  不能同时对个文件进行操作 109  树型文件夹问题 109  系统USB文件目录 110  T卡文件目录 110  编译环境下不应该有垃圾文件 110  mif文件中的项意义 110 提交版本前测试项 110  应用启动测试 111  干净环境的启动测试 111  丢失配置文件的启动测试 111  安全模式下的启动 111  编译应用和功能测试 111  提交版本前 111  自动化编译问题 111  修改注意的问题 112  启动速度测试 112  空记录启动的时间 112  满记录启动的时间 112  大数据量操作测试 113  载入数据需要的时间 113  删除所有数据需要的时间 113  满数据量下所有可能进行的操作 113  系统极度繁忙测试(暴力测试) 113  应用的暴力测试(单个应用) 113  系统繁忙的暴力测试(多个应用) 113  暴力测试的提示(更高的品质) 114  应用互斥测试 114  同时对T卡的写文件 114  同时对数据库的操作 114  占用内存测试(启动内存和最大内存) 114  内存稳定情况 114  空记录启动后占用的内存 114  满记录后启动占用的内存 114  所有窗口打开后占用的内存 114  使用过程是否有内存泄露 115  是否有BPOINT1和BPOINT3产生内存问题 115  操作响应速度 115  操作响应的速度 115  对数据库的操作响应速度(批删除、批增加) 115  对底层任务处理的响应速度 115  批删除文件,COPY文件的响应速度 115  系统时间测试 115  当前时间下正常情况 115  网络更换(如启动C网同步时间) 115  修改为1980年前情况 115  修改为2050年后的情况 115  时区改边的情况 116  待机测试 116  正常待机 116  强制待机 116  待机后来电和短信 116  挂起和唤醒测试 116  正常挂起和唤醒后 116  T卡插拔测试 116  是否产生系统崩溃 116  是否产生内存泄露等 116  是否文件丢失 116  是否应用执行失败 116  系统极度繁忙的时候是否更大几率产生问题 117  断网测试 117  强制关闭网络的测试 117  反复打开关闭应用的情况 117  新建默认项测试 117  默认标题 117  默认日期时间 117
评论 1
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值