NetBeans 6.0 CLDC/MIDP 开发快速入门指南

最新推荐文章于 2024-04-26 14:00:07 发布

有家客栈

最新推荐文章于 2024-04-26 14:00:07 发布

阅读量391

点赞数

文章标签： netbeans 平台 java ide web mobile

（源自：http://www.netbeans.org/kb/60/mobility/quickstart_zh_CN.html）

NetBeans 6.0 CLDC/MIDP 开发快速入门指南

本文档介绍使用 NetBeans IDE 6.0 创建 Java™ Platform、Micro Edition（Java™ ME 平台）、Mobile Information Device Profile (MIDP) 应用程序的基础知识。本文档旨在于帮助您尽快入门。

以下教程介绍使用新项目系统的一些基本步骤。我们为您提供了两种方法来创建名为 MyHello 的 Java ME MIDP 项目，此项目在设备仿真程序中显示文本 Make my day。我们还将快速浏览一下 CLDC/MIDP 开发的其他 Mobility 功能。

需求

必须安装 NetBeans IDE 6.0 Mobility 或完整版本（下载），才能开始 Java ME MIDP/CLDC 开发。Client/Server 部分需要完整版本以实现 Web 服务支持。如果只安装 Mobility Edition，则需要从更新中心 (Tools > Plugins) 下载以下插件：

Web 应用程序
Web 服务
Sun Java 系统应用服务器

使用可视 Mobile 设计器创建 MIDP 应用程序

NetBeans IDE 提供了允许您快速创建 MIDP 项目的向导。创建项目时，可以选择在可视 Mobile 设计器(VMD) 或源代码编辑器中开发应用程序。

使用可视 Mobile 设计器允许您图形化地计划应用程序流程并设计应用程序使用的屏幕。此设计程序自动为应用程序创建代码。

创建 MIDP/CLDC 应用程序

选择“文件”>“新建项目”选项（Ctrl+Shift+N）。在“类别列表”中，选择“移动工具”选项。在“项目”列表中，选择“MIDP 应用程序”选项并单击“下一步”按钮。
在“项目名称”字段中输入 MyHello。将“项目位置”更改为您系统上的任意目录。在本教程中，我们将此目录称为 $PROJECTHOME。
选中“设为主项目”和“创建 Hello MIDlet”复选框（均默认选中）。单击“下一步”按钮。
选择 Sun Java Wireless Toolkit 2.52 for CLDC 作为“仿真器平台”，并使用其余默认值。单击“下一步”按钮。
展开 Configuration templates provided by installed CLDC platforms 和 Sun Java Wireless Toolkit 2.52 for CLDC 文件夹。选中每个配置旁边的框。IDE 自动为列出的每个模板创建新项目配置。
单击“完成”按钮。IDE 创建 $PROJECTHOME/MyHello 项目文件夹。项目文件夹包含所有源码和项目元数据，比如项目 Ant 脚本。应用程序本身将显示在可视 Mobile 设计器的“流设计”窗口中。

编辑 Java 源码

现在开始编辑 MIDlet 显示的文本。

单击“屏幕”。这将打开“屏幕设计器”窗口，并显示“设备”屏幕，这是此应用程序中惟一的可用屏幕。
在“属性”窗口中，单击“文本”字段并键入一些新文本。在本例中，键入了 Make my day。
Screen 视图显示在“文本”字段中输入的文本的预览。

编译并运行项目

从“运行”菜单中选择“运行”>“运行主项目”(F6)。在“输出”窗口中遵循项目编译的进程。注意，HelloMIDlet.java 文件在构建之后执行。设备仿真程序打开以显示已执行的 MIDlet 的结果。默认设备仿真程序是 DefaultColorPhone。
在设备仿真程序窗口中，单击“启动”命令下方的按钮。设备仿真程序启动 MIDlet 并显示在源码中输入的文本。
单击“退出”下方的按钮关闭 MIDlet。然后单击设备右上角中的按钮以关闭仿真程序窗口。

使用“源编辑器”创建 MIDP 应用程序

使用源代码编辑器，为 MIDlets 手动创建代码。在源代码编辑器中创建代码为您在编辑代码示提供了更多的灵活性，并允许您插入预处理器代码块。

现在，我们将使用“新建项目”和“新建文件”向导创建同一应用程序，并使用“源编辑器”完成代码。

创建新的 Java ME MIDP 项目

