コンテンツにスキップ

「PlayN:GettingStartedWithEclipse」の版間の差分

提供: Cattaka's Laboratory
編集の要約なし
編集の要約なし
 
(同じ利用者による、間の14版が非表示)
1行目: 1行目:
= このページは作成中です =
[[PlayN:Top|Top]] > eclipseの開発環境構築からサンプルプロジェクトの実行まで


__TOC__


__TOC__
== はじめに ==
== はじめに ==
ここでは公式サイトのGettingStartedの内容をベースに、
ここでは公式サイトのGettingStartedの内容をベースに、
18行目: 18行目:
その際に忘れずにJava6のJDKの設定をして下さい。
その際に忘れずにJava6のJDKの設定をして下さい。
メニューバーの「Window」→「Preferences」から、「Java」→「Installed JREs」から設定します。
メニューバーの「Window」→「Preferences」から、「Java」→「Installed JREs」から設定します。
* TODO 画像を貼る(PlayN_GettingStarted_Eclipse_1.png)
[[ファイル:PlayN_GettingStarted_Eclipse_1.png|none|300px]]
 


== Google Plugin for Eclipseのインストール ==
== Google Plugin for Eclipseのインストール ==
29行目: 28行目:
URLに次のURLを入力します。
URLに次のURLを入力します。
* http://dl.google.com/eclipse/plugin/3.7
* http://dl.google.com/eclipse/plugin/3.7
* TODO 画像を貼る(PlayN_GettingStarted_Google_1.png)
[[ファイル:PlayN_GettingStarted_Google_1.png|Google系ツールのインストール|none|300px]]
後は流れに沿ってインストールを完了させます。
後は流れに沿ってインストールを完了させます。


42行目: 41行目:
URLに次のURLを入力します。
URLに次のURLを入力します。
* https://dl-ssl.google.com/android/eclipse/
* https://dl-ssl.google.com/android/eclipse/
* TODO 画像を貼る(PlayN_GettingStarted_Android_1.png)
[[ファイル:PlayN_GettingStarted_Android_1.png|Android Pluginのインストール|none|300px]]
後は流れに沿ってインストールを完了させます。
後は流れに沿ってインストールを完了させます。


48行目: 47行目:
これも流れに沿ってインストールを完了させます。
これも流れに沿ってインストールを完了させます。
別途インストールしている場合はそちらのパスを指定します。
別途インストールしている場合はそちらのパスを指定します。
* TODO PlayN_GettingStarted_Android_2.png
[[ファイル:PlayN_GettingStarted_Android_2.png|Android SDKのインストール|none|300px]]


標準ではAndroidの最低限のライブラリしかインストールされないので、
標準ではAndroidの最低限のライブラリしかインストールされないので、
必要に応じてメニューバーの「Window」→「Android SDK Manager」からインストールして下さい。
必要なプラグインを追加インストールします。
* TODO PlayN_GettingStarted_Android_3.png
最低でもAPI 11以下の「SDK Platform」をインストールして下さい。
[[ファイル:PlayN_GettingStarted_Android_3.png|Android SDKのAddOnのインストール|none|300px]]




61行目: 61行目:
URLに次のURLを入力します。
URLに次のURLを入力します。
* http://download.jboss.org/jbosstools/updates/m2eclipse-wtp
* http://download.jboss.org/jbosstools/updates/m2eclipse-wtp
* TODO 画像を貼る(PlayN_GettingStarted_m2e_1.png)
[[ファイル:PlayN_GettingStarted_m2e_1.png|Maven Pluginのインストール|none|300px]]
後は流れに沿ってインストールを完了させます。
後は流れに沿ってインストールを完了させます。


このプラグインについてくるMavenのバージョンは3.0.2と古く、
このプラグインについてくるMavenのバージョンは3.0.2と古く、
Android SDKは3.0.3以降が必要になるので本家サイトから別途最新版をインストールします。
Android SDKが3.0.3以降を必要とするので本家サイトから別途最新版をインストールします。
* http://maven.apache.org/download.html
* http://maven.apache.org/download.html
適当な場所に展開し、展開が終わったらEclipseの設定で展開したディレクトリを指定します。
適当な場所に展開し、展開が終わったらEclipseの設定で展開したディレクトリを指定します。
* TODO 画像を貼る(PlayN_GettingStarted_m2e_2.png)
[[ファイル:PlayN_GettingStarted_m2e_2.png|Maven3.0.3の展開と設定|none|300px]]
 
