BlackBerry 用户界面开发实例
作者：杨江
目录
概述 ............................................................................................................................................. 3
1 准备开发环境 .......................................................................................................................... 4
2 创建主从共两个窗口 (Screen)；创建菜单为主从窗口进行之间进行导航 ........................ 9
3 为主窗口添加可以滚动显示和动态绑定数据的高级字段 ListField .................................. 14
4 为从窗口添加显示和输入字段；使用布局管理器处理 UI 布局，背景色 ....................... 17
5 处理黑莓手机的返回键(Return)，轨迹球(TrackBall)事件，输入字段数据变化等事件 .. 20
6 配置模拟器中文显示，单步跟踪调试 ................................................................................ 21
7 OTA 应用部署 ........................................................................................................................ 23
8 后记 ........................................................................................................................................ 27
概述
本文通过一个办公审批的应用案例，介绍如何使用 BlackBerry UI API 为用户在黑莓手机开发用户界
面程序，如何使用 UI 组件 (Screen, Manager, Field)，如何扩展高级 UI 组件 ListField，如何通过菜单/
按钮/按键来响应用户交互，如何通过布局管理器 Manager 来处理特殊的 UI 布局和显示效果，最后
通过 OTA 无线部署这个应用到用户的黑莓手机设备上。
面向对象：
对黑莓手机应用开发感兴趣，对黑莓应用开发稍有了解但是还没有实战经验，希望能对 BlackBerry
UI 开发有个更深入的了解。
目标：
在本文的办公审批的应用案例中，企业客户要求开发一个运行在黑莓手机上面的用于办公申请和批
准的应用程序，让移动办公的用户和他们的领导能及时地提交/查看/审批办公申请。
应用程序的主要用户窗口有两个：
1. 等待审批的办公申请记录列表，用户可以通过菜单新建，保存，查看，删除申请记录；
2. 查看每条申请记录的详情信息，领导可以查看，通过，或者拒绝该申请。
要点：
1. 准备开发环境，创建新的 BlackBerry 项目，创建最简单的 UI 应用程序 Hello World，在开发
环境中内置的黑莓 9700 模拟器中运行。
2. 创建主从共两个窗口(Screen)；创建菜单为主从窗口进行之间进行导航。
3. 为主窗口添加可以在列表中滚动显示数据的高级字段 ListField，该字段和待审批的申请记录
列表进行数据绑定。
4. 为从窗口添加显示和输入字段(Field)，命令按钮。使用布局管理器处理 UI 布局，背景色。
5. 处理黑莓手机的返回键(Return)，轨迹球(TrackBall)事件，输入字段数据变化等事件。
6. 配置模拟器中文显示，单步跟踪调试。
7. OTA 应用部署，为不同 OS 版本的手机 8300/9700 分别打包应用程序为 jad/alx 包，架设
OTA 部署服务器，为 8300/9700 手机自动部署对应 OS 版本的程序。
8. 后记。
对读者的前提要求：
要求读者对 BlackBerry 平台/BlackBerry UI API/Java 语言都稍有了解。建议读者可以浏览附录头三
个网站，特别是“开发人员教程 - RIM 开发人员教程”以快速获得相关基本知识。
1
准备开发环境
准备开发环境，创建新的 BlackBerry 项目，创建最简单的 UI 应用程序 Hello World，在开发环境中
内置的黑莓 9700 模拟器中运行。
1.1 准备开发环境，下载并安装 BlackBerry Java Plug-in for Eclipse 开发工具
本文使用的BlackBerry Java Plug-in for Eclipse版本为: v1.1 beta2(1.1.1) ，相对于JDE该工具简称
eJDE。eJDE 1.1.1内置eclipse 3.5.1 。eJDE 1.1.1内置BlackBerry Java SDK version 5.0.0。
而BlackBerry Java SDK里面又包括MDS模拟器，手机模拟器simulator，例子代码
samples，文档docs等内容。
(下载地址: http://na.blackberry.com/eng/developers/devbetasoftware/javaplugin.jsp )
1.2 创建 BlackBerry Project
启动 Eclipse, File New Other, 选择 BlackBerry Project，填写 Project name 为 UISample，选择
JRE -> Use a project specific JRE 为 BlackBerry JRE 5.0.0，点击 Finish 按钮创建项目。
注：向导中的 BlackBerry JRE 5.0.0 对应 BlackBerry Java SDK version 5.0.0，后者内置
采用 BlackBerry OS 5.0.0 的黑莓 9000/9550/9700 手机模拟器。如果需要开发测试针对黑
莓 8310 等其他型号手机的应用程序，你可以通过 eclipse 在线更新的方式安装
4.2.1/4.5/4.6/4.7 等版本的 BlackBerry Java SDK，比如 SDK version 4.5 内置黑莓
8310 手机模拟器。具体如何通过 eclipse 在线升级请参考
www.blackberry.com/developers 网站。
1.3 导入 Hello World 例子代码
把开发工具内置的例子代码 helloworlddemo 导入到项目 src 目录。BlackBerry 开发工具带了几十
个例子程序在
C:\TOOLS\BlackBerry_JDE_PluginFull_1.1.1\plugins\ne t.rim.ejde.componentpack5.0.0_5.0.0.14\ compon
ents\samples 目录下面。把 com\rim\samples\device\helloworlddemo 目录（包括
com\rim\samples\device 等父目录，Java 代码和 png 图片）拷贝到项目 src 目录下面。
