示例所需的软件如下：

• 带有 NetBeans Mobility Pack 4.0 或 FCS 的 NetBeans™ 集成开发环境 (IDE)。
  您可以从 NetBeans 下载站点获得此软件：http://www.netbeans.org/downloads/index.html
• Java™ 2 软件开发工具包标准版 (J2SE™ SDK), v. 1.4.2 或更高版本
  您可以从以下站点获得 J2SE SDK：http://java.sun.com/j2se/downloads.html
• J2ME™ Wireless Toolkit 2.0 或更高版本
  J2ME Wireless Toolkit 随 NetBeans Mobility Pack 一起安装。您还可以从以下站点获得 Wireless Toolkit：http://java.sun.com/products/j2mewtooklit/index.html。
• 用于 Symbian OS 的 Nokia Series 60 SDK
  可以从以下站点获得：http://www.forum.nokia.com/main/0,6566,034-483,00.html
• SDK 可用于以下一种或多种产品：Nokia Series 40、Nokia Series 80、Nokia Series 90、Motorola SDK4.1 for J2ME GA、Vodafone
  • 您可以从以下站点获得 Motorola SDK4.1 for J2ME GA：http://www.motocoder.com/motorola/pcsHome.jsp?node_name=SDK（需要注册）
  • 您可以从以下站点获得 Nokia SDK：http://www.forum.nokia.com/main/1,6566,030,00.html。在“按技术领域查看工具”下拉框中选择 Java。
  • Vodafone SDK 只可用于全球合作伙伴，不能通过简单的联机注册获得。

使用下载站点提供的说明安装该软件。

要启动 NetBeans IDE，请执行以下操作：

• 在 Microsoft Windows 上
  选择“开始”>“程序”>“NetBeans版本”> "NetBeans IDE"。
• 在 UNIX 或 Linux 环境上
  在终端窗口中，键入 sh IDE-install-path/bin/runide.sh

IDE-install-path 变量代表 IDE 起始目录的路径。

MarvTheMiner_120_all.zip 文件包含原始 Marv The Miner 应用程序的源文件。该 zip 包括一个 MarvTheMiner 目录，其中包含您将在本教程中使用的 src 和 res 子目录。

要解压缩 MarvTheMiner_120_all.zip 文件，请执行以下操作：

1. 在您的文件系统中，创建一个临时位置，用于放置 MarvTheMiner_120_all.zip 的内容。
   例如，在本教程中，该目录指的是 C:\temp 目录。
2. 使用用于解压缩文件的应用程序将 MarvTheMiner_120_all.zip 文件解压缩到 temp 目录。
   temp 目录现在拥有 MarvTheMiner 目录，其中包含以下文件和子目录：

   文件或子目录	描述
   src	构成 Marv The Miner 程序的源文件。
   res	包含该程序所使用的资源文件。其中包括图，以及用于定义游戏级别布局的 .map 文件。
   MarvEditor	级别编辑器（不在本教程的讨论范围之内）。
   Nokia.full	该游戏的 Nokia 生成形式。
   MIDP.full	该游戏的一般 MIDP 生成形式。

   
   
3. 将 res 目录移动到 C:/temp/MarvTheMiner_120_all/src/。为了在创建新的 NetBeans 项目之后确保资源文件保持正确的相对路径，可以使用这种简单的解决方法。

第一步是在 NetBeans IDE 中创建一个新项目。

1. 从主菜单中选择“文件”>“新建项目”。
   将显示“新建项目”向导。
2. 在“类别”列表中选择“移动”。然后选择“来自现有 MIDP 源的移动项目”，并单击“下一步”。
3. 如果未使用安装程序安装 NetBeans，则此处将显示一个面板，指导您安装移动平台。按照说明执行操作，并安装某些版本的 Wireless Toolkit。然后单击“下一步”。
4. 对于“导入的源的位置”，单击“浏览”按钮并导航至您在解压缩 MarvTheMiner_120_all.zip 文件时创建的 C:/temp/MarvTheMiner_120_all/src 目录。选择 src 目录，然后单击“打开”。单击“下一步”。
5. 输入新项目的名称。例如，将其命名为 MarvTheMiner。
6. 现在，选择新项目目录所在的目录。确保已选中“设置为主项目”复选框，并单击“完成”。
   将创建新项目 MarvTheMiner，并且显示在 IDE 的“项目”标签中。
7. 展开 MarvTheMiner 根项目节点，以查看该项目的源和资源。展开 <缺省包> 节点，然后双击 Main.java，以在编辑器中打开该文件。

1. 右键单击 MarvTheMiner 项目节点，并选择“属性”。
   此时将打开“项目属性”页面，用于控制项目多方面的内容。
2. 单击该页顶部的“管理配置”按钮。此时将打开“管理配置”对话框。
3. 单击“添加”，然后键入 NokiaSeries60 并按“确定”。
4. 对于 Motorola、Vodafone 和 NokiaOther 重复前面的步骤。单击“关闭”可关闭“管理配置”对话框。