次にMavenからAndroid SDKが使えるように、設定ファイルにAndroid SDKへのパスを追加します。
「展開したディレクトリ/cons/settings.xml」を修正します。
次の内容を<profiles>の下に追加します。
<blockquote>
    <profile>
      <id>android</id>
        <properties>
          <android.sdk.path>
            C:\android-sdks
          </android.sdk.path>
        </properties>
    </profile>
</blockquote>
次の内容を<settings>の下に追加します(ルート要素)。
<blockquote>
  <activeProfiles> <!--make the profile active all the time -->
    <activeProfile>android</activeProfile>
  </activeProfiles>
</blockquote>


次にMavenからJavaのtools.jarとAndroid SDKが使えるように環境変数を設定します。
*JAVA_HOME : インストールしているJDKへのパスを指定します
*ANDROID_HOME : 上でインストールしたAndroid SDKへのパスをしていします
[[ファイル:PlayN_GettingStarted_m2e_3.png|環境変数の設定|none|300px]]




101行目: 85行目:
URLに次のURLを入力します。
URLに次のURLを入力します。
* http://download.eclipse.org/egit/updates
* http://download.eclipse.org/egit/updates
* TODO 画像を貼る(PlayN_GettingStarted_EGit_1.png)
[[ファイル:PlayN_GettingStarted_EGit_1.png|EGitのインストール|none|300px]]
後は流れに沿ってインストールを完了させます。
後は流れに沿ってインストールを完了させます。


インストール後、必要に応じてGitの設定を変更します。
インストール後、必要に応じてGitの設定を変更します。
特にDefault Repository Folderは後で触るので確認しておいて下さい。
特にDefault Repository Folderは後で触るので確認しておいて下さい。
* TODO 画像を貼る(PlayN_GettingStarted_EGit_1.png)
[[ファイル:PlayN_GettingStarted_EGit_2.png|EGitの設定|none|300px]]




== デモプロジェクトのクローン(取得) ==
== サンプルプロジェクトのクローン(取得) ==
Eclipseを起動し、パースペクティブを「Git Repository Exploring」に切り替えます。
Eclipseを起動し、パースペクティブを「Git Repository Exploring」に切り替えます。
リポジトリのクローンを押し、ダイアログを開いてサンプルプロジェクトのURLを入力します。
リポジトリのクローンを押し、ダイアログを開いてサンプルプロジェクトのURLを入力します。
* https://code.google.com/p/playn-samples
* https://code.google.com/p/playn-samples
* TODO 画像を貼る(PlayN_GettingStarted_Checkout_1.png)
[[ファイル:PlayN_GettingStarted_Checkout_1.png|サンプルプロジェクトのクローン|none|300px]]


チェックアウトが終われば、Javaパースペクティブに戻りプロジェクトをインポートします。
クローンが終われば、Javaパースペクティブに戻りプロジェクトをインポートします。
メニューバーから「File」→「Import」を選びます。
メニューバーから「File」→「Import」を選びます。
「Existing Maven Project」を選びます。
「Existing Maven Project」を選びます。
* TODO 画像を貼る(PlayN_GettingStarted_Checkout_2.png)
[[ファイル:PlayN_GettingStarted_Checkout_2.png|サンプルプロジェクトのインポート1|none|300px]]
「Root Directory」にクローンされたプロジェクトのディレクトリを選びます。
「Root Directory」にクローンされたプロジェクトのディレクトリを選びます。
すると内包されるプロジェクトがすべて表示されるので、全て選択してFinishを押します。
すると内包されるプロジェクトがすべて表示されるので、全て選択してFinishを押します。
* TODO 画像を貼る(PlayN_GettingStarted_Checkout_3.png)
[[ファイル:PlayN_GettingStarted_Checkout_3.png|サンプルプロジェクトのインポート2|none|300px]]
 
 
== サンプルプロジェクトの準備 ==
サンプルプロジェクトには次のようなものがあります。
*hello - PlayNプラットフォームのすべての作業プロジェクトを作成するための必要最小限のスケルトン
*showcase - PlayNフレームワークのいろんな機能のデモ
*cute - もうちょっとゲームっぽいもの(注:今のところはなはだ不完全)
 
そのままでは実行に必要な外部パッケージがインストールされていないので、
Mavenを実行してインストールして貰います。
これらのプロジェクトを選んで「Run As」→「Maven install」を選ぶことで実行できます。。
[[ファイル:PlayN_GettingStarted_ProjectInst_1.png|Mavenによる外部パッケージのインストール|none|300px]]
 
実行をが完了すると次のようなログがでて完了します。
<pre>
[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] ------------------------------------------------------------------------
</pre>
 
