blob: 2a8cd8a1e8867bcc8e847a32207ee34198d655cc [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 Information Device Profile)アプリケーションを作成する手順を概説します。このチュートリアルは、できるだけすばやくモバイル・アプリケーション開発を始められるように作成されています。このチュートリアルでは、プロジェクト・システムを使用した基本的な作業手順の一部を学ぶことができます。デバイス・エミュレータに「Make My Day」というテキストを表示する、「MyHello」という名前のJava ME MIDPプロジェクトを作成する2通りの方法を示します。このチュートリアルを終了すると、IDEが備えているCLDC/MIDPアプリケーション開発用の他の機能を使用する準備が整います。</p>
<p class="notes"><b>注意: </b>NetBeans IDE 7.3または7.3.1を使用している場合は、<a href="../../73/javame/quickstart.html">NetBeans IDE 7.3 Java ME MIDP開発のクイック・スタート・ガイド</a>を参照してください。</p>
<h3>内容</h3>
<img alt="このページの内容は、NetBeans IDE 7.4に適用されます" class="stamp" src="../../../images_www/articles/74/netbeans-stamp.png" title="このページの内容は、NetBeans 7.4に適用されます">
<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でのアプリケーションの作成">ビジュアル・モバイル・デザイナでのアプリケーションの作成</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">NetBeans IDEとJava ME</a></td>
<td class="tbltd1">バージョン7.4</td>
</tr>
<tr>
<td class="tbltd1"><a href="http://www.oracle.com/technetwork/java/javase/downloads/index.html" target="_blank">Java Development Kit</a> (JDK)</td>
<td class="tbltd1">バージョン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>
<table>
<tbody>
<tr>
<th class="tblheader" scope="col">プラットフォーム</th>
<th class="tblheader" scope="col">必要なSDKのバージョン</th>
</tr>
<tr>
<td class="tbltd1">Microsoft Windows</td>
<td class="tbltd1"><a href="http://www.oracle.com/technetwork/java/javame/javamobile/download/sdk/index.html">Oracle Java ME SDK 3.4</a></td>
</tr>
<tr>
<td class="tbltd1"> Mac OS X</td>
<td class="tbltd1"><a href="http://www.oracle.com/technetwork/java/javame/downloads/sdk30-mac-jsp-137878.html">Oracle Java ME SDK 3.0</a></td>
</tr>
<tr>
<td class="tbltd1">Linux</td>
<td class="tbltd1"><a href="http://www.oracle.com/technetwork/java/download-135801.html">Sun Java Wireless Toolkit 2.5.2</a></td>
</tr>
</tbody>
</table>
<h2><a name="install"></a>Oracle Java ME SDKでのIDEの設定(Windowsのみ)</h2>
<p class="alert"><b>重要:</b> この項はWindowsプラットフォームにのみ適用されます。</p>
<p>NetBeans IDEをWindowsプラットフォーム用のOracle Java ME SDKとともに設定するには、次の操作を行う必要があります。 </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ダウンロード</a>・ページに移動します。</li>
<li>「Accept License Agreement」オプションをクリックします。</li>
<li><a href="http://download.oracle.com/otn/java/javame/3.4/oracle-jmesdk-3-4-rr-win32-bin.exe">oracle-jmesdk-3-4-rr-win32-bin.exe</a>インストーラ・ファイルをダウンロードし、コンピュータ上の任意の場所に保存します。</li>
<li>インストーラ・ファイルをダブルクリックしてインストーラを実行し、指示に従います。<br>インストールが完了すると、Java (TM) ME Platform SDK 3.4 Device Managerアイコン(<img alt="Java (TM) ME Platform SDK 3.2 Device Managerアイコン" src="../../../images_www/articles/73/javame/quickstart/icon.png">)がWindowsシステム・トレイに表示されます。</li>
</ol>
<p><b>Java ME機能をアクティブにする手順:</b> </p>
<ol>
<li>IDEのメイン・ツールバーから「ツール」→「プラグイン」を選択します。</li>
<li>「プラグイン」ダイアログ・ボックスで、「インストール済み」タブをクリックし、使用可能な機能のリストで「Java ME」を選択します。
<p class="align-center"><a href="../../../images_www/articles/74/javame/quickstart/plugins.png" rel="lytebox" title="「プラグイン」ダイアログ・ボックス"> <img alt="「プラグイン」ダイアログ・ボックス" border="1" src="../../../images_www/articles/74/javame/quickstart/plugins-small.png"></a></p></li>
<li>「アクティブ化」をクリックします。</li>
<li>「インストーラ」ダイアログ・ボックスの「ようこそ」パネルで「アクティブ化」をクリックします。
<p class="align-center"><a href="../../../images_www/articles/74/javame/quickstart/installer.png" rel="lytebox" title="「インストーラ」ダイアログ・ボックス"> <img alt="「インストーラ」ダイアログ・ボックス" border="1" src="../../../images_www/articles/74/javame/quickstart/installer-small.png"></a></p></li>
<li>アクティブ化が正常に完了したら、「終了」をクリックします。</li>
<li>「閉じる」をクリックして「プラグイン」ダイアログ・ボックスを閉じます。</li>
</ol>
<p><b>Oracle Java MEプラットフォームをインストールする手順:</b></p>
<ol>
<li>「ツール」→「Javaプラットフォーム」を選択します。<br>「Javaプラットフォーム・マネージャ」ダイアログ・ボックスが表示されます。
<p class="align-center">
<a href="../../../images_www/articles/74/javame/quickstart/jpmanager.png" rel="lytebox" title="「名前と場所」パネル"> <img alt="「名前と場所」パネル" border="1" src="../../../images_www/articles/74/javame/quickstart/jpmanager-small.png"></a></p></li>
<li>「プラットフォームの追加」をクリックします。</li>
<li>Javaプラットフォームの追加ウィザードの「プラットフォーム・タイプを選択」で、「Java ME CLDCプラットフォーム・エミュレータ」を選択し、「次」をクリックします。<br>IDEにより、「プラットフォームを検索するディレクトリを選択してください」ダイアログ・ボックスが表示されます。</li>
<li>Java ME SDKプラットフォームをインストールしたディレクトリ(<tt>C:\Java_ME_Platform_SDK_3.4</tt>など)を選択し、「開く」をクリックします。</li>
<li>Javaプラットフォームの追加ウィザードの「プラットフォームのフォルダ」パネルで、前の手順で選択したプラットフォームが選択されていることを確認し、「次」をクリックします。</li>
<li>IDEがプラットフォームを検出したらすぐに、Javaプラットフォームの追加ウィザードの「検出されたプラットフォーム」パネルで「終了」をクリックします。
<p class="align-center">
<a href="../../../images_www/articles/74/javame/quickstart/jpdetected.png" rel="lytebox" title="検出されたJ2MEプラットフォーム"> <img alt="検出されたJ2MEプラットフォーム" border="1" src="../../../images_www/articles/74/javame/quickstart/jpdetected-small.png"></a></p>
これで、Oracle Java MEプラットフォームがNetbeans IDEに登録されます。
<p class="align-center">
<a href="../../../images_www/articles/74/javame/quickstart/jpregistered.png" rel="lytebox" title="登録されたJ2MEプラットフォーム"> <img alt="登録されたJ2MEプラットフォーム" border="1" src="../../../images_www/articles/74/javame/quickstart/jpregistered-small.png"></a></p></li>
<li>「Javaプラットフォーム・マネージャ」ダイアログ・ボックスで、「閉じる」をクリックします。</li>
</ol>
<p>これで、NetBeans IDEがモバイル開発用に設定されます。</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>モバイル・アプリケーション</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>MIDlet名として「<code>HelloMIDlet</code>」と入力します(「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>「実行」</tt>><tt>「プロジェクトの実行」(MyHelloMIDlet)</tt>を選択します。「出力」ウィンドウで、プロジェクトのコンパイルの進行状況を確認します。<code>HelloMIDlet.java</code>ファイルは実行前にビルドされることに注意してください。デバイス・エミュレータが開いてMIDletの実行結果が表示され、ソース・コードに入力したテキストが表示されます。</p>
<p class="align-center"><a href="../../../images_www/articles/74/javame/quickstart/emulator.png" rel="lytebox" title="Java ME SDKのデフォルトエミュレータの「Make my day」メッセージ"> <img alt="Java ME SDKのデフォルトエミュレータの「Make my day」メッセージ" border="1" src="../../../images_www/articles/74/javame/quickstart/emulator-small.png"></a></p>
<p>MIDletとエミュレータ・ウィンドウを閉じるには、エミュレータ・ウィンドウで「アプリケーション」>「終了」を選択します。</p>
</div>
<h2><a name="vmd"></a>ビジュアル・モバイル・デザイナを使用したMIDPアプリケーションの作成</h2>
<p>NetBeans IDEには、MIDPプロジェクトを簡単に作成できるウィザードがあります。プロジェクトの作成時に、アプリケーションの開発にビジュアル・モバイル・デザイナ(VMD)を使用するか、またはソース・コード・エディタを使用するかを、選択できます。VMDを使用すると、視覚的にアプリケーションのフローを計画し、そのアプリケーションで使用する画面をデザインできます。このデザイナでは、アプリケーションのコードが自動的に作成され、変更がデザイン・キャンバス上に保存されます。 </p>
<p class="alert"><b>重要:</b> IDEでビジュアル・モバイル・デザイナを実行するには、次のように、更新センターからビジュアル・モバイル・デザイナ・プラグインをインストールする必要があります。</p>
<ol>
<li>メイン・メニューから「ツール」>「プラグイン」を選択します。</li>
<li>「プラグイン」ダイアログ・ボックスの「使用可能なプラグイン」タブで、「ビジュアル・モバイル・デザイナ」を選択して「インストール」をクリックします。 </li>
<li>「インストーラ」ダイアログ・ボックスのようこそページで「次」をクリックします。 </li>
<li>ライセンス契約ページで、プラグインに関連するライセンス契約を読みます。ライセンス契約のすべての条件に同意する場合は、該当するオプションをクリックしてから「インストール」をクリックします。</li>
<li>(オプション)バックグラウンドでインストールを実行するには、「バックグラウンドで実行」オプションを選択します。</li>
<li>インストール・プロセスが完了したら、「終了」をクリックします。 </li>
<li>「プラグイン」ダイアログ・ボックスで、「閉じる」をクリックします。</li>
</ol>
<h3 class="tutorial">MIDP/CLDCアプリケーションの作成 </h3>
<ol>
<li><tt>ファイル</tt>」>「<tt>新規プロジェクト</tt>」(Ctrl+Shift+N)を選択します。「カテゴリ」から「<tt>Java ME</tt>」を選択します。「プロジェクト」で「<tt>モバイル・アプリケーション</tt>」を選択して、「次」をクリックします。</li>
<li>「プロジェクト名」フィールドに<code>MyHello</code>と入力します。デフォルトのプロジェクトの場所を使用するか、システム上の任意のディレクトリに変更します。このチュートリアルでは、このディレクトリを<code>$PROJECTHOME</code>と表記します。 </li>
<li><tt>デフォルト・パッケージとメインの実行可能クラスの作成</tt>」チェックボックスを選択されたままにします。「次」をクリックします。 </li>
<li>エミュレータ・プラットフォームはデフォルト設定を選択し、残りもデフォルト設定を使用します。「終了」をクリックします。 </li>
<li>IDEによって、<code>$PROJECTHOME/MyHello</code>プロジェクト・フォルダが作成されます。このプロジェクト・フォルダには、ソースおよび、プロジェクトのAntスクリプトなどのプロジェクト・メタデータのすべてが含まれます。アプリケーション自体はビジュアル・モバイル・デザイナの「フロー・デザイン」ウィンドウに表示されます。
<p class="align-center"><a href="../../../images_www/articles/74/javame/quickstart/newjavameproject.png" rel="lytebox" title="IDEでのHello Midletの「フロー」ビュー"><img alt="IDEでのHello Midletの「フロー」ビュー" border="1" src="../../../images_www/articles/74/javame/quickstart/newjavameproject-small.png"></a></p>
<p class="notes"><b>注意:</b> 使用可能なパレット・コンポーネントの詳細は、<a href="http://wiki.netbeans.org/VisualMobileDesignerPalatteReference">ビジュアル・モバイル・デザイナのパレットのリファレンス</a>を参照してください。</p>
</li>
</ol>
<h3 class="tutorial">Javaソース・コードの編集</h3>
<p>ここで、MIDletによって表示されるテキストを編集します。</p>
<ol>
<li><tt>HelloMIDlet.java</tt>の下の「画面」をクリックして「画面」ビューに切り替え、アプリケーションで利用できる唯一の画面である「デバイス画面」を表示します。 </li>
<li>「デバイス画面」の「<tt>Hello World!</tt>」メッセージをクリックします。「プロパティ」ウィンドウで、「<tt>Hello World!</tt>」テキストをクリックしてウェルカム・メッセージ・テキストを変更し、Enterを押します。この例では「<tt>Make my day</tt>」と入力しました。
<p class="align-center"><img alt="テキスト「Make my day」が「プロパティ」ウィンドウのテキスト・フィールドに入力されています。" src="../../../images_www/articles/73/javame/quickstart/stringedit.png"></p></li>
<li>「画面」ビューに、テキスト・フィールドに入力したテキストのプレビューが表示されます。
<p class="align-center"><a href="../../../images_www/articles/73/javame/quickstart/screen.png" rel="lytebox" title="VMDの「画面」ビューにあるデバイス画面プレビューでの「Make my day」"><img alt="テキスト「Make my day」が、VMDの「画面」ビューにあるデバイス画面プレビューに表示されています。" border="1" src="../../../images_www/articles/73/javame/quickstart/screen-small.png"></a></p></li>
</ol>
<h3 class="tutorial">プロジェクトのコンパイルと実行</h3>
<ol>
<li>IDEのメイン・ツールバーから<tt>「実行」</tt>><tt>「プロジェクトの実行」(MyHello)</tt>を選択します。「出力」ウィンドウで、プロジェクトのコンパイルの進行状況を確認します。<code>HelloMIDlet.java</code>ファイルは実行前にビルドされることに注意してください。デバイス・エミュレータが開いて、MIDletの実行結果が表示されます。デバイス・エミュレータがMIDletを起動し、ソース・コードに入力されたテキストを表示します。
<p class="tips">MIDletを実行するエミュレータは、プロジェクト・ノードを右クリックし、コンテキスト・メニューから「<tt>指定して実行...</tt>」を選択して指定できます。次に、Java ME SDK 3.4で使用可能な<tt>JavaMEPhone1</tt>を示します。</p>
<p class="align-center"><a href="../../../images_www/articles/74/javame/quickstart/emulator-screen.png" rel="lytebox" title="Java ME SDKのデフォルトの電話エミュレータに表示される「Make my day」"><img alt="Java ME SDKのデフォルトの電話エミュレータに表示される「Make my day」" border="1" src="../../../images_www/articles/74/javame/quickstart/emulator-screen-small.png"></a></p></li>
<li>エミュレータ・ウィンドウで「アプリケーション」>「終了」を選択して、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>
<ul>
<li><i>NetBeans IDEによるアプリケーションの開発</i><a href="http://www.oracle.com/pls/topic/lookup?ctx=nb7400&id=NBDAG1552">Java MEアプリケーションの開発</a></li>
<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 for Mobile Devicesドキュメント</a></li>
<li><a href="http://docs.oracle.com/javame/developer/developer.html" target="_blank">Java MEおよびJava Cardドキュメント</a></li>
</ul>
</body>
</html>