サンプルプログラムを使用するには、次のソフトウェアが必要です。

• NetBeans[tm] 統合開発環境 (IDE) および NetBeans Mobility Pack 4.0 Beta 2 または FCS。
  これらのソフトウェアは、NetBeans ダウンロードサイト、http://www.netbeans.org/downloads/index.html から入手できます。
• Java[tm] 2 Software Development Kit, Standard Edition (J2SE[tm] SDK), v. 1.4.2 以上。J2SE SDK は、http://java.sun.com/j2se/downloads.html から入手できます。
• J2ME[tm] Wireless Toolkit 2.0 以上。
  J2ME Wireless Toolkit は、NetBeans Mobility Pack と一緒にインストールされます。Wireless Toolkit は、http://java.sun.com/products/j2mewtooklit/index.html から入手することもできます。
• Nokia Series 60 SDK for Symbian OS。
  この 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 から入手できます。「View tools by technology area」ドロップダウンボックスで「Java」を選択してください。
  • Vodafone SDK を入手できるのは Global Partner だけです。簡単なオンライン登録で入手することはできません。

ダウンロードサイトでの指示に従って、ソフトウェアをダウンロードしてください。

NetBeans IDE を起動する手順は、次のとおりです。

• Microsoft Windows の場合
  「スタート」>「プログラム」>「NetBeans version」>「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. ファイルを圧縮解除するアプリケーションを使用して、temp ディレクトリに MarvTheMiner_120_all.zip ファイルを圧縮解除します。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 に関しても、直前の手順を繰り返します。「閉じる」をクリックして、「プロジェクト構成マネージャ」ダイアログを閉じます。

これで、「プロジェクトプロパティ」ページの一番上にある「プロジェクト構成」コンボボックスには、5 つの構成が含まれています。これらの構成はこの後で使用することになりますが、ここでは IDE にエミュレータを追加してみます。

コンピュータにインストールしたエミュレータプラットフォームを使ってプロジェクトを実行するには、そのエミュレータを IDE に登録しておく必要があります。

1. 「プロジェクト構成」コンボボックスで「DefaultConfiguration」を選択し、「プラットフォーム」ノードを選択します。続いて、「エミュレータを管理」ボタンをクリックします。「Java プラットフォームマネージャ」ダイアログが表示されます。

   このダイアログは、メインメニューから「ツール」>「Java プラットフォームマネージャ」を選択することによってアクセスすることもできます。

2. 「プラットフォームを追加」をクリックして、Nokia Series 60 エミュレータがインストールされているディレクトリに移動して選択し、「次へ」をクリックします。
3. エミュレータの設定が正しく検出されたことを確認して、「次へ」をクリックします。
4. ここで、必要に応じてエミュレータのソースおよび Javadoc ファイルを指示することができます。必要ない場合は、単に「完了」をクリックして、プラットフォームのインストールを終了します。

5. マシンにインストールしていて、IDE で使用するエミュレータプラットフォームごとに上記の手順を繰り返します。

   

   IDE が検出できるのは、UEI 規格に準拠したエミュレータだけであることに注意してください。このことは、Marv The Miner に使用されている Motorola 7.5 エミュレータは検出されないことを意味します。このチュートリアルのこの後の節では、UEI に準拠していないエミュレータを IDE で使用するための回避策を紹介します。

どのプロジェクト構成も、「プロジェクトプロティ」ページで個別にすべてのパネルでカスタマイズを行うことができます。デフォルトでは、構成は、デフォルトの構成で定義されている設定を使用します。

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 プラットフォームの 1 つを選択します。
6. Vodafone プラットフォームについても、これらの操作を繰り返します。
7. すでに触れているように、Motorola 7.5 エミュレータは UEI に準拠していません。このため、IDE に組み込むことはできません。ただし、コンパイルを目的としてその API を指示することはできます。Motorla 構成を有効にして、「ライブラリおよびリソース」パネルを選択します。
8. 「"DefaultConfiguration" の値を使用」チェックボックスを選択解除します。
9. 「JAR/ZIP を追加」をクリックして、{motorola install directory}\Emulator7.5\lib に移動します。Ctrl キーを使用して、各 .zip ファイルを選択し、「開く」をクリックします。
10. 「了解」をクリックして、プロジェクトプロパティを終了します。これで第一段階のプロジェクト構成の作成作業は終えました。

デバイス細分化の問題を解決するための第 2 の機能は、ソースファイル内の特定のコードブロックを 1 つまたは複数の構成に固有のブロックとして指定する機能です。これは、エディタで右クリックしたときに表示されるコンテキストメニューで提供するアクション、または「編集」>「プリプロセッサブロック」メニューを使用して行います。

1. Main.java を開いて、initStaticData() メソッドの内容を見てみます。このメソッドは、使用可能なデバイス固有の API を実行時に判定し、その 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 つのブロックが残ったことになります。

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);
// 他のすべての Nokia
   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 の振動呼び出し (vibration control call) は、Nokia の両方の構成に関連付けることを忘れないでください。

9. run() メソッドにも、Vodafone 固有の呼び出しがあります。try/catch ブロックを削除して、2 行を Vodafone 構成に関連付けます。
   

これでおおよその作業は完了しました。最後の作業は、Nokia の FullCanvas に少し手を加えることです。

10. NokiaSeries60 の構成を有効にします。
11. FullCanvas 宣言で右クリックして、「If/Else ブロックを作成 (NokiaSeries60)」 を選択します。
12. 最初のブロックで右クリックして、「NokiaOther」を追加します。
13. 2 つ目のブロックで右クリックして、「NokiaOther」を追加します。
14. 2 つ目のブロックが反転表示になります。反転表示されたブロックのクラス定義を extend Canvas に変更します。

この操作を完了すると、クラス定義が以下のようになります。

この時点で、すべてのすべての構成でプログラムをコンパイル、実行することができます。メインツールバーにあるアイコンをどれかクリックすると、「アクティブ」な構成の選択されたアクションが実行されます。

1. メインメニューから「構築」>「主プロジェクトのすべての構成を構築」を選択します。
   すべての情報が正しく設定されていると、この操作ですべての構成が構築されます。

   適切な API を含むエミュレータプラットフォームにアクセスできない場合、この操作は失敗することがあります。その場合は、存在しない API を呼び出す行をすべて手動でコメントアウトします。

   非 UEI エミュレータの節に説明している Motorola エミュレータを手動でインストールする手順に従わなかった場合、事前検証は失敗します。手動でエミュレータを追加することなくこの構成をコンパイルするには、Motorola API 呼び出しをすべてコメントアウトして、「ライブラリおよびリソース」パネルですべての Motorola ライブラリを削除します。

2. IDE の左上の「ファイル」タブを選択して、「dist」フォルダを展開します。構築の結果、このフォルダには、DefaultConfiguration の構築を表す JAR/JAD ばかりでなく、構築に成功した各構成の JAR/JAD を含むディレクトリが含まれています。
3. F5 キーを押して、現在選択している構成でプログラムを実行します。構成を切り替え、再度 F5 キーを押すことによって、同時にプログラムの複数のバージョンを実行することができます。