途中で失敗して再実行する場合は、Maven Cleanしてから再実行すると良いようです。
 
(設定が巧くできてないといろんなエラーが出ますが・・・)
 
 
== サンプルプロジェクトの構成 ==
各サンプルプロジェクトを見ると、複数のプロジェクトから構成されていることがわかります。
それぞれ次のような構成になっています。
 
*プロジェクト名 : ルートとなるプロジェクト
*プロジェクト名-android : Android向けにリリースするためのコードを持つプロジェクトです。
*プロジェクト名-core : 全てのリリースの共通するコードを持つプロジェクトです。
*プロジェクト名-html : HTML+JavaScriptにリリースするためのコードを持つプロジェクトです。
*プロジェクト名-java : Javaアプリケーションにリリースするためのコードを持つプロジェクトです。
 
ゲームの内容は「プロジェクト名-core」のプロジェクトに含めることになります。
 
 
== サンプルプロジェクトの実行 ==
=== Javaアプリケーションとして実行 ===
プロジェクト名-javaのmainクラスを右クリックして、「Run As」→「Java Application」で実行できます。
[[ファイル:PlayN_GettingStarted_Sample_Java_1.png|Javaアプリケーションとして実行1|none|300px]]
[[ファイル:PlayN_GettingStarted_Sample_Java_2.png|Javaアプリケーションとして実行2|none|300px]]


=== Androidアプリケーションとして実行 ===
プロジェクト名-androidのプロジェクトを右クリックして、「Run As」→「Maven Build」を選びます。
[[ファイル:PlayN_GettingStarted_Sample_Android_1.png|Androidアプリケーションとして実行1|none|300px]]
次に開いたダイアログでGoalsに「android:deploy」を指定してRunを押します。
[[ファイル:PlayN_GettingStarted_Sample_Android_2.png|Androidアプリケーションとして実行2|none|300px]]
APKが作成された後、デバイスにインストールされます(起動は手動)。
[[ファイル:PlayN_GettingStarted_Sample_Android_3.jpg|Androidアプリケーションとして実行3|none|300px]]


TODO
=== HTMLとして実行 ===
プロジェクト名-htmlのプロジェクトを右クリックして、「Run As」→「Web Application」を選びます。
[[ファイル:PlayN_GettingStarted_Sample_Html_1.png|HTMLとして実行1|none|300px]]
次に「Development Mode」のタブからURLをダブルクリック(または右クリックでOpen)で開きます。
GWTのプラグインのインストールが求められた場合はインストールして下さい。
[[ファイル:PlayN_GettingStarted_Sample_Html_2.png|HTMLとして実行2|none|300px]]
この場合はデバッグモードで動作しているため、速度が遅くなります。
通常モードで動作させるにはURLの後ろに付いている「?gwt.codesvr=*****」を削ったURLにアクセスします。


== デモプロジェクトのビルド ==
このときコンパイルされていないと「GWT module '*****' may need to be (re)compiled」というアラートが表示されます。
TODO
コンパイルするには次の手順で行います。
プロジェクト名-htmlのプロジェクトを右クリックして、「Google」→「GWT Compile」を選びます。
[[ファイル:PlayN_GettingStarted_Sample_Html_3.png|HTMLとして実行3|none|300px]]
コンパイルが完了したらブラウザで再度アクセスします。ゲーム画面が表示されます。
[[ファイル:PlayN_GettingStarted_Sample_Html_4.png|HTMLとして実行4|none|300px]]


== デモプロジェクトの実行 ==
TODO


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

2011年11月29日 (火) 23:53時点における最新版

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

はじめに

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

Eclipseの入手

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

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

Google Plugin for Eclipseのインストール

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

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

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

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


Android Plugin for Eclipseのインストール

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

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

Android Pluginのインストール
Android Pluginのインストール

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

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

Android SDKのインストール
Android SDKのインストール

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

Android SDKのAddOnのインストール
Android SDKのAddOnのインストール


Maven Integration for WTPのインストール

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

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

Maven Pluginのインストール
Maven Pluginのインストール

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

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

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

Maven3.0.3の展開と設定
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のインストール
EGitのインストール

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

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

EGitの設定
EGitの設定


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

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

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

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

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

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

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


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

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

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

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

Mavenによる外部パッケージのインストール
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」で実行できます。

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

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

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

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

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

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

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

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

HTMLとして実行

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

HTMLとして実行1
HTMLとして実行1

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

HTMLとして実行2
HTMLとして実行2

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

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

HTMLとして実行3
HTMLとして実行3

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

HTMLとして実行4
HTMLとして実行4


まとめ

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