BlackBerry 用户界面开发实例（一）
作者: 杨江
概述
本文通过 一个办 公审批 的应 用案例， 介绍如 何使用 Blac kBe rry UI API 为 用户在 黑莓 手机开发 用户界 面程序， 如何使 用 U I 组 件 ( Scre e n , Man ager, Fie ld ) ，如 何扩展 高 级 U I 组件 Lis tF ie ld ，如何 通 过菜单 / 按钮 / 按 键来响 应用户 交互 ，如何通 过布局 管理器 Man ager 来处 理特殊 的 U I 布局 和显示效 果，最 后 通过 OT A 无线 部署这 个应用 到 用户的 黑莓手 机设备 上。
面向对象 ：
对黑莓手 机应用 开发感 兴趣 ，对黑莓 应用开 发稍有 了解 但是还没 有实战 经验 ， 希望 能对 BlackB e rry
U I 开发有 个更深 入的 了解。
目标： 在本文的 办公审 批的应 用案 例 中，企 业客户 要求开 发一 个 运行在 黑莓手 机上面 的用 于办公 申 请和批
准的应用 程序， 让移动 办公 的用户 和 他们的 领导能 及时 地提交 / 查看 / 审 批办公 申请 。
应用程序 的主要 用户窗 口 有两个：
1. 等待审批 的办公 申请记 录 列 表，用户 可以通 过菜单 新建 ，保存， 查看， 删除申 请 记 录；
|
|
|
|
要点：
1. 准备开发 环境， 创建新 的 Bl ack Be rry 项目 ，创建 最简单 的 U I 应用 程序 H e llo Wo r ld ，在开发 环境中内 置的黑 莓 9700 模 拟器中运 行。
2. 创建主从 共两个 窗口 ( Scre e n ) ；创建 菜单为 主从窗 口 进 行之间进 行导航 。
3. 为主窗口 添加可 以 在列 表中 滚动显示 数据的 高级字 段 Li s t Fie ld ，该字 段和待 审批的 申请记录 列表进行 数据绑 定。
4. 为从窗口 添加显 示 和输 入字 段 (Fi e ld ) ，命 令按钮 。 使用 布局管理 器处理 U I 布局 ， 背景色。
5. 处理黑莓 手机的 返回键 (Re tu rn ) ，轨迹球 (T ra ckBall ) 事件 ，输入字 段数据 变化等 事件 。
6. 配置模拟 器中文 显示， 单步 跟踪调试 。
7. OT A 应 用部署 ，为不 同 OS 版本的手 机 8300 /970 0 分别 打包应用 程序为 jad /alx 包， 架设
OT A 部 署服务 器，为 8 300/9 700 手机 自动部 署对应 O S 版本的程 序。
8. 后记。
对读者的 前提要 求：
要求读者 对 BlackB e rry 平 台 /Bl ack B e rry UI API/ J av a 语 言都稍有 了解。 建议读 者可 以浏览附 录头三 个网站， 特别是 “开发 人员 教程 - RIM 开发人 员教程 ” 以快速获 得相关 基本知 识。
1 准备开发环境
准备开发 环境， 创建新 的 Bl ack Be rry 项目 ，创建 最简单 的 U I 应用 程序 H e llo Wo r ld ，在开发 环境中 内置的黑 莓 9700 模拟器中 运行。
1.1 准备开 发环境 ，下载并 安装 BlackB e rry Ja v a Plug - in f or E cli p s e 开 发工具
本文使用 的 Black Be rry Ja v a Plug - in for E cli ps e 版本 为 : v 1.1 b e ta2 (1.1 .1) ， 相对于 J DE 该工具 简称 eJ DE 。 e J DE 1.1.1 内 置 e c lipse 3.5.1 。 e J DE 1.1. 1 内置 Bl ac kB er ry J av a SD K ve rs io n 5. 0. 0 。 而 BlackBerry Java SD K 里面又包 括 MDS 模拟 器， 手机模拟 器 simulator ， 例子代码 samples ，文档 docs 等内 容 。
( 下载地 址 : h ttp :/ /n a.b lackbe rry .com/e n g/d e v e lop e r s /devb e ta s of t w are /ja v ap lu gin. js p )
1.2 创建 Bla ckBe rry P ro je ct
启动 E cli ps e , File à N e w à Oth e r, 选择 Bla ckBe rry P ro jec t ，填写 P ro jec t n am e 为 U ISamp l e ，选择
J RE - > U s e a p ro jec t s pe cif i c J RE 为 BlackBe r ry JRE 5.0.0 ， 点击 Finis h 按钮创 建项目 。
注：向导 中的 Bla ckBe rry J RE 5.0.0 对 应 BlackBerry Java SDK version 5.0.0 ， 后者内 置 采用 BlackBerry OS 5. 0.0 的黑莓 9000/9550/9 700 手机模拟 器。如 果需要 开发测试 针对黑
莓 8310 等其他 型号手 机的 应用程序 ，你可 以通过 ec l ip se 在线更新 的方式 安装
4.2.1 /4.5/4.6/4.7 等 版本的 BlackBerry Java SDK ，比如 SDK version 4.5 内置黑莓
8310 手机模拟 器。具 体如 何通过 eclipse 在 线升级 请参考
www.blackberry.com/developers 网站。
1.3 导入 H e l lo Wo rld 例子代 码
把开发工 具内置 的例子代 码 h e llow orldde m o 导 入到项 目 s rc 目 录。 B lackBe rry 开发 工具带了 几十 个例子程 序在
C: / T OOLS/ BlackB e rry_ J DE _ Plu ginFu ll_ 1.1 .1 /p l ug i ns/n et.r i m .e jde.compon en t p ac k5.0. 0_ 5 .0. 0.1 4 /compo n en ts/ samp l es 目录下面。 把 com/ri m/s a m p le s /de v ic e/h e ll ow orldd em o 目 录（包 括 com/ri m/s a m p le s /de v ic e 等 父目录， J av a 代码和 pn g 图 片）拷贝 到项目 s rc 目 录下 面。
1.4 为程 序添加 手机上 面的 图标
鼠标双击 BlackB e rry _ Ap p _ De s cripto r.x m l 文件 ，在第 一个栏目 (App lic at ion 栏目 ) 的右边 App lic at ion icon s 区域 点击 Ad d 按钮， 选择 s rc /com /rim / s a m p le s /d ev ic e/he llow orldde m o /i m age /
h e llow orld _ jd e .pn g 文件，保 存。
|
|
鼠标点击 e cli p s e 菜单 Ru n - > Ru n Con f igurat ion s ，在 对话框中 点击左 上角的 按钮 ，创建新 的模拟 器配置环 境；修 改 N ame 为 U ISamp l e ；在 对话框 右边第 一个栏目 Pro j e cts 栏目中勾 上 U ISamp l e 项 目；在对 话框右 边第三 个栏 目 Sim u lato r 栏 目中 De v ic e 区域选择 带 q we rt 键盘的黑 莓 9700 手 机（缺 省的模拟 器是黑 莓 955 0 Sto r m 2 ，这 款手机 不带 qw e rt 键盘，该 型号模 拟器不 是特 别方便 在 P C 机屏 幕上操作 ）；点 击 Ru n 命令 按钮运行 。
1.6 在手 机模拟 器上运行 H e l lo Wo rld
运行在手 机模拟 器 Down l oad s 文件夹 中，你 可以看 到 H e llo Wo rld 演示 程序的 图标，运 行这个 程 序。运行 结果如 图。
|
|
2 创建主从共两 个窗口 (S creen) ； 创建菜单 为主从窗口进行之 间进行
导航
下面我们 将创建 主从共两 个窗口 ( Scre e n ) ， 一个是初 始的 申请 记录列 表窗口 ，一 个是申请 记录详 细内容。
提示：黑 莓手机 上面最重 要的用户 界面就 是 Scr ee n 。 每个 Scr ee n 上面 可以可 以摆 放 / 显示 字段 Fie ld （比 如文本 ，日%3