BlackBerry Java 开发环境安装及入门作者 : 邓明轩俞伟 1

Size: px

Start display at page:

Download "BlackBerry Java 开发环境安装及入门作者 : 邓明轩俞伟 1"

昀扈
5 years ago
Views:

1 BlackBerry Java 开发环境安装及入门作者 : 邓明轩俞伟 1

2 目录环境搭建... 3 Eclipse 安装... 3 BlackBerry JDE Plug-In for Eclipse 安装... 5 添加组件包... 9 Hello World 的开发建立 BlackBerry 项目创建包创建主程序设置模拟器对应用进行测试主程序代码解析

环境搭建 RIM (Research in Motion) 公司为 BlackBerry 开发提供了多种开发平台, 不同平台的开发人员可以选择自己熟悉的开发工具开发 BlackBerry 应用程序本节以 BlackBerry JDE Plug-In for Eclipse 为例描述了 BlackBerry 开发环境的搭建过程 Eclipse 安装 BlackBerry Eclipse

3 环境搭建 RIM (Research in Motion) 公司为 BlackBerry 开发提供了多种开发平台, 不同平台的开发人员可以选择自己熟悉的开发工具开发 BlackBerry 应用程序本节以 BlackBerry JDE Plug-In for Eclipse 为例描述了 BlackBerry 开发环境的搭建过程 Eclipse 安装 BlackBerry Eclipse Plug-In 是在 Eclipse 平台的一个插件, 为了安装 BlackBerry Eclipse Plug-In, 需要先安装 JDK 和 Eclipse 平台 BlackBerry Eclipse Plug-in 对 JDK 的版本要求为 JDK6-update10 或者更高版本 BlackBerry Eclipse Plug-In 对 Eclipse 的版本要求为 3.5-classic 或更高, 本节以 Eclipse classic 为例说明 Eclipse 的安装首先安装 JDK, 官方下载地址为安装文件为 exe 执行文件, 双击安装即可 Eclipse 官方下载地址为国内也有很多网站可以下载 Eclipse 安 Eclipse 是一个免安装程序, 一般而言只需要把下载的压缩文件解压缩就可以使用本文使用的 Eclipse 安装程序 eclipse-sdk win32.zip, 将该文件解压缩至文件夹 eclipse-sdk win3 后可以在该文件夹发现 eclipse 目录为了使用方便, 我们将这个 eclipse 目录拷贝到 c:\blackberry 文件夹下, c:\blackberry 这个文件夹需要自行创建, 你也可以根据你自己的喜好和习惯使用不同的文件夹名现在, 双击 c:\blackberry\eclipse 文件夹下的 eclipse.exe 就可以启动 Eclipse 了在第一次启动时,Eclipse 会提示你选择 workspace 的路径, 如图 : Workspace 是指工作台, 你可以选择一个空的目录作为工作台, 以后创建的项目都会出现在这个工作台目录下本文以 c:\blackberry\workspace 作为工作台, 所以在对话框中直接输入 c:\blackberry\workspace,eclipse 会自动创建该目录并将其作为工作台目录 Eclipse 启动后将显示欢迎界面, 如图 : 3

4 关闭欢迎页面后将出现标准的 java 开发界面, 如图 : 4

现在 Eclipse 已经可以开始使用了, 可以开始准备安装 BlackBerry Eclipse Plug-In BlackBerry JDE Plug-In for Eclipse 安装 BlackBerry JDE Plug-In for Eclipse 可以从 BlackBerry 官方网站上下载, 网址为 www.blackberry.

5 现在 Eclipse 已经可以开始使用了, 可以开始准备安装 BlackBerry Eclipse Plug-In BlackBerry JDE Plug-In for Eclipse 安装 BlackBerry JDE Plug-In for Eclipse 可以从 BlackBerry 官方网站上下载, 网址为该网站上提供的工具很多, 其中一种是带组件包和插件平台的压缩文件, 这种文件可以直接在 Eclipse 平台上安装, 而且带有组件包和插件平台, 比较方便比如有 BlackBerry JDE Plug-in for Eclipse v1.1 (with the BlackBerry JDE v5.0 Component Pack), 说明是 1.1 版本的 BlackBerry 插件平台和 5.0 版本的组件包组件包的版本和 BlackBerry 智能手机 ROM 的版本对应所以,5.0 的组件包适合开发在 ROM 5.0 上运行的 BlackBerry 程序如果你所开发的 BlackBerry 程序需要运行在 ROM 5.0 以外的其它版本上, 你也可以下载对应版本的组件包, 在 BlackBerry JDE Plug-In for Eclipse 安装后将 5.0 的组件包替换成你需要的版本组件包替换的具体步骤在后面章节有详细描述本文以 BlackBerry JDE Plug-in for Eclipse v1.1 (with the BlackBerry JDE v5.0 Component Pack) 为例说明插件安装的过程所下载的文件为 : BlackBerry_JDE_PluginFull_ exe 直接双击进行安装, 如图 : 点击 Next 到下一页, 如图所示填入 eclipse 目录路径 :C:\blackberry\eclipse 5