选择“文件”>“新建项目”（Ctrl-Shift-N）。在“类别列表”中，选择“移动工具”选项。在“项目”列表中，选择“MIDP 应用程序”选项并单击“下一步”按钮。
在“项目名称”字段中输入 MyHelloMIDlet（注意，MID 是大写字母）。将“项目位置”更改为您系统上的任意目录。在本教程中，我们将此目录称为 $PROJECTHOME。
选中“设为主项目”复选框，并取消选中“创建 Hello MIDlet”复选框。单击“下一步”按钮。
保留 J2ME 无线工具包为选中的“目标平台”。
展开 Configuration templates provided by installed CLDC platforms 和 2ME Wireless Toolkit 2.2 文件夹。选中每个配置旁边的框。IDE 自动为列出的每个模板创建新项目配置。
单击“完成”按钮。IDE 创建 $PROJECTHOME/MyHelloMIDlet 项目文件夹。项目文件夹包含所有源码和项目元数据，比如项目 Ant 脚本。
在 Explorer 窗口中右键单击 MyHelloMIDlet 节点并选择“新建”>MIDlet。
输入 HelloMIDlet 作为 MIDlet 名称（注意，MID 是大写字母）。单击“完成”按钮。HelloMIDlet.java 文件将创建。
双击 HelloMIDlet.java 文件以在 Editor 中显示源码。

在“源编辑器”中单击并将

public class HelloMIDlet extends MIDlet

更改为

