NetBeans Mobility 6.0 CDC 开发快速入门指南
简介
CDC 应用程序是指在内存至少为 2 MB 的手持式设备或无线设备上运行的应用程序。这种配置支持功能比移动电话更加丰富的 JVM,移动电话的内存通常为 128 到 512 KB,并且使用有限连接设备配置 (Connected Limited Device Configuration, CLDC)。
本文档将指导您使用 NetBeans IDE 创建一个在 Java ME 平台上运行的连接设备配置 (Connected Device Configuration, CDC) 应用程序。我们将介绍几种创建 Java ME CDC 项目(显示设备仿真器中的简单表单)的方法,每种方法对应一种配置文件。此外,我们还将讨论如何使用 NSICom CrEme VM for Windows CE 来创建此项目。本文档旨在帮助您尽快入门。
目录
需求
开始 Java ME CDC 开发之前,必须在您的系统中安装 NetBeans 6.0 Mobility 或 NetBeans 6.0 完整版本(下载)。“客户机/服务器”一节需要完整版本提供的 Web 服务支持。如果只安装 Mobility Edition,则需要从更新中心(“工具”>“插件”)下载以下插件:
- Web 应用程序
- Web 服务
- Sun Java 系统应用服务器
- 针对 CDC 或其他 CDC 仿真器平台的 Sun Java Toolkit 阅读“添加仿真器平台”一节了解详细信息。
添加仿真器平台
NetBeans Mobility Pack 支持以下仿真器平台:
- Sun Java Toolkit for CDC 1.0 ( 参见安装说明)
- Ricoh Embedded Software Architecture Emulator 1.14c
- Sony Ericsson CDC Platform UIQ SDK 3
- Sony Ericsson M600 和 P990 设备
- Nokia Series 80 Platform SDK for Symbian OS, for Java, Personal Profile
- CrEme VM for Windows CE
NetBeans 6.0 CDC 平台安装指南 中列出了添加仿真器平台的说明。
创建 CDC 应用程序
在本部分中,我们将为每个可用配置文件创建一个 CDC 应用程序项目,对于个人平台和 AGUI 平台,将使用 IDE 的 GUI 生成器为应用程序创建 GUI。
其中配置文件包括:
创建一个新的 CDC 应用程序-个人配置文件
在此,将使用 Nokia Series 80 Platform SDK for Symbian OS, for Java, Personal Profile 为个人配置文件创建一个 applet。Sony Ericsson 平台也支持个人配置文件。
- 选择“文件”>“新建项目”选项(Ctrl+Shift+N)。在“类别”列表中,选择“移动工具”选项。在“项目”列表中,选择“CDC应用程序”模板。单击“下一步”按钮。
- 将项目命名为 S80CdcApplication,并在计算机上为该项目指定位置。将“创建主类”复选框保留为选中状态。单击“下一步”按钮。
- 在“选择平台”页面中,选择“Nokia S80 平台”。
- 单击“完成”按钮。IDE 将创建新的应用程序,并在 GUI 生成器中打开主类窗体,如下图所示。单击“源”窗格查看 applet 的源代码。请注意,生成的代码基于配置文件。在本例中,主类是从
java.awt.Frame 派生的。
使用 Project Matisse GUI 生成器创建应用程序界面
您可以采用与常规 J2SE 开发相同的方式来使用 Project Matisse GUI Builder。在“GUI 生成器”中,右键单击 "Main.java" 窗体并选择“设置布局”>“自由设计”。然后将组件从“组件面板”窗口拖放到“GUI 生成器”的“设计区域”。确保在窗体中仅使用 AWT 组件。由于所有 Nokia Series 80 设备都支持个人配置文件,因此只有 AWT 小部件可用。
有关使用 IDE 的 GUI 生成器的更多信息,请参见 Java GUI 和 Project Matisse 教程。
完成以上操作后,在“项目”窗口中右键单击项目,然后选择“运行项目”。设备仿真器的“应用程序”菜单中应显示您的应用程序。现在,可在仿真器中运行此设备。
您还可以调试项目,并使用 JUnit 框架创建和调试测试。
创建一个新的 CDC 应用程序-AGUI 配置文件
在此,我们将使用 Sun Java Toolkit for CDC 1.0 为 AGUI 配置文件创建一个 CDC 应用程序或 Xlet。
- 从主菜单选择“文件”>“新建项目”选项。
- 从“类别”列表中,选择“移动工具”选项。从“项目”中选择“CDC 应用程序”。单击“下一步”按钮。
- 在“名称和位置”页中:
- 将项目命名为
newcdc。
- 将主类名更改为
newcdc.Mainxlet。
- 清除“设置为主项目”和“创建主类”的复选框标记。
- 在“选择平台”页中,使用下拉菜单选择
Sun Java Toolkit for Connected Device Configuration for the Java Platform and DefaultColorPhone 作为设备。保留配置文件设置为默认值。
- 单击“完成”按钮。IDE 将创建新的应用程序,并在 GUI 生成器中打开主类。
使用 Project Matisse GUI 生成器创建应用程序界面
您可以采用与常规 J2SE 开发相同的方式来使用 Project Matisse GUI Builder。在“GUI 生成器”中,右键单击 "Main.java" 窗体并选择“设置布局”>“自由布局”。然后将组件从“组件面板”窗口拖放到“GUI 生成器”的“设计区域”。确保在窗体中仅使用 Swing 组件。由于 AGUI 平台支持 Swing,因此只有 Swing 小部件可用。
有关为 CDC 应用程序创建 GUI 的更多信息信息,请参见 使用 NetBeans Mobility Pack for CDC 进行 GUI 设计:
完成以上操作后,在“项目”窗口中右键单击项目,然后选择“运行项目”。设备仿真器中应显示您的应用程序。
您还可以调试项目,并使用 JUnit 框架创建和调试测试。
创建一个针对 Windows CE 的 CDC 应用程序-AGUI 配置文件(使用 CrEme VM)
可以使用 NSIcom CrEme VM 为运行 Windows CE 的设备创建和运行 Java Swing 应用程序。applications for devices running Windows CE.
创建应用程序
- 从主菜单选择“文件”>“新建项目”选项。
- 在“类别”列表中,选择 "CDC" 选项。在“项目”列表中,选择“CDC应用程序”模板。单击“下一步”按钮。
- 在“名称和位置”页面中,将项目命名为
cremeapp。单击“下一步”按钮。
- 在“选择平台”页中,选择 "JSCP V4.10"。单击“下一步”按钮。
- 在“资源管理器”窗口中,右键单击项目的“源包”节点并选择“新建”>“JFrame表单”。单击“完成”按钮。NetBeans GUI 生成器(Matisse)将显示新表单。
注意:确保在 CrEme 默认仿真器中运行应用程序时 main() 方法中的第一段代码如下所示。这些代码将确保正常加载 Swing。
try {
UIManager.setLookAndFeel(UIManager.getCrossPlatformLookAndFeelClassName());} catch(Exception exception) {
System.out.println("Error loading L&F: " + exception);
}
-
使用 Project Matisse GUI 生成器创建应用程序。您可以采用与常规 J2SE 开发相同的方式来使用 Project Matisse GUI 生成器。
注意,如果异常导致仿真器意外中止,则仿真器将打印输出异常消息并等待用户按键操作。但是,用户不能通过 IDE 发送按键指令。必须通过“进程管理器”关闭 VM。
在设备或仿真器中编译和运行应用程序
- 使用电缆或蓝牙连接到您的移动设备。如果有移动设备,请直接跳到步骤 12。如果没有移动设备,请按照 NetBeans Mobility Pack for CDC 5.5.1 安装指南 安装 Microsoft Device Emulator 和 Virtual Machine Network Driver for the Microsoft Device Emulator。然后完成步骤 2 到 4。如果有移动设备,请直接跳到步骤 5。
- 启动 Microsoft Device Emulator,方法是选择“开始”>“程序”>"Microsoft Windows Mobile 5.0 MSFP Emulator Images">"Pocket PC Coldboot"。这样将打开 Pocket PC 仿真器。
- 选择“启动”>“程序”>"Microsoft Windows Mobile 5.0 MSFP Emulator Images">"Device Emulator Manager"。这样将打开 Device Emulator Manager 仿真器。
- 在 Device Emulator Manager 中,选择 Actions > Cradle。
- 单击应用程序托盘上的图标打开 ActiveSync。如果未安装 ActiveSync,请按照 NetBeans Mobility Pack for CDC 5.5.1 安装指南 中的步骤安装该工具。
打开 ActiveSync 时,它会检测并连接到设备或设备仿真器。如果未自动检测:
- 单击应用程序托盘上的图标打开 ActiveSync。
- 选择 File > Connection 选项。
- 执行以下操作:
- 选中 Allow 连接下面的复选框并为仿真器选择 DMA、USB或实际设备的端口号。
- 选择 Run Connect 启动自动检测设备。
- 下载 CrEme VM 并将它安装到设备中(下载)。双击下载的文件。它将同时安装到您的 PC 和设备中。
- 从 NSIcom下载 Swing 扩展(
CrE-ME410_swing.CAB)并将它安装到您的设备中(下载)。
将 Swing 扩展安装到您的设备或设备仿真器中。
- 在 ActiveSync 对话框中,选择 Tools > Explore Device 选项。Mobile Device 将在资源管理器窗口中打开。
- 将
CrE-ME410_swing.CAB 复制到资源管理器窗口中。
- 在设备或设备仿真器中,选择“开始”>“程序”>“文件资源管理器”
- 启动 CrE-ME410_swing.CAB。
运行应用程序
- 右键单击项目并选择“属性”选项。此时将打开“属性”页面。
- 在“类别”列表中,选择“运行”选项。
- 选择 NSIcom 选项卡并选中“远程VM运行”选项。单击“确定”按钮关闭“属性”页面。
- 选择“运行”>“运行主应用程序”。
使用配置
可以使用配置为项目创建多组 JAR 和 Java Application Descriptor (JAD) 文件。这样,我们便可创建一组源代码,并通过定制让它用于各个不同的移动设备。
下面的方法是通用的,但是通过之前描述的平台实现的。
添加配置
- 右键单击“项目”节点并选择“属性”选项。在“属性”对话框中,从“项目配置”下拉列表中选择“添加配置”。此时将打开“添加配置”对话框。
- 在“配置名称”字段中输入配置的名称。该名称应能标识部署为该配置创建的 JAR/JAD 的目标平台。在本例中,输入
BlackWhiteDisplay 并单击“确定”按钮。刚才已经创建了一个新配置。
- 还可以通过单击“属性”对话框中的“管理配置”按钮来添加配置。这将打开“项目配置管理器”对话框,其中含有添加、移除或复制配置等选项。
定制配置
我们可以在项目中添加任意数量的配置。然后可以在“项目属性”对话框中修改各个配置的设置。
- 右键单击“项目”节点并选择“属性”选项。在“属性”对话框中,选择“平台”节点。
- 从“属性”对话框顶部的配置组合框中选择
BlackWhiteDisplay 配置。
- “平台”对话框中的组件都是禁用的。这是因为该配置目前认为面板中都是默认配置的值。取消选中面板顶部“默认配置”选项中的“使用值”。现在,该面板中的所有组件都可以编辑了。
- 将 Device 选项修改为 DefaultGrayPhone。
- 切换“属性”对话框顶部的“项目配置”对话框,注意到 Device 选项将根据当前选中的配置变化。这种配置定制方法适用于对话框中的各个面板(除了通用面板)。单击“确定”按钮保存配置修改并退出“属性”对话框。
创建功能
功能 是项目配置的具体属性。它可以是屏幕大小等物理属性,也可以是配置支持的 API 或 JSR。可以创建一个新功能并将它关联到一个或多个项目配置。然后,可以使用预处理代码块将特定代码送到到该功能。如果以后需要添加或删除配置,则不用查找所有代码并将配置与各个代码块关联。我们只需将该功能添加到配置即可。然后,配置将版关联到与功能关联在一起的代码块。
- 右键单击“项目”节点并选择“属性”选项。
- 从“类别”菜单树中选择“功能”页面。
- 从“项目配置”下拉菜单中选择一个配置。这就是与功能关联在一起的配置。
- 如有必要,取消选中 "DefaultConfiguration" 复选框中的“使用值”选项。
- 单击“添加”按钮。
此时将打开“添加功能”对话框。
- 在“新建功能”对话框中,为功能输入一个名称,或者从下拉列表中选择一个功能。Optionally, enter a value for the ability.
单击“确定”按钮关闭“新建功能”对话框。该功能现在已经与所选项目配置关联到一起了。
可以将该功能关联到其他配置,方法是从“项目配置”菜单中选择不同的配置并单击“添加”按钮。
运行配置
可以单独运行和生成配置,也可以同时操作多个配置。
- 右键单击“项目”节点并选择“运行”选项。
- 使用工具栏中的配置组合框修改配置。再次选择“运行”选项。
- 此时将出现两个仿真器,分别对应各自的配置。
更多信息
除了 IDE 中内建的关于 Java ME CDC 开发的帮助文档外,以下链接也提供了关于 Mobility 包的技术教程和文章: