PlayN:GettingStartedWithEclipse

eclipseの開発環境構築からサンプルプロジェクトの実行まで

はじめに

ここでは公式サイトのGettingStartedの内容をベースに、 Eclipseでの開発環境の構築手順について説明します。

• 公式サイトのGettingStarted: http://code.google.com/p/playn/wiki/GettingStarted

Eclipseの入手

まず、Eclipseのをダウンロードします。 僕が使用したバージョンはEclipse IDE for Java Developers(Indigo(v3.7.1))です。

• ダウンロードURL: http://www.eclipse.org/downloads/packages/eclipse-ide-java-developers/indigosr1

ダウンロードが終わると展開して実行します。 その際に忘れずにJava6のJDKの設定をして下さい。 メニューバーの「Window」→「Preferences」から、「Java」→「Installed JREs」から設定します。

Google Plugin for Eclipseのインストール

EclipseにGoogle App EngineとGoogle Web Toolkitのプラグインをインストールします。

• 公式: http://code.google.com/intl/ja/eclipse/docs/getting_started.html

Eclipseのメニューバーの「Help」→「Install New Software」からInstallダイアログを開きます。 URLに次のURLを入力します。

• http://dl.google.com/eclipse/plugin/3.7

後は流れに沿ってインストールを完了させます。

Android Plugin for Eclipseのインストール

EclipseにAndroid開発用のプラグインをインストールします。 インストールしなくても大丈夫ですが、しなければ後述のAndroidのサンプルプロジェクトが動かないのでご注意下さい。

• 公式: http://developer.android.com/intl/ja/sdk/eclipse-adt.html

Eclipseのメニューバーの「Help」→「Install New Software」からInstallダイアログを開きます。 URLに次のURLを入力します。

• https://dl-ssl.google.com/android/eclipse/

後は流れに沿ってインストールを完了させます。

Eclipseを再起動するとAndroid SDKのインストールについてのダイアログが出てくるので、 これも流れに沿ってインストールを完了させます。 別途インストールしている場合はそちらのパスを指定します。

標準ではAndroidの最低限のライブラリしかインストールされないので、 必要なプラグインを追加インストールします。 最低でもAPI 11以下の「SDK Platform」をインストールして下さい。

Maven Integration for WTPのインストール

EclipseにMaven Integration for WTPのプラグインをインストールします。

Eclipseのメニューバーの「Help」→「Install New Software」からInstallダイアログを開きます。 URLに次のURLを入力します。

• http://download.jboss.org/jbosstools/updates/m2eclipse-wtp

後は流れに沿ってインストールを完了させます。

このプラグインについてくるMavenのバージョンは3.0.2と古く、 Android SDKが3.0.3以降を必要とするので本家サイトから別途最新版をインストールします。

• http://maven.apache.org/download.html

適当な場所に展開し、展開が終わったらEclipseの設定で展開したディレクトリを指定します。

次にMavenからJavaのtools.jarとAndroid SDKが使えるように環境変数を設定します。

• JAVA_HOME : インストールしているJDKへのパスを指定します
• ANDROID_HOME : 上でインストールしたAndroid SDKへのパスをしていします

EGitのインストール

EclipseにGitのプラグインをインストールします。 無くても良いのですが、本家のサンプルプロジェクトがGitリポジトリ上にあるのでインストールします。

• 公式: http://eclipse.org/egit/

Eclipseのメニューバーの「Help」→「Install New Software」からInstallダイアログを開きます。 URLに次のURLを入力します。

• http://download.eclipse.org/egit/updates

後は流れに沿ってインストールを完了させます。

インストール後、必要に応じてGitの設定を変更します。 特にDefault Repository Folderは後で触るので確認しておいて下さい。

サンプルプロジェクトのクローン(取得)

Eclipseを起動し、パースペクティブを「Git Repository Exploring」に切り替えます。 リポジトリのクローンを押し、ダイアログを開いてサンプルプロジェクトのURLを入力します。

• https://code.google.com/p/playn-samples

クローンが終われば、Javaパースペクティブに戻りプロジェクトをインポートします。 メニューバーから「File」→「Import」を選びます。 「Existing Maven Project」を選びます。