6 点击 Next, 显示安装概要, 如图 : 点击 Install, 开始安装, 如图 : 6

7 安装完毕后 : 勾上安装完毕后启动 eclipse 的选项, 点击 Done 启动 Eclipse 成功安装后在 Eclipse 新建项目菜单里可以看到 BlackBerry 项目选项, 步骤 : File->New->Project->BlackBerry, 如图 : 7

8 点击 Next 显示 BlackBerry 项目设置, 如图 : 8

9 在 JRE 设置里显示 BlackBerry JRE 5.0.0, 表明已配置了 5.0 的组件包恭喜你, 你已经进入 BlackBerry 开发世界了, 下一章将介绍如何在 BlackBerry JDE Plug-In for Eclipse 中开发一个最简单的客户端程序添加组件包本小节讲解组件包的添加过程, 不需要添加组件包的读者可以跳过这一小节在 BlackBerry 应用开发过程中, 有时你可以需要用到不同版本的组件包比如你所开发的 BlackBerry 应用需要运行在 4.7 的 ROM 上, 为了使用 4.7 的 API 和相关的功能, 你可能需要使用 4.7 的组件包在这种情况下你需要添加 4.7 组件包, 可以通过安装 BlackBerry Java Plug-in for Eclipse Update. 步骤如下 : 打开 Eclipse 后点击 Help->Install New Software->Add Site, 在 Location 里填入 URL 如图 : 点击 OK 9

10 列表列出了所有可添加的 BlackBerry Java Plug-in 组件版本, 用户可以根据需要添加所需版本, 这里以版本 4.7 为例点击 Next, 10

11 列表显示需要安装的组件名与版本, 点击 Next 开始安装, 如图 : 安装完毕后,Eclipse 就可以支持 4.7 SDK 和 5.0 SDK 版本的项目开发启动 Eclipse, File->New->Project->BlackBerry, 进入项目创建对话框, 如图 : 在 JRE 下拉列表里可以选择 4.7 或 5.0 版本的组件, 分别支持 4.7 和 5.0 版本 SDK 的项目开发 11

Hello World 的开发本章讲解一个简单 BlackBerry 应用的开发过程, 按照惯例, 我们还是使用 Hello World 作为我们开发的第一个应用我们会在这个简单应用的开发过程中讲解 BlackBerry 项目的建立, 基本的代码结构, 设备模拟器的使用, 应用部署等建立 BlackBerry 项目 BlackBerry 应用以项目为单位, 一个应用往往对应一个项目,

12 Hello World 的开发本章讲解一个简单 BlackBerry 应用的开发过程, 按照惯例, 我们还是使用 Hello World 作为我们开发的第一个应用我们会在这个简单应用的开发过程中讲解 BlackBerry 项目的建立, 基本的代码结构, 设备模拟器的使用, 应用部署等建立 BlackBerry 项目 BlackBerry 应用以项目为单位, 一个应用往往对应一个项目, 在有些情况下一个应用可能会对应多个项目所以, 建立项目是创建 BlackBerry 应用的第一步在本例中我们通过一个名为 HelloWorld 的项目建立第一个 BlackBerry 应用在 Eclipse 界面中选择 File->New->Project, 如下图, 系统会弹出项目新建对话框以创建项目注意这里不要选择 File->New->Java Project, 如果选择这一项的话会创建一个普通的 J2SE 项目, 所创建的应用程序并不能在 BlackBerry 模拟器或者是 BlackBerry 设备上运行在项目新建对话框中展开 BlackBerry 项, 可以看到 BlackBerry Project 项和 BlackBerry Resource File 项其中 BlackBerry Project 项用于创建 BlackBerry 项目, 而 BlackBerry Resource File 项用于创建 BlackBerry 项目中使用的资源文件, 有关资源文件不在本文中阐述如果在项目新建对话框中看不到 BlackBerry 项, 则说明 BlackBerry JDE Plug-In 并没有安装成功, 需要重新检查第一章提到的 BlackBerry JDE Plug-In 安装过程, 必要时需要重新安装 BlackBerry JDE Plug-In. 如上所述, 在项目新建对话框中展开 BlackBerry 项, 选择 BlackBerry Project 并点击 Next 开始创建 BlackBerry 项目 12

