blob: 0a4833a551595674cb72ef6fd32c254404f2da3a [file] [log] [blame]
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<!--
Copyright (c) 2009, 2010, Oracle and/or its affiliates. All rights reserved.
-->
<html>
<head>`
<title>Java ME MIDP 开发快速入门指南 - NetBeans IDE 教程</title>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" >
<link rel="stylesheet" type="text/css" href="../../../netbeans.css">
<meta name="author" content="">
</head>
<body>
<h1>Java ME MIDP 开发快速入门指南</h1>
<p>本教程将指导您完成使用 NetBeans IDE 创建 Java(tm) Platform, Micro Edition(Java(tm) ME 平台)移动信息设备配置文件 (MIDP) 应用程序的基本步骤,其目的是帮助您尽快着手开发 Mobile 应用程序。本教程引导您完成使用项目系统的一些基本步骤。我们向您介绍了两种方法来创建名为 "MyHello" 的 Java ME MIDP 项目,此项目在设备仿真器中显示文本 "Make My Day"。本教程可以帮助您做好使用其他 IDE 功能来开发 CLDC/MIDP 应用程序的准备。</p>
<p class="notes"><b>注:</b>如果您使用的是 NetBeans IDE 7.2 或 7.2.1,请参见《<a href="../../72/javame/quickstart.html">NetBeans IDE 7.2 或 7.2.1 Java ME MIDP 开发快速入门指南</a>》。</p>
<h3>目录</h3>
<img alt="此页上的内容适用于 NetBeans IDE 7.3" class="stamp" src="../../../images_www/articles/73/netbeans-stamp.png" title="此页上的内容适用于 NetBeans 7.3">
<ul>
<li><a href="#reqs" title="教程需求">教程需求</a></li>
<li><a href="#install" title="安装 Oracle Java ME SDK">使用 Oracle Java ME SDK 设置 IDE(仅限 Windows)</a></li>
<li><a href="#source" title="在源代码编辑器中创建应用程序">在源代码编辑器中创建应用程序</a></li>
<li><a href="#vmd" title="在 VMD 中创建应用程序">在可视 Mobile 设计器中创建应用程序</a></li>
<li><a href="#nextsteps" title="后续步骤">后续步骤</a></li>
</ul>
<h2><a name="reqs"></a>要求</h2>
<p><b>要学完本教程,您需要具备以下软件和资源:</b></p>
<table>
<tbody>
<tr>
<th class="tblheader" scope="col">软件或资源</th>
<th class="tblheader" scope="col">要求的版本</th>
</tr>
<tr>
<td class="tbltd1"><a href="http://www.netbeans.org/downloads/index.html" target="_blank">带有 Java ME 的 NetBeans IDE</a></td>
<td class="tbltd1">版本 7.3</td>
</tr>
<tr>
<td class="tbltd1"><a href="http://www.oracle.com/technetwork/java/javase/downloads/index.html" target="_blank">Java 开发工具包</a> (JDK)</td>
<td class="tbltd1">版本 6 或 7 </td>
</tr>
<tr>
<td class="tbltd1"><a href="http://www.oracle.com/technetwork/java/javame/javamobile/download/sdk/index.html">Oracle Java ME SDK</a></td>
<td class="tbltd1">取决于操作系统 </td>
</tr>
</tbody>
</table>
<p class="alert"><b>重要提示:</b>所需 Oracle Java ME SDK 版本因操作系统而异。</p>
<ul>
<li>NetBeans 7.3 的 Windows 分发未捆绑 Oracle Java ME SDK 3.2。</li>
<li>NetBeans IDE 的 OS X 版本随 Oracle Java ME SDK 3.0 for CLDC 捆绑提供。</li>
<li>NetBeans IDE 的 Linux 发行版随 Sun Java Wireless Toolkit 2.5.2 捆绑提供。</li>
</ul>
<h2><a name="install"></a>使用 Oracle Java ME SDK 设置 IDE(仅限 Windows)</h2>
<p class="alert"><b>重要提示:</b>此部分仅适用于 Windows 平台。</p>
<p>要在 Windows 平台上设置带有 Oracle Java ME SDK 的 NetBeans IDE,您需要: </p>
<ul>
<li>安装 Oracle Java ME SDK </li>
<li>在 NetBeans IDE 中激活 Java ME 功能</li>
<li>在 NetBeans IDE 中安装 Oracle Java ME 平台 SDK </li>
</ul>
<p><b>安装 Oracle Java ME SDK:</b></p>
<ol>
<li>访问 <a href="http://www.oracle.com/technetwork/java/javame/javamobile/download/sdk/index.html">Java ME SDK download</a>(Java ME SDK 下载)页。</li>
<li>单击 "Accept License Agreement"(接受许可协议)选项。</li>
<li>下载 <a href="http://download.oracle.com/otn-pub/java/java_me_sdk/3.2/oracle_java_me_sdk-3_2.exe">oracle_java_me_sdk-3_2.exe</a> 安装文件并将其保存到计算机上的任意位置。</li>
<li>双击此安装文件以运行安装程序,并按照说明操作。<br>安装完成后,Windows 系统托盘中会显示 "Java (TM) ME Platform SDK 3.2 Device Manager"(Java (TM) ME Platform SDK 3.2 设备管理器)图标 (<img alt="&quot;Java (TM) ME Platform SDK 3.2 Device Manager&quot;(Java (TM) ME Platform SDK 3.2 设备管理器)图标" border="1" src="../../../images_www/articles/73/javame/quickstart/icon.png">)。</li>
</ol>
<p><b>激活 Java ME 功能:</b> </p>
<ol>
<li>从 IDE 主工具栏中选择 "Tools"(工具)> "Plugins"(插件)。</li>
<li>在 "Plugins"(插件)对话框中,单击 "Installed"(已安装)标签,并在可用功能列表中选择 "Java ME"。
<p class="align-center"><a href="../../../images_www/articles/73/javame/imp-ng/plugins.png" rel="lytebox" title="&quot;Plugins&quot;(插件)对话框"> <img alt="&quot;Plugins&quot;(插件)对话框" border="1" src="../../../images_www/articles/73/javame/imp-ng/plugins-small.png"></a></p></li>
<li>单击 "Activate"(激活)。</li>
<li>在 "Installer"(安装程序)对话框的 "Welcome"(欢迎使用)面板上,单击 "Activate"(激活)。
<p class="align-center"><a href="../../../images_www/articles/73/javame/imp-ng/installer.png" rel="lytebox" title="&quot;Installer&quot;(安装程序)对话框"> <img alt="&quot;Installer&quot;(安装程序)对话框" border="1" src="../../../images_www/articles/73/javame/imp-ng/installer-small.png"></a></p></li>
<li>在成功完成激活过程后,单击 "Finish"(完成)。</li>
<li>单击 "Close"(关闭)以关闭 "Plugins"(插件)对话框。</li>
</ol>
<p><b>安装 Oracle Java ME 平台:</b></p>
<ol>
<li>选择 "Tools"(工具)> "Java Platforms"(Java 平台)。<br> 此时将显示 "Java Platform Manager"(Java 平台管理器)对话框。
<p class="align-center">
<a href="../../../images_www/articles/73/javame/imp-ng/jpmanager.png" rel="lytebox" title="&quot;Name and Location&quot;(名称和位置)面板"> <img alt="&quot;Name and Location&quot;(名称和位置)面板" border="1" src="../../../images_www/articles/73/javame/imp-ng/jpmanager-small.png"></a></p></li>
<li>单击 "Add Platform"(添加平台)。</li>
<li>在 "Add Java Platform"(添加 Java 平台)向导的 "Select Platform Type"(选择平台类型)中,选择 "Java ME CLDC Platform Emulator"(Java ME CLDC 平台仿真器)并单击 "Next"(下一步)。<br>IDE 随即会显示 "Choose directory to search for platforms"(选择要在其中搜索平台的目录)对话框。</li>
<li>选择要在其中安装 Java ME SDK 平台的目录(例如,<tt>C:\Java_ME_Platform_SDK_3.2</tt>),然后单击 "Open"(打开)。</li>
<li>在 "Add Java Platform"(添加 Java 平台)向导的 "Platform Folders"(平台文件夹)面板中,确保选择上一步骤中的所选平台,然后单击 "Next"(下一步)。</li>
<li>在 IDE 检测到平台之后,请立即在 "Add Java Platform"(添加 Java 平台)向导的 "Detected Platforms"(已检测到平台)面板中单击 "Finish"(完成)。
<p class="align-center">
<a href="../../../images_www/articles/73/javame/imp-ng/jpdetected.png" rel="lytebox" title="已检测到 J2ME 平台"> <img alt="已检测到 J2ME 平台" border="1" src="../../../images_www/articles/73/javame/imp-ng/jpdetected-small.png"></a></p>
现在将在 Netbeans IDE 中注册 Oracle Java ME 平台。
<p class="align-center">
<a href="../../../images_www/articles/73/javame/imp-ng/jpregistered.png" rel="lytebox" title="已注册 J2ME 平台"> <img alt="已注册 J2ME 平台" border="1" src="../../../images_www/articles/73/javame/imp-ng/jpregistered-small.png"></a></p></li>
<li>在 "Java Platform Manager"(Java 平台管理器)对话框中,单击 "Close"(关闭)。</li>
</ol>
<p>现在您已设置 NetBeans IDE,可以进行 Mobile 开发了。</p>
<h2><a name="source"></a>使用源代码编辑器创建 MIDP 应用程序</h2>
<div class="indent">
<p>使用源代码编辑器,可以手动创建 MIDlet 的代码。在源代码编辑器中创建代码会使您在编辑代码时获得更大的灵活性,并且可以插入预处理程序代码块。将使用新建项目向导和新建文件向导创建 <code>MyHello</code> 应用程序,并使用源代码编辑器完成代码。 </p>
<h3 class="tutorial">新建 Java ME MIDP 项目 </h3>
<ol>
<li>选择<tt>文件</tt> > <tt>新建项目</tt>。在“类别”下,选择 <tt>Java ME</tt>。在“项目”下,选择 <tt>Mobile 应用程序</tt>,然后单击“下一步”。</li>
<li>在“项目名称”字段中输入 <code>MyHelloMIDlet</code>(请注意,<code>MID</code> 采用的是大写字母)。指定项目位置。在本教程中,我们首选 <code>$PROJECTHOME</code> 目录。 </li>
<li>取消选中“创建默认包和主可执行类”复选框并单击“下一步”。 </li>
<li>选择默认仿真器平台,并对其余选项使用默认设置。单击“完成”。<br> IDE 将创建 <code>$PROJECTHOME/MyHelloMIDlet</code> 项目文件夹。此项目文件夹包含所有源代码和项目元数据,例如项目的 Ant 脚本。 </li>
<li>在“项目”窗口中,右键单击 <code>MyHelloMIDlet</code> 节点,然后选择<tt>新建</tt> > <tt>MIDlet</tt></li>
<li>输入 <code>HelloMIDlet</code> 作为 MIDlet 名称(请注意,默认情况下 "MID" 使用的不是大写字母)。单击“完成”。<br>此时会创建 <code>HelloMIDlet.java</code> 文件。 </li>
<li>双击 <code>HelloMIDlet.java</code> 文件以便在 IDE 编辑器窗口中显示源代码。</li>
<li>单击源代码编辑器,然后将 <code>public class HelloMIDlet extends MIDlet</code> 更改为
<pre class="examplecode">public class HelloMIDlet
extends MIDlet implements javax.microedition.lcdui.CommandListener
{</pre>
</li>
<li><code>startApp()</code> 方法前添加下面的文本:
<pre class="examplecode">
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, &quot;Hello Test Code&quot;, 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(&quot;Exit&quot;, javax.microedition.lcdui.Command.EXIT,
1);
}
return exitCommand;
}
javax.microedition.lcdui.TextBox helloTextBox;
javax.microedition.lcdui.Command exitCommand;
</pre>
</li>
<li><code>startApp()</code> 方法中添加 <code>initialize();</code> 代码行,使它如下所示:
<pre class="examplecode"> public void startApp() {
initialize();
}
</pre></li>
</ol>
<h3 class="tutorial">编辑 Java 源代码</h3>
<p>现在添加一些供 MIDlet 显示的文本。</p>
<p><code>get_helloTextBox()</code> 方法中,将示例代码 <code>Hello Test Code</code> 替换为您选择的文本(例如,<code>Make My Day.</code>)。</p>
<p class="notes"><b>注:</b>有关使用 NetBeans IDE Java 编辑器的代码帮助功能、定制选项和导航功能的完整指南,请参见 <a href="../java/editor-codereference.html">NetBeans IDE Java 编辑器中的代码帮助</a></p>
<h3 class="tutorial">编译并运行项目</h3>
<p>从 IDE 主工具栏中选择 <tt>Run</tt>(运行)> <tt>Run Project</tt>(运行项目)。在 "Output"(输出)窗口中观察项目编译的进度。注意 <code>HelloMIDlet.java</code> 文件在执行之前会先构建。设备仿真器随即打开以显示所执行的 MIDlet 的结果,其中会显示您在源代码中输入的文本。</p>
<p class="align-center"><a href="../../../images_www/articles/73/javame/quickstart/emulator.png" rel="lytebox" title="Java ME SDK 默认仿真器中的 &quot;Make my day&quot; 消息"> <img alt="Java ME SDK 默认仿真器中的 &quot;Make my day&quot; 消息" border="1" src="../../../images_www/articles/73/javame/quickstart/emulator-small.png"></a></p>
<p>要关闭 MIDlet 和仿真器窗口,请在仿真器窗口中选择 "Application"(应用程序)> "Exit"(退出)。</p>
</div>
<h2><a name="vmd"></a>使用可视 Mobile 设计器创建 MIDP 应用程序</h2>
<p>NetBeans IDE 提供一个使您可以快速创建 MIDP 项目的向导。创建此项目时,可以选择在可视 Mobile 设计器 (VMD) 或源代码编辑器中开发应用程序。使用 VMD,能够以可视方式规划应用程序流并设计应用程序使用的屏幕。在设计画布上保存更改时,设计器会自动创建应用程序的代码。 </p>
<p class="alert"><b>重要提示:</b>要在 IDE 中运行可视 Mobile 设计器,您需要按如下所示从更新中心安装可视 Mobile 设计器插件:</p>
<ol>
<li>从主菜单中选择“工具”>“插件”。</li>
<li>在“插件”对话框的“可用插件”标签中,选择“可视 Mobile 设计器”,然后单击“安装”。 </li>
<li>在“安装程序”对话框的欢迎页,单击“下一步”。 </li>
<li>在“许可证协议”页上,阅读与该插件相关的许可证协议。如果您同意所有许可证协议条款,请单击适当的选项,然后单击“安装”。</li>
<li>(可选)选择“在后台运行”选项以在后台运行安装。</li>
<li>在安装过程完成后,单击“完成”。 </li>
<li>在“插件”对话框中,单击“关闭”。</li>
</ol>
<h3 class="tutorial">创建 MIDP/CLDC 应用程序 </h3>
<ol>
<li>选择 <tt>File</tt>(文件)> <tt>New Project</tt>(新建项目)(Ctrl+Shift+N 组合键)。在 "Categories"(类别)下,选择 <tt>Java ME</tt>。在 "Projects"(项目)下,选择 <tt>Mobile Application</tt>(Mobile 应用程序),然后单击 "Next"(下一步)。</li>
<li>在 "Project Name"(项目名称)字段中输入 <code>MyHello</code>。使用默认 "Project Location"(项目位置),或者将它改为系统上您要选择的目录。在本教程中,我们首选 <code>$PROJECTHOME</code> 目录。 </li>
<li>选中 <tt>"Create Default Package and Main Executable Class"(创建默认包和主可执行类)</tt>复选框。单击 "Next"(下一步)。 </li>
<li>选择默认仿真器平台,并对其余选项使用默认设置。单击 "Finish"(完成)。 </li>
<li>IDE 将创建 <code>$PROJECTHOME/MyHello</code> 项目文件夹。此项目文件夹包含所有源代码和项目元数据,例如项目的 Ant 脚本。应用程序本身显示在可视 Mobile 设计器的 "Flow"(流)设计窗口中。
<p class="align-center"><a href="../../../images_www/articles/73/javame/quickstart/newjavameproject.png" rel="lytebox" title="IDE 中 Hello Midlet 的 &quot;Flow&quot;(流)视图"><img alt="IDE 中 Hello Midlet 的 &quot;Flow&quot;(流)视图" border="1" src="../../../images_www/articles/73/javame/quickstart/newjavameproject-small.png"></a></p>
<p class="notes"><b>注:</b>有关可用组件面板组件的完整描述,请参见<a href="http://wiki.netbeans.org/VisualMobileDesignerPalatteReference">可视 Mobile 设计器组件面板参考</a></p>
</li>
</ol>
<h3 class="tutorial">编辑 Java 源代码</h3>
<p>现在我们编辑 MIDlet 显示的文本。</p>
<ol>
<li><tt>HelloMIDlet.java</tt> 下方,单击 "Screen"(屏幕)以切换至 "Screen"(屏幕)视图,其中显示了 "Device Screen"(设备屏幕),这是应用程序中唯一可用的屏幕。 </li>
<li>在 "Device Screen"(设备屏幕)中单击 <tt>Hello World!</tt> 消息。在 "Properties"(属性)窗口中,单击 <tt>Hello World!</tt> 文本以更改欢迎消息文本,然后按 Enter 键。在本示例中,我们键入了 <tt>Make my day</tt>
<p class="align-center"><img alt="在 &quot;Properties&quot;(属性)窗口的文本字段中键入文本 &quot;Make my day&quot;。" src="../../../images_www/articles/73/javame/quickstart/stringedit.png"></p></li>
<li>"Screen"(屏幕)视图显示您在 "Text"(文本)字段中输入的文本的预览。
<p class="align-center"><a href="../../../images_www/articles/73/javame/quickstart/screen.png" rel="lytebox" title="VMD 的 &quot;Screen&quot;(屏幕)视图中 &quot;Device Screen&quot;(设备屏幕)预览中的 &quot;Make my day&quot;"><img alt="VMD 的 &quot;Screen&quot;(屏幕)视图中 &quot;Device Screen&quot;(设备屏幕)预览中显示的文本 &quot;Make my day&quot;。" border="1" src="../../../images_www/articles/73/javame/quickstart/screen-small.png"></a></p></li>
</ol>
<h3 class="tutorial">编译并运行项目</h3>
<ol>
<li>从 IDE 主工具栏中选择 <tt>Run</tt>(运行)> <tt>Run Project</tt>(运行项目)。在 "Output"(输出)窗口中观察项目编译的进度。注意 <code>HelloMIDlet.java</code> 文件在执行之前会先构建。设备仿真器打开,显示所执行的 MIDlet 的结果。设备仿真器启动 MIDlet 并显示您在源代码中输入的文本。
<p class="tips">可以指定用于运行 MIDlet 的仿真器,方法是:右键单击项目节点,然后从上下文菜单中选择 <tt>Run With...</tt>(运行方式...)。下面显示了 Java ME SDK 3.2 中提供的 <tt>JavaMEPhone1</tt></p>
<p class="align-center"><a href="../../../images_www/articles/73/javame/quickstart/emulator-screen.png" rel="lytebox" title="Java ME SDK 默认电话仿真器中显示的 &quot;Make my day&quot;"><img alt="Java ME SDK 默认电话仿真器中显示的 &quot;Make my day&quot;" border="1" src="../../../images_www/articles/73/javame/quickstart/emulator-screen-small.png"></a></p></li>
<li>在仿真器窗口中,选择 "Application"(应用程序)> "Exit"(退出)以关闭 MIDlet 和仿真器窗口。</li>
</ol>
<div class="feedback-box"><a href="/about/contact_form.html?to=6&subject=NetBeans%20MIDP%20Development%20Quick%20Start%20Guide">发送有关此教程的反馈意见</a></div>
<br style="clear:both;" >
<h2><a name="nextsteps"></a>后续步骤 </h2>
<p>有关介绍如何开发 MIDP 和 CLDC 应用程序的更多教程,请访问 Mobile 应用程序学习资源。</p>
<ul>
<li><a href="../../trails/mobility.html" target="_blank">NetBeans IDE Java ME 学习资源</a></li>
<li><a href="http://docs.oracle.com/javame/mobile/mobile.html" target="_blank">用于移动设备的 Java 文档</a></li>
<li><a href="http://docs.oracle.com/javame/developer/developer.html" target="_blank">Java ME 和 Java Card 文档</a></li>
</ul>
</body>
</html>