新手入门系列(二)——从零开始创建 BREW™ 应用程序

时间:2022-05-23 20:11:21
1. 下载 BREW SDK™
当前的 BREW 1.0、1.1 和 2.0 版本都提供 BREW SDK。 您可以下载任一版本的 SDK 或下载所有三个版本的 SDK。

在安装 BREW SDK 的过程中,将 BREW 目录名选择为 BREW、BREW1_0、BREW1_1 或 BREW2_0。目录名中不应包含空格,也不应包含句点(如 BREW1.1)。

您应该根据目标手持设备的 BREW 版本,选择创建应用程序使用的 SDK 版本。 例如,LG VX-10 具有 BREW 版本 1.1。 构建目标设备 LG VX-10 使用的应用程序时就应该使用 BREW SDK 1.1 或更低版本。 有关 SDK 版本兼容性的详细信息,请参阅 我有一个使用 1.0.1.18 BREW SDK 编写的应用程序。 但是,我的电话上的 BREW API 是 1.0.2.4。 我的应用程序是否会在电话上运行?

有关相关手持设备的详细信息(包括支持的 BREW s/w 版本),请参阅 BREW 开发者外联网上提供的设备数据表。

2. 自学两个使用 BREW 开发应用程序时会涉及的基本组件

BREW Emulator - 一种程序,用于在模拟单个手持设备功能的环境中执行和测试应用程序。

BREW MIF 编辑器 - 一种程序,用于创建和修改 MIF(模块信息文件)文件。 您创建的每个应用程序(模块)都需要一个 MIF 文件。 它含有关于您的应用程序的信息。

3. 启动 Microsoft Visual C++ 6.0
从 File(文件)菜单中选择 New(新建)并单击 Projects(项目)选项卡。 启动“BREW 应用程序向导”并按照其引导完成所有步骤。 建议在执行“BREW 应用程序向导”引导步骤时,创建 MIF(通过单击“MIF 编辑器”)。 有关详细信息,请参阅步骤 4。
注意:有时侯"(通过单击“MIF 编辑器/MIF Editor”)"可能无法启动.这时你就需要到BREW SDK的程序列表中去手动启动MIF Editor了.
如果您只安装了 BREW SDK 1.0,将找不到“BREW 应用程序向导”。 您需要安装 BREW SDK 1.1 或 2.0 才能使用“BREW 应用程序向导”。

BREW SDK 安装过程会设置 BREWDIR 环境变量,并将其值设置为 BREW 目录路径。 如果您安装了多个版本的 BREW SDK,则应该检查 BREWDIR 的值。

检查方法为:开始 -> 控制面板 -> 系统 -> 高级 -> 环境变量。 应该将 BREWDIR 设为您要在开发应用程序时使用的 BREW 版本的 BREW 目录路径。 例如,可以将 BREWDIR 设置为 C:/Program Files/BREW1_0。

4. 完成“BREW 应用程序向导”的所有引导步骤后,您就完成了应用程序基本结构的构建工作。 如果在步骤 3 中执行“BREW 应用程序向导”引导步骤的过程中未创建 MIF 文件,则在构建/编译此应用程序之前还需执行以下操作:
打开 MIF 编辑器。 单击“新建小程序”。 在随后出现的对话框中,输入此应用程序的名称。 此名称必须与该应用程序的项目目录名相同。

可以选择在本地生成应用程序的 Class ID(BREW 应用程序的唯一 ID)。 在提交应用程序进行认证之前,您需使用 BREW 开发者外联网提供的 Class ID Generator 来生成 Class ID。
然后会提示您将 Class ID 保存在 BID 文件中。 您应该将 BID 文件保存在项目目录中。
将 MIF 文件保存在 Examples 目录(如 C:/Program Files/BREW2_0/Examples)中。
5. 在 Visual C++ 中,选择 File View(文件视图)选项卡,打开 Source Files(源文件)目录下的 .c 文件,编辑该文件使其包含您保存在 MIF 编辑器中的 .bid 文件: #include "myApp.bid"

6. 在继续进行和编译应用程序之前,需要检查以下几项内容:

是否已将环境变量 BREWDIR 设为您要在编译应用程序时使用的 BREW 版本的 BREW 目录路径?
有种验证方法为:右键单击 AEEAppGen.c 或 AEEModGen.c,然后单击属性。 检查项目中文件的路径,确定他们来自何处。 它们是否来自正确的 BREW 版本目录? 如果不是,则应该确保将 BREWDIR 环境变量设为您要在开发应用程序时使用的 BREW 版本的 BREW 目录路径。 这可以确保:只需更改 BREWDIR 环境变量,即可轻松地使用新版 BREW 编译应用程序,或将应用程序链接至新版 BREW。

最后一着:从工作空间删除 AEEAppGen.c 和 AEEModGen.c,然后重新添加。 要使用此方法,请单击 Project(项目)-> Add to Project(添加到项目)-> Files(文件)...,然后从您开发应用程序所用的 BREW SDK 版本的 /src 目录中选择 AEEAppGen.c 和 AEEModGen.c 文件。
转至 Project(项目)->Settings(设置)
Link(链接)选项卡中的输出文件名必须如示例 "myApp.dll" 所示,而不能为 "/Debug/myApp.dll" 或任何其它前缀目录。
7. 现在,您可以继续进行并将应用程序作为 DLL 进行编译(编译 -> 编译 myApp.dll)

8. 如果编译应用程序时没有出现错误,则可以使用 BREW Emulator 运行此应用程序。 在 Emulator 中:
将 MIF 目录设置为包含 MIF 文件的目录。 例如,C:/Program Files/BREW/Applications/MIF/。
将小程序目录设置为项目目录的父目录。 例如,如果项目目录为 C:/Program Files/BREW/Applications/myApp/,则必须将小程序目录设置为 C:/Program Files/BREW/Applications/
9. 此时,您的应用程序名将显示在 Emulator 中,但它尚无任何功能。 要使应用程序开始运行,就必须在 "myApp.c" 中添加更多代码,因为此时的应用程序只是向导创建的框架而已。 在插入应用程序的特定代码时,请确保您的应用程序包含小程序结构(包含 AEEApplet);确保使用小程序结构大小调用 AEEApplet_New,而不是使用 AEEApplet 大小调用它。

要继续开发应用程序,请参阅《BREW SDK 用户指南》、BREW 开发者在线 FAQ 和知识库网站、《BREW API 参考资料》、《MIF 编辑器指南》、《资源编辑器指南》以及 BREW SDK 随附的示例应用程序。