位于“项目属性”页顶部的“项目配置”组合框现在应该包含五种配置。我们马上会使用这些设置，但是现在要向 IDE 添加一些仿真器。

要使用已经安装在计算机上的仿真器平台运行项目，首先必须在 IDE 中进行注册。

1. 在“项目配置”组合框中选择 "DefaultConfiguration"，然后选择“平台”节点。单击“管理仿真器”按钮。将出现“平台管理器”对话框。

   请注意，还可以从“工具”>“Java 平台管理器”的主菜单访问该对话框。

2. 单击“添加平台”，并导航至安装 Nokia Series 60 仿真器的目录。单击“下一步”。
3. 确保仿真器设置检测正确，然后单击“下一步”。
4. 如果需要，在此您可以指向该仿真器的源文件和 javadoc 文件。否则，只需单击“完成”，以完成该平台的安装。

5. 对于您的机器上已经安装的每个仿真器平台，以及要通过 IDE 使用的每个仿真器平台重复这些步骤。

   

   请注意，IDE 只能检测到符合 UEI 标准的仿真器。遗憾的是，这意味着不能检测开发人员用于 Marv The Miner 的 Motorola 7.5 仿真器。本教程后面的章节将介绍通过 IDE 使用不符合 UEI 的仿真器的解决办法。

可以针对每个项目配置单独定制“项目属性”页上的每个面板。缺省情况下，配置将使用在缺省配置中定义的设置。

1. 打开“项目属性”页，并选择“平台”面板。确保在“项目配置”组合框中选中 "DefaultConfiguration"。
2. 在“仿真器平台”组合框中选择 "J2ME Wireless Toolkit 2.x"。将单选按钮切换为 CLDC-1.0 和 MIDP-2.0。
   缺省情况下，所有配置将使用此仿真器来生成和执行项目。然而，这并不是我们想要的结果，因为代码引用几个特定于平台的库。
3. 从“项目配置”组合框中选择 NokiaSeries60 配置。
   “平台”面板现在完全灰显。这是因为当前对此面板使用 "DefaultConfiguration" 中的值。
4. 取消选中该面板顶部的“使用 "DefaultConfiguration" 中的值”复选框。
   该面板中的所有元素现在将处于启用状态。从“仿真器平台”组合框中选择 Series 60 MIDP Concept SKD Beta 0.3.1 Nokia 平台。

   如果在各个配置之间进行切换，您将看到，现在除了 NokiaSeries60 配置之外，所有配置都使用在 DefaultConfiguration 中指定的值。如果您更改了“DefaultConfiguration 平台”面板中的任何配置设置，所做的更改将传播到除 NokiaSeries60 之外的所有配置。

5. 在“项目配置”组合框中选择 "NokiaOther" 配置。取消选中“使用 "DefaultConfiguration" 中的值”复选框，并选择一个您安装的其他 Nokia 平台。
6. 也可以针对 Vodafone 平台重复这些步骤。
7. 如上所述，Motorola 7.5 仿真器不符合 UEI，因此不能安装到 IDE 中。然而，为了进行编译，我们仍然可以指向其 API。激活 Motorla 配置，并选择“库和资源”面板。
8. 取消选中“使用 "DefaultConfiguration" 中的值”复选框。
9. 单击“添加 Jar/Zip”，并导航至 {motorola 安装目录}\Emulator7.5\lib。选中每个 .zip 文件（使用 Ctrl+ 鼠标），然后单击“打开”。
10. 单击“确定”退出项目属性。现在您已经完成项目配置的创建任务。

设备破碎解决方案的第二部分是能够指定源文件中的某些代码块，以使其特定于一个或多个配置。通过使用右键单击编辑器上下文菜单中的操作或通过“编辑”>“预处理程序块”菜单可以完成此任务。

1. 打开 Main.java，并检查 initStaticData() 方法。此处，该方法确定在运行时中哪些特定于设备的 API 可用，并随后执行相应的操作。这是一个非常智能的解决方案，可以解决设备破碎某些部分的问题。遗憾的是，该解决方案也存在会添加分发 Jar 的大小，从而影响运行时性能及提高源复杂性的问题，并且不能解决所有分段问题（您随后会看到这一点）。

   以下是 initStaticData() 的相关部分：

   vendor = 0;
   try
      {
   // Nokia
   Class.forName("com.nokia.mid.sound.Sound");
   vendor = 1;
   try
          {
   Class.forName("com.nokia.mid.ui.DeviceControl");
   com.nokia.mid.ui.DeviceControl.setLights(0,100);
   vendor = 2;
          }
   catch(Exception ex2){}
      }
   catch(Exception ex){}
   
   try
      {
   // Vodafone
   Class.forName("com.vodafone.v10.system.device.DeviceControl");
   com.vodafone.v10.system.device.DeviceControl.getDefaultDeviceControl().
   setDeviceActive(com.vodafone.v10.system.device.DeviceControl.BACK_LIGHT,
   true);
   vendor = 3;
      }
   catch(Exception ex){}
   
   try
      {
   // Motorola
   Class.forName("com.motorola.multimedia.Vibrator");
   Class.forName("com.motorola.multimedia.Lighting");
   com.motorola.multimedia.Lighting.backlightOn();
   vendor = 4;
      }
   catch(Exception ex){}
                       

