MIDP/CLDC アプリケーションの作成

1. 「ファイル」>「新規プロジェクト」(Ctrl-Shift-N) を選択します。「カテゴリ」で「Mobility」を選択します。「プロジェクト」で「MIDP アプリケーション」を選択して、「次へ」をクリックします。
2. 「プロジェクト名」フィールドに MyHello と入力します。「プロジェクトの場所」をシステム上の任意のディレクトリに変更します。このチュートリアルでは、このディレクトリを $PROJECTHOME と表記します。
3. 「主プロジェクトとして設定」と「Hello MIDlet を作成」の各チェックボックスを選択します (どちらもデフォルトで選択されています)。「次へ」をクリックします。
4. エミュレータプラットフォームとして「Sun Java Wireless Toolkit 2.52 for CLDC」を選択し、残りの項目はデフォルト値のままにします。「次へ」をクリックします。
5. 「インストールした CLDC プラットフォームが提供する構成テンプレート」フォルダと「Sun Java Wireless Toolkit 2.52 for CLDC」フォルダを展開します。各構成の横のチェックボックスを選択します。表示されているテンプレートごとに、IDE によって新しいプロジェクト構成が自動的に作成されます。

   

6. 「完了」をクリックします。$PROJECTHOME/MyHello プロジェクトフォルダが作成されます。このプロジェクトフォルダには、ソースおよび、プロジェクトの Ant スクリプトなどのプロジェクトメタデータのすべてが含まれます。アプリケーション自体はビジュアルモバイルデザイナの「フローデザイン」ウィンドウに表示されます。

Java ソースコードの編集

ここで、MIDlet によって表示されるテキストを編集します。

1. 「画面」をクリックします。「スクリーンデザイナ」ウィンドウが開き、アプリケーションの唯一の画面であるデバイス画面が表示されます。
2. 「プロパティー」ウィンドウで、「テキスト」フィールドをクリックし、新しいテキストを入力します。この例では「Make my day」と入力しました。



3. 「テキスト」フィールドに入力したテキストのプレビューが「画面」ビューに表示されます。

プロジェクトのコンパイルと実行

1. 「実行」メニューから「実行」>「主プロジェクトを実行」(F6) を選択します。「出力」ウィンドウで、プロジェクトのコンパイルの進行状況を確認します。HelloMIDlet.java ファイルが構築されてから実行されます。デバイスエミュレータが開いて、MIDlet の実行結果が表示されます。デフォルトのデバイスエミュレータは DefaultColorPhone です。
2. デバイスエミュレータのウィンドウで、「選択」の下のボタンをクリックします。デバイスエミュレータが MIDlet を起動し、ソースコードに入力されたテキストを表示します。

   

3. 「Exit」の下のボタンをクリックして、MIDlet を閉じます。デバイスの右上隅のボタンをクリックして、エミュレータのウィンドウを閉じます。

Java ME MIDP プロジェクトの新規作成

1. 「ファイル」>「新規プロジェクト」(Ctrl-Shift-N) を選択します。「カテゴリ」で「Mobility」を選択します。「プロジェクト」で「MIDP アプリケーション」を選択して、「次へ」をクリックします。
2. 「プロジェクト名」フィールドに MyHelloMIDlet と入力します (「MID」はすべて大文字)。「プロジェクトの場所」をシステム上の任意のディレクトリに変更します。このチュートリアルでは、このディレクトリを $PROJECTHOME と表記します。
3. 「主プロジェクトとして設定」チェックボックスを選択し、「Hello MIDlet を作成」チェックボックスを選択解除します。「次へ」をクリックします。
4. 「エミュレータプラットフォーム」は、「J2ME Wireless Toolkit」を選択したままにしておきます。
5. 「インストールした CLDC プラットフォームが提供する構成テンプレート」フォルダと「J2ME Wireless Toolkit 2.2」フォルダを展開します。各構成の横のチェックボックスを選択します。表示されているテンプレートごとに、IDE によって新しいプロジェクト構成が自動的に作成されます。
6. 「完了」をクリックします。$PROJECTHOME/MyHelloMIDlet プロジェクトフォルダが作成されます。このプロジェクトフォルダには、ソースおよび、プロジェクトの Ant スクリプトなどのプロジェクトメタデータのすべてが含まれます。
7. エクスプローラウィンドウで「MyHelloMIDlet」ノードを右クリックし、「新規」>「MIDlet」を選択します。
8. MIDlet 名として HelloMIDlet と入力します (「MID」はすべて大文字)。「完了」をクリックします。HelloMIDlet.java ファイルが作成されます。
9. HelloMIDlet.java ファイルをダブルクリックしてエディタにソースコードを表示します。
10. ソースエディタ内をクリックして、次の部分を

    public class HelloMIDlet extends MIDlet

    次のように変更します。

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