「Root Directory」にクローンされたプロジェクトのディレクトリを選びます。 すると内包されるプロジェクトがすべて表示されるので、全て選択してFinishを押します。

サンプルプロジェクトの準備

サンプルプロジェクトには次のようなものがあります。

• hello - PlayNプラットフォームのすべての作業プロジェクトを作成するための必要最小限のスケルトン
• showcase - PlayNフレームワークのいろんな機能のデモ
• cute - もうちょっとゲームっぽいもの（注：今のところはなはだ不完全）

そのままでは実行に必要な外部パッケージがインストールされていないので、 Mavenを実行してインストールして貰います。 これらのプロジェクトを選んで「Run As」→「Maven install」を選ぶことで実行できます。。

実行をが完了すると次のようなログがでて完了します。

[INFO] Reactor Summary:
[INFO] 
[INFO] PlayN Hello Metaproject ........................... SUCCESS [0.531s]
[INFO] PlayN Hello Core .................................. SUCCESS [1.782s]
[INFO] PlayN Hello Java .................................. SUCCESS [0.921s]
[INFO] PlayN Hello HTML .................................. SUCCESS [20.985s]
[INFO] PlayN Hello Android ............................... SUCCESS [28.172s]
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time: 53.125s
[INFO] Finished at: Tue Nov 29 22:18:44 JST 2011
[INFO] Final Memory: 14M/26M
[INFO] ------------------------------------------------------------------------

途中で失敗して再実行する場合は、Maven Cleanしてから再実行すると良いようです。

（設定が巧くできてないといろんなエラーが出ますが・・・）

サンプルプロジェクトの構成

各サンプルプロジェクトを見ると、複数のプロジェクトから構成されていることがわかります。 それぞれ次のような構成になっています。

• プロジェクト名 : ルートとなるプロジェクト
• プロジェクト名-android : Android向けにリリースするためのコードを持つプロジェクトです。
• プロジェクト名-core : 全てのリリースの共通するコードを持つプロジェクトです。
• プロジェクト名-html : HTML+JavaScriptにリリースするためのコードを持つプロジェクトです。
• プロジェクト名-java : Javaアプリケーションにリリースするためのコードを持つプロジェクトです。

ゲームの内容は「プロジェクト名-core」のプロジェクトに含めることになります。

サンプルプロジェクトの実行

Javaアプリケーションとして実行

プロジェクト名-javaのmainクラスを右クリックして、「Run As」→「Java Application」で実行できます。

Androidアプリケーションとして実行

プロジェクト名-androidのプロジェクトを右クリックして、「Run As」→「Maven Build」を選びます。

次に開いたダイアログでGoalsに「android:deploy」を指定してRunを押します。

APKが作成された後、デバイスにインストールされます(起動は手動)。

HTMLとして実行

プロジェクト名-htmlのプロジェクトを右クリックして、「Run As」→「Web Application」を選びます。

次に「Development Mode」のタブからURLをダブルクリック(または右クリックでOpen)で開きます。 GWTのプラグインのインストールが求められた場合はインストールして下さい。

この場合はデバッグモードで動作しているため、速度が遅くなります。 通常モードで動作させるにはURLの後ろに付いている「?gwt.codesvr=＊＊＊＊＊」を削ったURLにアクセスします。

このときコンパイルされていないと「GWT module '*****' may need to be (re)compiled」というアラートが表示されます。 コンパイルするには次の手順で行います。 プロジェクト名-htmlのプロジェクトを右クリックして、「Google」→「GWT Compile」を選びます。

コンパイルが完了したらブラウザで再度アクセスします。ゲーム画面が表示されます。

まとめ

以上でEclipseのインストールからサンプルプロジェクトの実行までの一通りが終わりです。 この記事を書いているときに起こったことで、Android SDKがMavenの新しいバージョンを必要としたり、 環境変数でJAVA_HOMEやANDROID_HOMEの設定ができてないとmaven install中にエラーが出たりでいろいろと大変でした。 Eclipseでの環境はまだまだ整備されていない感じですが、PlayNそのものは十分使える水準に達しているので今後整備されていくと思います。 Javaで作るクロスプラットフォームのゲームとしてPlayNはとても有望だと思いました。