2. 删除所有只涉及确定程序在哪个设备上运行的功能，因此剩下的代码如下：

    // Nokia
   com.nokia.mid.ui.DeviceControl.setLights(0,100);
   
   // Vodafone
   com.vodafone.v10.system.device.DeviceControl.
   	getDefaultDeviceControl().
   	setDeviceActive(com.vodafone.v10.system.device.DeviceControl.BACK_LIGHT,
   			true);
   
   // Motorola
   com.motorola.multimedia.Lighting.backlightOn();
                       

   现在您拥有与不同配置关联的三个代码块。

3. 突出显示特定于 Motorola 的行，然后右键单击编辑器，并选择“预处理程序块”> "Motorola"。
4. 对于 Vodafone 块重复此步骤（“预处理程序块”> "Vodafone"）。
5. 对于 Nokia 代码，选择“预处理程序块”>“管理预处理程序块”。
   此时将打开“管理预处理程序块”对话框。
6. 选择 "NokiaOther" 和 "NokiaSeries60" 的选项，然后单击“确定”。

   这些代码块现在与预处理程序块的页眉和页脚中列出的配置相关联。如果活动配置是预处理程序块页眉和页脚的一部分，则更改项目的活动配置将触发一个预处理程序，该程序将注释或注释掉所基于的块。

   

7.  通过使用主工具栏中的组合框可更改项目的活动配置。
   还可以通过从主“生成”菜单中的相同菜单右键单击项目节点 >“设置活动项目配置”> 选择配置，或通过切换主工具栏中的“配置”组合框（如果项目当前是主项目）来完成此操作。
   
   请注意，代码块突出显示的颜色将发生变化，以标识哪些块处于活动状态，哪些块处于非活动状态。活动配置名称也将在代码块的页眉/页脚中突出显示一个不同的颜色。
   
8. 从 beep() 方法中删除 class.forName() 的所有实例。如果还要精简 if 块，则剩下以下代码：

   if (midlet.muteSound == 0)
   {
   // Nokia 3650, 7650
   com.nokia.mid.sound.Sound sound = new com.nokia.mid.sound.Sound(1000,100);
   sound.play(1);
   // All other Nokias
   com.nokia.mid.sound.Sound sound = new com.nokia.mid.sound.Sound(1000,100);
   sound.play(1);
   
   }
   
   if (midlet.useVibra == 1)
   {
   // Nokia
   com.nokia.mid.ui.DeviceControl.startVibra(50,500);
   // Vodafone SDK
   com.vodafone.v10.system.device.DeviceControl.
   	getDefaultDeviceControl().
   		setDeviceActive(
   			com.vodafone.v10.system.device.DeviceControl.VIBRATION,
   			true);
   vibra_delay = 10;
   
   // Motorola 7.5
   com.motorola.multimedia.Vibrator.
   	setVibrateTone(
   		com.motorola.multimedia.Vibrator.VIBRATE_LONG);
   com.motorola.multimedia.Vibrator.vibrateFor(500);
   
   }
   

   您应该能够将每个块与正确配置相关联。切记将 Nokia 振动控制调用与两个 Nokia 配置相关联。

9. run() 方法也包含特定于 Vodafone 的调用。删除 try/catch 块，并将这两行与 Vodafone 配置相关联。
   

   我们马上就能完成任务了。最后一步是以某种方式来处理 Nokia 的 FullCanvas。

10. 激活 NokiaSeries60 配置。
11. 右键单击 FullCanvas 声明，并选择“创建 If/Else 程序块”(NokiaSeries60)。
12. 右键单击第一个块，并添加 NokiaOther。
13. 右键单击第二个块，并添加 NokiaOther。
14. 第二个块是倒置的块。将此倒置的块类定义更改为 extend Canvas。

完成后，类定义如下：

此时，我们应该能够针对所有配置编译和运行该程序。单击主工具栏上的任何图标将对活动配置执行所选的操作。

1. 在主菜单中，选择“生成”>“生成所有主项目配置”。
   假设所有项目均已正确设置，现在应该可以生成所有配置了。

   如果您不能访问包含正确 API 的一个或多个仿真器平台，则此步骤可能失败。如果出现这种情况，您应该手动注释掉任何对不存在的 API 进行的调用。

   如果您未按照这些步骤手动安装不符合 UEI 的仿真器一节中描述的 Motorola 仿真器，则针对 Motorola 配置的预校验将失败。为了在不手动添加仿真器的情况下进行此配置的编译，您可以注释掉所有 motorola API 调用，并从“库和资源”面板中删除 motorola 库。

2. 选择 IDE 左上方的“文件”标签，并展开 dist 文件夹。在此文件夹中，您应该拥有包含每个已成功生成配置的 Jar/JAD 的目录，以及代表 DefaultConfiguration 生成的 Jar/Jad。
3. 按 F5 可采用当前选定的配置运行该程序。您可以切换配置，并再次按 F5，同时运行该程序的多个版本。