11. 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;

12. 次のように startApp() メソッドに initialize(); 行を追加します。

      public void startApp() {
       initialize();
        }

Java ソースコードの編集

MIDlet で表示するテキストを追加してみます。

1. get_helloTextBox() メソッドの「Test String」コードを任意のテキストに置き換えます。たとえば「Make my day」にします。

プロジェクトのコンパイルと実行

1. 「実行」メニューから「実行」>「主プロジェクトを実行」(F6) を選択します。「出力」ウィンドウで、プロジェクトのコンパイルの進行状況を確認します。HelloMIDlet.java ファイルが構築されてから実行されます。デバイスエミュレータが開いて、MIDlet の実行結果が表示されます。デフォルトのデバイスエミュレータは DefaultColorPhone です。
2. デバイスエミュレータのウィンドウで、「選択」の下のボタンをクリックします。デバイスエミュレータが MIDlet を起動し、ソースコードに入力されたテキストを表示します。
3. 「Exit」の下のボタンをクリックして、MIDlet を閉じます。デバイスの右上隅のボタンをクリックして、エミュレータのウィンドウを閉じます。

デフォルトのエミュレータデバイスの変更

1. MyHelloMIDlet プロジェクトのノードを右クリックし、「プロパティー」を選択します。「プロパティー」ダイアログのカテゴリにある「プラットフォーム」ノードを選択します。デフォルト構成のデバイスを変更できます。
2. 「デバイス」ドロップダウンリストをクリックして、「QwertyDevice」を選択します。「閉じる」をクリックします。
3. 再びアプリケーションを実行すると、アプリケーションは QwertyDevice エミュレータで実行されます。

プロジェクト構成の変更

「新規プロジェクト」ウィザードのテンプレートを使用して、いくつかのプロジェクト構成を作成しました。メインツールバーにある構成のドロップダウンメニューを使用して、プロジェクト構成を簡単に変更できます。

新しいエミュレータプラットフォームの追加

1. メインツールバーから「ツール」>「Java プラットフォーム」を選択します。
2. 「Java プラットフォームマネージャー」ダイアログで「プラットフォームを追加」ボタンをクリックします。
3. 「プラットフォームの種類を選択」ページで、「Java ME MIDP Edition プラットフォームエミュレータ」を選択します。「次へ」をクリックします。「プラットフォームのフォルダ」ページで、使用可能なすべての Java ME プラットフォームが IDE によって検索され、ウィンドウ内に一覧表示されます。UEI (Unified Emulator Interface) 標準に準拠しているプラットフォームは、準拠していることが確認されると、プラットフォーム名の横にあるチェックボックスが選択された状態で表示されます。UEI に準拠していないプラットフォーム、またはそれ以外の理由でインストールできない可能性のあるプラットフォームは、赤色で示されます。このウィザードでは、すでにインストールされているプラットフォームも識別されます。注: UEI に準拠していないプラットフォームをインストールするには、「戻る」ボタンをクリックし、「カスタムの Java Micro Edition プラットフォームエミュレータ」を選択します。
4. 「プラットフォームのフォルダ」ページで、インストールするプラットフォームエミュレータの横のチェックボックスを選択します。プラットフォームが検出され、インストールされます。「完了」をクリックします。「閉じる」をクリックします。
5. 「ファイル」>「"MyHello" プロパティー」を選択します。
6. 「プラットフォーム」ノードを選択し、「エミュレータプラットフォーム」ドロップダウンメニューから新しいエミュレータの名前 (J2ME Wireless Toolkit 2.2 など) を選択して、「閉じる」をクリックします。

構成の追加

1. MyHelloMIDlet プロジェクトのノードを右クリックし、「プロパティー」を選択します。「プロパティー」ダイアログにある「プロジェクト構成」ドロップダウンリストから「構成を追加」を選択します。「プロジェクト構成の追加」ダイアログが開きます。
2. 「新規構成名」フィールドに、追加する構成の名前を入力します。この構成用に作成する JAR/JAD の配備先のプラットフォームが分かる名前の使用を推奨します。たとえば BlackWhiteDisplay を入力して、「了解」をクリックします。これで、新しい構成が作成されます。
3. 構成は、「プロパティー」ダイアログにある「構成を管理」ボタンを使用して追加することもできます。このボタンをクリックすると、構成を追加、削除、および複製するためのオプションを含む、「プロジェクト構成マネージャー」ダイアログが開きます。

構成のカスタマイズ

プロジェクトには、いくつでも構成を追加できます。追加した個々の構成の設定は、「プロジェクトプロパティー」ダイアログで変更できます。

