构建可下载的 BREW™ 应用程序的方法
2003年9月12日 作者:高通 移动锋行
一旦创建应用程序并在 BREW 模拟器上测试,您将需要编译其 ARM 应用程序。建议将 RealView™ BREW 编译工具与 BREW 协同使用。您也可以使用 ARM 开发者套件 (ADS)。RealView™ BREW 编译工具是 ADS 的一部分。
步骤 1:源代码指导原则
应用程序中不应有静态或全局数据。静态数据可以使用小程序数据结构进行模拟。小程序应该不用静态或全局数据构建且会生成位置独立的代码。由于可以让编译器库引进自己的全局数据,您应该在编译应用程序后检查映射文件,确保没有任何数据段被标记为读写。
不要包括并链接“标准 C 库”。使用 AEE 内存服务(在 AEEHeap.h 中)和标准库宏(在 AEEStdLib.h 中)。例如,使用 MALLOC() 分配内存,使用 WSTRCPY() 复制 Unicode(宽)字符串。
除文件名是 ISOLATIN1/ANSI 外,BREW 仅兼容 Unicode(宽字符串)(非 ISOLATIN1/ANSI)。请始终使用 AECHAR,而不是“char”。使用 AEEStdLib.h 中提供的字符串服务,以操纵字符串。
步骤 2:安装 RealView™ BREW 编译工具 / ADS
将RealView™ BREW 编译工具 /ADS 安装在不包含空格的路径中。建议将 ARM 编译器安装在 c:\ads 目录中。
步骤 3:为 ARM 编译
使用 BREW SDK™ 示例中的生成文件副本。更改生成文件名称以及对生成文件内应用程序名的所有引用。此生成文件适用于 ADS 1.0.1。要使其适用于 ADS1.1 和 RealView™ BREW 编译工具(ADS1.1 的一部分),请搜索该文件中的 za1 并将其更改为 zo。
对于 ADS 1.0.1 : ZA = -za1
对于ADS 1.1 : ZA = -zo
您可以通过打开 MS-DOS 命令提示符并键入以下命令来检查 ADS 版本:armcc -vsn
如果 ARM 编译器在非 c:\ads 的位置上安装,则需要相应地修改生成文件和环境变量。
打开 MS-DOS 命令提示符并键入以下命令:nmake /f myapp.mak all
该命令将创建 ARM 可执行文件 myapp.mod。
编译错误:
ARM 编译器警告 您会发现编译过程中发出了某些警告。它们可被完全忽略:
"警告:C2067I:编译器的未来版本不支持 -zas 选项
"警告:C2071W:编译器的未来版本不支持 -za 选项
"警告:L6305W:图像没有入口点。(由于有多种选择而未指定或未设置)。
步骤 4:创建签名文件
要为您的应用程序获取测试签名,您需要具有访问开发者外联网的权限(要获取访问开发者外联网的权限,请访问链接:http://www.qualcomm.com/brew/sch/developer/become/authentication.html)。
一旦登录到开发者外联网,请启动测试签名生成器(可以从 https://brewx.qualcomm.com/developer/extranet/support/devtools.jsp 获得)。
输入有效的 ESN 和(可选)应用程序名。ESN 可以通过卸下电池查看电话后部找到。ESN 采用 H:0xaabbccdd 格式,位于第一个条形码下。ESN 必须按照以下格式输入 - 0xaabbccdd。按“生成”即可生成一个测试签名文件,然后按“下载”可以传输到您的计算机中。
步骤 5:将文件传输到电话中
用一条数据电缆将您的电话连接到 PC。
确保电话以接通电源。
使用 BREW AppLoader(可以从 https://brewx.qualcomm.com/developer/extranet/support/devtools.jsp 开发者外联网上获得)。
注意:确保所有文件和文件夹在传输到电话的文件系统上时采用小写形式。
在“/”下创建新文件夹“myapp”。其中,myapp 是您的应用程序名。
将 myapp.mod(通过步骤 3 中编译获得)复制到在电话上新创建的“myapp”文件夹中。
将 myapp.sig(使用步骤 4 中的测试签名生成器获得)复制到电话上的 myapp 文件夹中。
如果使用,请将 bar 文件“myapp.bar”(由 BREW 资源编辑器生成)复制到电话上的 myapp 文件夹中。
将 mif 文件“myapp.mif”复制到电话上的“/”目录中。
也可以将任何应用程序特定的其它文件复制到应用程序目录或应用程序目录的子目录中。
电话上的目录结构应该如下所示:
/myapp.mif
- 由 BREW MIF 编辑器生成
/myapp/myapp.mod
- 使用 ARM 开发者套件编译和链接
/myapp/myapp.sig
- 由测试签名生成器生成
/myapp/myapp.bar(如果使用)
- 由 BREW 资源编辑器生成
步骤 6:重置电话
关机后再开机。您的新下载 BREW 应用程序将位于 BREW Apps 菜单下。
关键字:ARM, 编译, 签名, 下载, .mif, .sig, .mod, .bar