PlayN:GettingStartedWithEclipse

提供:Cattaka's Laboratory
2011年11月29日 (火) 22:50時点におけるCattaka (トーク | 投稿記録)による版
ナビゲーションに移動 検索に移動

このページは作成中です

はじめに

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

Eclipseの入手

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

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

PlayN GettingStarted Eclipse 1.png

Google Plugin for Eclipseのインストール

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

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

Google系ツールのインストール

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


Android Plugin for Eclipseのインストール

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

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

Android Pluginのインストール

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

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

Android SDKのインストール

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

Android SDKのAddOnのインストール


Maven Integration for WTPのインストール

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

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

Maven Pluginのインストール

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

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

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

Maven3.0.3の展開と設定

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

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


EGitのインストール

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

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

EGitのインストール

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

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

EGitの設定


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

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

サンプルプロジェクトのクローン

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

サンプルプロジェクトのインポート1

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

サンプルプロジェクトのインポート2


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

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

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

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

Mavenによる外部パッケージのインストール

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

[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」で実行できます。 none|300px none|300px