1. MyHelloMIDlet プロジェクトのノードを右クリックし、「プロパティー」を選択します。「プロパティー」ダイアログのカテゴリにある「プラットフォーム」ノードを選択します。
2. 「プロパティー」ダイアログの一番上の「プロジェクト構成」コンボボックスから「 BlackWhiteDisplay 」構成を選択します。
3. 「プラットフォーム」ダイアログのコンポーネントはすべて無効になっています。これは、現在のところ、この構成が、このパネル用のデフォルト構成の使用する値を採用しているためです。パネル上部にある「"DefaultConfiguration" の値を使用」オプションの選択を解除します。これで、このパネルのすべてのコンポーネントが編集可能になります。
4. 「デバイス」オプションを「DefaultGrayPhone」に変更します。
5. 「プロパティー」ダイアログの一番上にある「プロジェクト構成」を切り替え、現在選択されている構成に基づいて「デバイス」オプションが変わることを確認します。この構成のカスタマイズ方法は、ダイアログのすべてのパネル (「一般」パネルを除く) で機能します。「了解」をクリックして、構成の変更を保存し、「プロパティー」ダイアログを閉じます。

アビリティーの作成

アビリティーは、プロジェクト構成の特定の属性です。画面サイズなどの物理的な属性である場合も、構成でサポートされている API や JSR である場合もあります。新しいアビリティーを作成して、1 つまたは複数のプロジェクト構成に関連付けることができます。その後プリプロセッサのコードブロックを使用して、そのアビリティーに特定のコードを関連付けることができます。あとで構成の追加または削除が必要になった場合に、すべてのコードを調べてその構成を各コードブロックに関連付ける必要はありません。このアビリティーを構成に追加するだけです。それにより、構成は、アビリティーに関連付けられているすべてのコードブロックに自動的に関連付けられます。

1. MyHelloMIDlet プロジェクトのノードを右クリックし、「プロパティー」を選択します。
2. 「カテゴリ」メニューツリーから「アビリティー」ページを選択します。
3. 「プロジェクト構成」ドロップダウンメニューから構成を選択します。これでアビリティーが構成に関連付けられます。
4. 必要に応じて、「"DefaultConfiguration" の値を使用」チェックボックスを選択解除します。
5. 「追加」ボタンをクリックします。「アビリティーの追加」ダイアログが開きます。
6. 「アビリティーの追加」ダイアログで、アビリティーの名前を入力するか、ドロップダウンメニューからアビリティーを選択します。必要に応じて、アビリティーの値を入力します。「了解」をクリックして、「アビリティーの追加」ダイアログを閉じます。これで、アビリティーが選択したプロジェクト構成に関連付けられました。

アビリティーをほかの構成に関連付けるには、「プロジェクト構成」メニューから別の構成を選択し、「追加」ボタンをクリックします。

構成別プリプロセッサコードの追加

プリプロセッサブロックを使用して、1 つ以上のプロジェクト構成またはアビリティーに固有のコードを作成、管理、および追跡できます。コードは、指定した構成またはアビリティーに関してのみ有効 (または無効) になります。

1. HelloMIDlet.java のエディタウィンドウで、TextBox がインスタンス化されているソースコード行 ( helloTextBox = new javax.microedition.lcdui.TextBox(null, "Make my day", 120, 0x0); ) を右クリックします。
2. 行を右クリックし、「プリプロセッサブロック」>「If / Else ブロックを作成」を選択します。最初のピンクのセクションの「Make my day」文字列のあとに「Color」という単語を追加します。2 つ目のグレーのセクションで「Make my day」文字列のあとに「Gray」という単語を追加します。
3. //#if プリプロセッサ指示でマークされたコードは、有効な構成が指示の値 (この場合は DefaultConfiguration) に一致するときに有効になります。//#else プリプロセッサ指示で囲まれたコードは、有効な構成がプリプロセッサの値に一致しないときに使用されます。言い替えると、エミュレータは、有効なプラットフォームが「DefaultConfiguration」の場合は「Make my day Color」と表示し、有効なプラットフォームがほかのエミュレータプラットフォームの場合は「Make my day Gray」と表示します。//#endif プリプロセッサ指示がプリプロセッサブロックの終わりです。

プリプロセッサコードをテストするには、 エミュレータプラットフォームの変更 で説明されているように、さまざまなエミュレータデバイスを使用して MIDlet を実行します。

構成の実行

構成は個別に構築、実行することも、まとめて構築、実行することもできます。

1. MyHelloMIDlet プロジェクトのノードを右クリックし、「プロジェクトを実行」を選択します。
2. ツールバーにある構成のコンボボックスを使用して、構成を BlackWhiteDisplay に変更します。再度「実行」を選択します。
3. Color と Gray の 2 つのエミュレータが表示されます。グレーのエミュレータに「Make my day Gray」と表示され、カラーのエミュレータに「Make my day Color」と表示されます。