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

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

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

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

構成の追加

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」と表示されます。