public class HelloMIDlet
              extends MIDlet implements javax.microedition.lcdui.CommandListener
              {

在 startApp() 方法之前添加以下文本：

public HelloMIDlet() {
}private void initialize() {  javax.microedition.lcdui.Display.getDisplay(this).setCurrent(get_helloTextBox());}
public void commandAction(javax.microedition.lcdui.Command command, javax.microedition.lcdui.Displayable
  displayable) {   if (displayable == helloTextBox) {      if (command == exitCommand) {         javax.microedition.lcdui.Display.getDisplay(this).setCurrent(null);         destroyApp(true);         notifyDestroyed();      }   }
}
private javax.microedition.lcdui.TextBox get_helloTextBox() {   if (helloTextBox == null) {       helloTextBox = new javax.microedition.lcdui.TextBox(null, "Test String",120, 0x0);       helloTextBox.addCommand(get_exitCommand());       helloTextBox.setCommandListener(this);   }   return helloTextBox;}
private javax.microedition.lcdui.Command get_exitCommand() {   if (exitCommand == null) {       exitCommand = new javax.microedition.lcdui.Command("Exit", javax.microedition.lcdui.Command.EXIT,
  1);   }   return exitCommand;}
javax.microedition.lcdui.TextBox helloTextBox;javax.microedition.lcdui.Command exitCommand;

将行 initialize(); 添加到 startApp() 方法中，所以它将如下所示：
```
  public void startApp() {
   initialize();
    }
```

编辑 Java 源码

现在添加一些文本以让 MIDlet 显示。

在 get_helloTextBox() 方法中，将 test string 代码替换为所选的文本。例如，Make my day。

编译并运行项目

从“运行”菜单中选择“运行”>“运行主项目”(F6)。在“输出”窗口中遵循项目编译的进程。注意，HelloMIDlet.java 文件在构建之后执行。设备仿真程序打开以显示已执行的 MIDlet 的结果。默认设备仿真程序是 DefaultColorPhone。
在设备仿真程序窗口中，单击“启动”命令下方的按钮。设备仿真程序启动 MIDlet 并显示在源码中输入的文本。
单击“退出”下方的按钮关闭 MIDlet。然后单击设备右上角中的按钮以关闭仿真程序窗口。

更改仿真程序平台

仿真程序平台由移动电话制造商提供，所以开发人员可以在编码、调试和测试应用程序时模拟特定移动设备的行为。NetBeans Mobility Pack 包括 J2ME Wireless Toolkit，并支持可以从提供商站点下载的其他许多软件开发工具包 (SDK)，比如 Nokia、Sony Ericsson 或 Motorola。

更改默认仿真程序设备

右键单击 MyHello 项目节点并选择“属性”选项。在“属性”对话框中，选择“平台”节点。在此，可以更改默认配置的设备。
单击“设备”下拉列表并选择 QwertyDevice。单击“确定”。
重新运行应用程序，应用程序在 QwertyDevice 仿真程序中运行。

更改项目配置

使用“新建项目”向导中的模板创建了几个项目配置。可以使用主工具栏中的下拉“配置”菜单快速更改项目配置。

添加新仿真程序平台

从主工具栏中选择“工具”>“Java 平台”。
在“Java 平台管理器”对话框中，单击“添加平台”按钮。
在选择平台类型页面中，选择“Java ME MIDP Edition 平台仿真器”。单击“下一步”按钮。在“平台”页面中，IDE 搜索所有可用的 Java ME 平台，并在窗口中将其列出。符合 Unified Emluator Interface (UEI) 标准的平台经过验证并显示，且平台名称旁边的复选框具有复选标记。不符合 UEI 或因为其他原因无法安装的平台以红色列出。此向导还标识已经安装了哪些平台。注意：要安装不符合 UEI 的平台，单击“返回”按钮并选择“自定义 Java Micro Edition 平台仿真器”。
在“平台”页面中，在要安装的任何平台仿真程序旁边放置复选标记。检测到这些平台之后，就将其安装。单击“完成”按钮。然后单击 Close。
选择“文件”> "MyHello"“属性”。
选择“平台”节点，然后从“仿真器平台”下拉菜单中选择新仿真程序的名称（例如，J2ME Wireless Toolkit 2.2）。单击“确定”。

使用配置

可以使用配置为您的项目创建多组发行版 JAR 和 Java Application Descriptor (JAD) 文件。这允许您创建一组源码并为要编程的每个移动设备进行定制。

添加配置

右键单击 MyHello 项目节点并选择“属性”选项。在“属性”对话框中，从“项目配置”下拉列表中选择“添加配置”。这将打开“添加配置”对话框。
在“配置名称”字段中输入配置的名称。此名称应标识部署为此配置创建的 JAR/JAD 的目标平台。对于本例，输入 BlackWhiteDisplay 并单击“确定”。刚才已经创建了一个新的配置。
可以通过在“属性”对话框中单击“管理配置”按钮添加配置。这将弹出“项目配置管理器”对话框，其中包含用于添加、移除或复制配置的选项。

定制配置

可以根据需要在项目中添加任意多个配置。然后在“项目属性”对话框中为已添加的每个配置修改设置。

右键单击 MyHello 项目节点并选择“属性”选项。在“属性”对话框中，选择 Platform 节点。
从“属性”对话框顶部的配置组合框中选择 BlackWhiteDisplay 配置。
“平台”对话框中的组件全部禁用。这是因为此配置当前采用此面板的默认配置使用的值。取消选中面板顶部 DefaultConfiguration 选项中的“使用值”。此面板上的所有组件现在都可以编辑。
将“设备”选项更改为 DefaultGrayPhone。
切换“属性”对话框顶部的“项目配置”对话框，并观察“设备”选项基于当前所选配置的变化。这种配置定制方法适用于此对话框中的每个面板（常规面板除外）。单击“确定”保存配置更改并退出“属性”对话框。

创建功能

功能是项目配置的特定属性。它可以是屏幕大小等物理属性，也可以是配置支持的 API 或 JSR。可以创建新功能并将其与一个或多个项目配置相关联。然后使用预处理器代码块将特定代码与此功能相关联。如果需要添加或移除配置，则不必浏览所有代码并将配置与每个代码块相关联。相反，只需要将此功能添加到配置中。然后，此配置自动关联到与此功能相关联的任何代码块。

右键单击 MyHello 项目节点并选择“属性”。
从“类别”菜单树中选择“功能”页面。
从“项目配置”下拉菜单中选择配置。这将此功能与此配置相关联。
如果需要，取消选中“默认配置”复选框中的“使用值”。
单击“添加”按钮。这将打开“添加功能”对话框。
在“新建功能”对话框中，输入功能的名称，或从下拉菜单中选择功能。（可选）输入此功能的值。单击“确定”按钮关闭“新建功能”对话框。此功能现在已经与所选项目配置关联到一起了。

可以将此功能与其他配置相关联，方法是从“项目配置”菜单中选择不同的配置并单击“添加”按钮。

添加特定于配置的预处理器代码

预处理器块允许创建、管理和跟踪特定于一个或多个项目配置或功能的代码。此代码仅为您标识的配置或功能启用（或禁用）。

在 HelloMIDlet.java 编辑器窗口中，右键单击实例化文本框的源码 ( helloTextBox = new javax.microedition.lcdui.TextBox(null, "Make my day",120, 0x0);)。
右键单击此行并选择“预处理程序块”>“创建 If/Else 块”。在第一个粉色部分中，将词 Color 附加到 Hello World 字符串中。在第二个灰色部分中，将 Gray 添加到 Make my day 字符串中。
当活动配置与指令值（在本例中为 DefaultConfiguration）匹配时，由 //#if 预处理器指令标记的代码将生效。当活动配置与预处理器的值不匹配时，则使用由 //#else 预处理器指令包围的代码。换句话说，当活动平台是 DefaultConfiguration 时，仿真程序显示 Make my day Color，当活动平台是其他任何仿真程序平台时，显示 Hello World Gray。//#endif 预处理器指令完成预处理器块。
可以通过使用不同的仿真程序设备运行 MIDlet 来测试预处理器代码，如更改仿真程序平台所述。

运行配置

配置可以逐个构建和运行，也可以同时构建和运行。

右键单击 MyHelloMIDlet“项目”项目节点并选择“运行”选项。
使用工具栏中的配置组合框将配置更改为 BlackWhiteDisplay。再次选择“运行”。
两个仿真程序显示，一个彩色，一个灰色。灰色仿真程序显示 Make my day Gray，彩色仿真程序显示 Make my day Color。

要同时构建多个配置，右键单击项目并选择“批量编译”。在打开的对话框中，选中要构建的每个配置旁边的框。
要测试动态设备，右键单击项目并选择“作为...运行”。在打开的对话框中，选择要运行的仿真程序平台和设备。

将移动应用程序连接到 Web 服务

IDE 允许创建客户机 MIDlet，可以通过直接的“两层”体系架构连接到 Web 服务，或通过“三层”体系结构通过中间件 Web 应用程序连接到 Web 服务。

IDE 提供了用于创建连接类的两个向导：

如果要使用 JSR-172 Web Services 规范创建到 Web 服务的“两层”连接，则使用 Java ME Web Service Client 向导。此向导创建存根（客户端代理），还可以选择创建调用 web 服务的示例客户机 MIDlet。必须具有支持 JSR-172 规范的设备或仿真程序平台，才能使用此向导。
如果设备不支持 JSR-172 Web Services 规范，则使用 Mobile Client to Web Application Generator 创建到 Web 服务的“三层”连接。此向导生成连接到包括 web 服务客户机的 web 应用程序的 servlet。在使用 Mobile Client to Web Application Generator 之前，必须具有包括 Web 服务客户机的 Web 项目。

创建 Java ME Web Services (JSR-172) 客户机

在“新建文件”向导中，在“类别”下选择 MIDP。在“文件类型”下，选择 Java ME Web Service Client。单击“下一步”按钮。
标识要添加到项目中的 Web 服务的 WSDL 文件位置。
- 1. 选择“运行 Web 服务”，并为 WSDL 文件输入 URL，为检索到的 WSDL 输入本地文件名。
  2. 如果您位于防火墙后面，则单击“代理设置”指定适当的 HTTP 主机和端口。
  3. 单击“检索 WSDL”获得 WDSL 文件的本地副本。IDE 下载 WSDL 文件。
- 如果 WSDL 服务在 Web 上，则执行以下操作：
- 1. 从系统中选择 WSDL 文件并输入文件名。
  2. IDE 检索 WSDL 文件，页面上的其他字段植入从 WSDL 文件名中获得的默认名称。
- 如果您的环境中具有 WSDL 文件，则执行以下操作：
按“完成”。IDE 创建打开的设置文件并生成客户机存根。在主窗口中，可以看到可以选择的 Exported Services、Client Information 和 Client Options 的列表。

在一些罕见的情况下，可能需要将 CLDC 1.1 类型转换为 CLDC 1.0 类型，这意味着 Float 和 Double 类型转换为 String 变量。要进行转换，选中设置文件上的复选框 Convert floating point to String 并单击“生成桩”按钮。
如果位于防火墙后面，则没有可用于 NetBeans 中 HTTPS 代理的公共设置。通过从主菜单中选择“工具”>“选项”，可以更改 NetBeans 代理设置。但是，这些设置不传播到仿真程序。通过选择“工具”>“Java 平台”，可以设置 Wireless Toolkit 的代理。在“平台”下，选择“无线工具包”，然后选择“工具”&“扩展”选项卡。单击“打开首选项”按钮，然后选择“网络配置”选项卡。更改其他仿真程序的代理是相似的，但可能随供应商不同而有所不同。
生成的文件不应编辑。对文件的任何更改会在重新生成这些文件时丢失。

使用 Game Designer 创建游戏

可视 Mobile 设计器现在支持 MIDP 2.0 Gaming API。在 VMD 中，可以将瓷砖图层排列到场景中，并用动画精灵填充游戏。

开始之前，将要用于场景和精灵的所有图片保存到项目的 src 目录中。然后按以下步骤继续：

取消选中“创建 Hello MIDlet”选项，创建新 MIDP 项目。然后右键单击项目并选择“新建”>“文件”。在“类别列表”中，选择 MIDP 选项。在“文件类型”中，选择“可视游戏设计”选项。单击“下一步”按钮。
为新类提供一个名称并单击“完成”。
将打开“游戏生成器设计组件”屏幕。
单击“创建场景”。场景是游戏的一个级别。在“游戏设计器”中，一个空的场景将打开。
要创建瓷砖图层（场景环境），单击窗口右上角的“创建平铺层”按钮。注意，可以使用 IDE 附带的示例图片。要获得示例图片，单击“导入示例图像”按钮。
在弹出的对话框中，输入图层的名称，调整瓷砖的大小以匹配要编程的设备。然后单击“确定”。创建新瓷砖图层之后，拖放网格上的瓷砖以创建游戏的级别。