13 然后在项目新建对话框的 Project Name 一栏中输入项目名, 本例以 HelloWorld 作为项目名输入项目名以后点击 Finish 完成项目新建过程注意, 在 BlackBerry 模拟器或者是 BlackBerry 设备中, 项目名将作为应用的名称显示出来所以, 如果你希望你的应用有不同的名字, 你可以从这里为应用输入你所希望使用的应用名 13

文件夹, 对 src 文件夹点击右键, 选择 New->Package, 系统将弹出新建包的对话框在新建包对话框的 Name 一栏中输入包名, 注意包不能以 com.rim 开头, 如果以 com.

14 创建包在不考虑代码规范的情况下, 在你创建了 BlackBerry 项目后, 你可以直接在创建的项目中的 src 文件夹下开始创建主应用程序, 所创建的类将被放入名为 default 的包中但是 java 代码规范中建议不要直接在 default 包中创建应用, 所以一般而言在项目创建后我们需要创建一个包, 然后在这个包中创建自己希望创建的类为了创建包, 将新建的 HelloWorld 项目展开, 找到 src 文件夹, 对 src 文件夹点击右键, 选择 New->Package, 系统将弹出新建包的对话框在新建包对话框的 Name 一栏中输入包名, 注意包不能以 com.rim 开头, 如果以 com.rim 开头的话应用程序将不能在 BlackBerry 设备上运行本例以 com.bbtest.helloworld 作为包名, 输入后点击 Finish 按钮在新建包后,src 文件夹下将出现一个灰白色的包 14

创建主程序创建了包以后, 就可以在这个包下开始创建主程序了选择刚创建的包, 点击右键, 选择 New->Class 以创建一个类在新建类对话框的 Name 一栏中输入类名, 本例以 HelloWorld 为类名这里不要求主应用程序的类名与项目名相同, 本例只是延用习惯使用 HelloWorld 作为项目名和主应用程序类名, 现实中项目名和主应用程序类名可以不同输入类名后注意要选择

15 创建主程序创建了包以后, 就可以在这个包下开始创建主程序了选择刚创建的包, 点击右键, 选择 New->Class 以创建一个类在新建类对话框的 Name 一栏中输入类名, 本例以 HelloWorld 为类名这里不要求主应用程序的类名与项目名相同, 本例只是延用习惯使用 HelloWorld 作为项目名和主应用程序类名, 现实中项目名和主应用程序类名可以不同输入类名后注意要选择 net.rim.device.api.ui.uiapplication 作为父类, 要选择父类, 直接点击 Superclass 栏旁边的 Browse 按钮可以开始选择在父类选择框中开发者可以输入父类名开头的几个字符, 系统会自动查找相关的类选择了父类后注意要选中 public static void main(string[] args) 选项, 通过这个选项可以让系统自动生成 main 函数如果在创建类的过程中没有选择这一项, 也可以在类创建后手工加入 main 函数, 但相对比较麻烦最后确认一下 Source folder: 一栏和 Package 一栏显示的内容都正确确认无误后点击 Finish 创建该类 15

16 主应用程序类创建后该类对应的 java 代码将自动显示在程序编辑框中, 参考下面提供的完整代码在 main 函数中插入新建实例和运行实例的代码, 并添加 HelloWorld 构造函数代码添加完成后如下图 : 16

$mainscreen; public class HelloWorld extends UiApplication { /** * @param args */ public static void main(string[] args) { // TODO Auto-generated method stub HelloWorld _app= new HelloWorld(); _app.$

17 为了方便读者, 下面提供该类的完整代码 : package com.bbtest.helloworld; import net.rim.device.api.ui.uiapplication; import net.rim.device.api.ui.component.labelfield; import net.rim.device.api.ui.container.mainscreen; public class HelloWorld extends UiApplication { /** args */ public static void main(string[] args) { // TODO Auto-generated method stub HelloWorld _app= new HelloWorld(); _app.entereventdispatcher(); } public HelloWorld() { 17

18 } MainScreen screen = new MainScreen(); LabelField label = new LabelField("Hello World!"); screen.add(label); this.pushscreen(screen); } 输入代码后保存该类, 对系统提示的错误进行修改, 然后就可以开始测试这个应用程序了下面的章节会对有关代码的进行详细的解释在代码输入过程中注意多使用 Eclipse 提供的代码辅助工具如实例名输入完成后再输入. 系统会提示该实例所能使用的方法或者是属性, 可以直接选择另外, 可以在输入了代码后通过右击空白界面, 然后选择 Source->Organize Imports 自动完成 import 语句, 不需要手工输入 import 语句设置模拟器完成主应用程序的代码输入后就可以开始测试该应用程序了,BlackBerry JDE Plug-In for Eclipse 自带有 BlackBerry 模拟器, 可以直接在计算机上通过模拟器对应用程序进行测试在第一次使用模拟器时需要先对模拟器进行设置, 设置之后再次进行测试时就可以直接使用设置好的模拟器进行测试要对模拟器进行设置, 对项目点击右键, 选择 Run As->Run Configurations, 系统会弹出模拟器设置界面 18

19 在模拟器设置界面中, 在 BlackBerry Simulator 下你会发现有一个已经配置好的模拟器, 名为 DebugServer 该模拟器在一些特殊情况下可能无法正常使用为了更详细地了解模拟器, 并保证模拟器的可用性, 建议新建一个模拟器进行测试 19

20 对 BlackBerry Simulator 点击右键, 选择 New, 系统会生成一个名为 New_configuration 的模拟器, 同时界面右侧会显示该模拟器的配置界面你可以在 Name 一栏中输入模拟器名, 本例以 FirstSimulator 作为模拟器名输入模拟器名后选择 Simulator 标签页, 可以看见模拟器型号选择栏, 名为 Profile, 点击下拉框, 可以选择系统预先配置好的不同型号的模拟器, 本例选择 8320-JDE 作为要使用的模拟器完成后, 点击下方的 Apply 使配置生效, 然后点击 Run 就可以对程序进行测试了 20

对应用进行测试在配置了模拟器后点击 Run 可以开始应用测试, 模拟器应用程序开始运行, 运行后会显示 BlackBerry 模拟器界面令很多开发人员困惑的是在模拟器运行后所需要测试的应用程序并不会马上执行, 这是因为 BlackBerry 模拟器完全模拟了 BlackBerry 智能手机的使用,

21 对应用进行测试在配置了模拟器后点击 Run 可以开始应用测试, 模拟器应用程序开始运行, 运行后会显示 BlackBerry 模拟器界面令很多开发人员困惑的是在模拟器运行后所需要测试的应用程序并不会马上执行, 这是因为 BlackBerry 模拟器完全模拟了 BlackBerry 智能手机的使用, 在手机启动后所显示的是 BlackBerry 主界面, 如图用户需要找到对应的应用程序图标, 通过点击图标的方式对应用进行测试对于模拟器的使用在这里不作详细讲解, 简单而言测试人员可以通过鼠标点击模拟器上的模拟键盘进行操作, 如果需要滚动轨迹球, 只需要将鼠标移动模拟轨迹球上, 按住鼠标左键移动鼠标就可以了 21

本例使用的模拟器型号是 8320, 不同型号的 BlackBerry 智能手机界面稍有不同, 开发人员需要熟悉自己所选择的型号在 8320 模拟器的主界面滚动轨迹球, 选中主界面最下方的 BlackBerry 图标, 然后点击轨迹球, 模拟器中将显示该模拟器上的详细应用图标在这些图标中可以发现我们需要测试的应用,

22 本例使用的模拟器型号是 8320, 不同型号的 BlackBerry 智能手机界面稍有不同, 开发人员需要熟悉自己所选择的型号在 8320 模拟器的主界面滚动轨迹球, 选中主界面最下方的 BlackBerry 图标, 然后点击轨迹球, 模拟器中将显示该模拟器上的详细应用图标在这些图标中可以发现我们需要测试的应用, 因为我们并没有为应用程序设置特定的图标, 所以我们所测试的应用程序将显示成一个类似于命令行窗口的图标, 如下图 : 选中该图标后点击轨迹球启动该应用, 我们将在模拟器上看到第一个 BlackBerry 应用程序的运行效果, 一个新的窗口显示出来, 里面显示的是大家熟悉的 Hello World, 在下一节我们会对样例中的主程序代码进行详细分析 22

主程序代码解析为了让读者更深入的了解我们所使用的样例程序, 从而可以修改这个应用开始进一步的学习, 下面对样例应用的代码逐行进行解释在主用应程序中的第一句是包的声明, 如果按本文所描述的方式生成类文件的话, 这一句是自动生成的 : package com.bbtest.

23 主程序代码解析为了让读者更深入的了解我们所使用的样例程序, 从而可以修改这个应用开始进一步的学习, 下面对样例应用的代码逐行进行解释在主用应程序中的第一句是包的声明, 如果按本文所描述的方式生成类文件的话, 这一句是自动生成的 : package com.bbtest.helloworld; 在 package 语句后面的是本类所在的包的包名如果开发人员在其它包新建了类文件, 并将本文中的样例代码拷贝到新建的类文件中, 则要注意修改这里的包名在包声明语句后的是包引入的声明, 对于 java 开发人员也是很熟悉的, 作用是本类所使用 23

24 的一些不在本包里的类从这三行语句可以发现我们在样例代码中使用了 UiApplication, LabelField 和 MainScreen 三个类这三个类都是 BlackBerry API 提供的 BlackBerry 系统类这几行语句是需要开发人员手工输入的 ( 或者是从样例代码中直接拷贝的, ), 系统不会自动生成如果希望系统自动生成的话, 可以在完成本例的 main 函数和构造函数后点击右键, 选择 Source->Organize Imports 由系统自动生成这些 import 语句 import net.rim.device.api.ui.uiapplication; import net.rim.device.api.ui.component.labelfield; import net.rim.device.api.ui.container.mainscreen; 在 import 语句后是类声明, 按本文描述的方法生成类文件的话, 这一句是自动生成的该语句表明本类类名为 HelloWorld, 是 UiApplication 的子类 public class HelloWorld extends UiApplication { 然后是应用程序的入口函数,main 函数的声明, 这一句也是自动生成的, 其格式和标准的 j2se main 函数相同 public static void main(string[] args) { 在 main 函数里面只有两句语句, 就是新建一个本类的实例, 然后调用该实例的 entereventdispatcher 函数 entereventdispatcher 函数其实是该类的父类, 也就是 UiApplication 的函数, 所以并不需要开发人员实现这两句语句对于一般的 BlackBerry 应用程序都是需要的, 初学者可以将它们作为定式 HelloWorld _app= new HelloWorld(); _app.entereventdispatcher(); 在 main 函数后就是 HelloWorld 类的构建函数, 因为在 main 方法里建立了 HelloWorld 类的实例, 会调用 HelloWorld 类的构建函数, 所认我们可以认为该函数才是应用程序的入口在 HelloWorld 类的构建函数中我们新建了一个 MainScreen 类的实例如上所述 MainScreen 类是 BlackBerry API 中提供的系统类, 该类主要用于一般应用程序的主屏幕, 该类中已经实现了一些 BlackBerry 应用常用的基本方法, 如果菜单键响应等, 比较适合用于没有特殊要求的 BlackBerry 应用程序在新建 MainScreen 实例后, 我们新建了一个 LabelField 的实例并调用 MainScreen 类实例的 add 函数将 LabelField 实例添加到 MainScrren 的实例中 LabelField 是一个用于显示文本不可编辑的域最后, 我们调用 this.pushscreen 函数将新建的 MainScreen 实例显示出来这里的 this 就是指 HelloWorld 的实例, 因为 HelloWorld 继承了 UiApplication 类, 所以可以通过 HelloWorld 实例调用 UiApplication 类中已经定义好的 pushscreen 函数 24

25 } public HelloWorld() { MainScreen screen = new MainScreen(); LabelField label = new LabelField("Hello World!"); screen.add(label); this.pushscreen(screen); } 25

SDK 概要使用 Maven 的用户可以从 Maven 库中搜索 "odps-sdk" 获取不同版本的 Java SDK: 包名 odps-sdk-core odps-sdk-commons odps-sdk-udf odps-sdk-mapred odps-sdk-graph 描述 ODPS 基

SDK 概要使用 Maven 的用户可以从 Maven 库中搜索 odps-sdk 获取不同版本的 Java SDK: 包名 odps-sdk-core odps-sdk-commons odps-sdk-udf odps-sdk-mapred odps-sdk-graph 描述 ODPS 基开放数据处理服务 ODPS SDK SDK 概要使用 Maven 的用户可以从 Maven 库中搜索 "odps-sdk" 获取不同版本的 Java SDK: 包名 odps-sdk-core odps-sdk-commons odps-sdk-udf odps-sdk-mapred odps-sdk-graph 描述 ODPS 基础功能的主体接口, 搜索关键词 "odpssdk-core" 一些

BlackBerry Java 开发环境安装及入门 作者 : 邓明轩 俞伟 1

BlackBerry Java 开发环境安装及入门作者 : 邓明轩俞伟 1