マルチプラットフォーム対応ゲームエンジンであるlibGDXの1.0がついにリリースされました。
※ 2014/5/6現在、1.0.1までリリースされています。
1.0前後で様々な改良がなされていますが、ビルドシステムがGradleになったためプロジェクトの作成方法、Eclipseへのインポート方法が変更されています。
まだ日本語での解説ページがありませんでしたので手順を書いておきます。
ここではWindows＋Eclipseの使用を前提とします。
プロジェクト作成ツールは gdx-setup.jar です。
公式サイトでの解説
英語ですが公式サイト見るのが一番ですね…
Getting started
以下の日本語が怪しい時は公式サイトも確認してみてください。
環境作成方法
(公式サイトでの解説はこちら)
Setting up your Development Environment (Eclipse, Intellij IDEA, NetBeans)
事前準備
このへんは既にEclipseでAndroidアプリを開発していれば完了しているでしょうし、解説も多いので割愛します。
- JDK7以降をインストール
- Eclipseをインストール
- Android SDKをインストール
- Android Development Tools for Eclipse(ADT)をインストール
Gradleのための準備
環境変数JAVA_HOMEを設定
最近はJAVA_HOMEの設定は不要な事が多いですが、Gradleでは要求されますので設定してください。
コントロールパネルのシステム詳細設定の環境変数にて以下のように追加してください。
GradleプラグインをEcliseにインストール
Eclipseを起動しメニューの「ヘルプ」→「新規ソフトウェアのインストール」を選択
[追加] ボタンを押す
ロケーションに http://dist.springsource.com/release/TOOLS/gradle と入力。
[OK] ボタンを押す
[Gradle IDE]を選択
[次へ] ボタンを押して、あとは流れでおねがいします。
プロジェクト作成
※ gdx-setup-ui.jarではなくgdx-setup.jarを使用しますので注意。
プロジェクト作成ツールのダウンロード
以下のURLからgdx-setup.jarをダウンロードして下さい。
Download gdx-setup.jar
ダウンロードしたファイルは、Eclipseのワークスペースにおいておくと便利です。
また、libGDXのプロジェクトは対象OSごとに作られて数が膨大になるので、専用のワークスペースを作成することをおすすめします。
手順の中では「workspace_libgdx」というワークスペースで作業しています。
gdx-setup.jarを実行
gdx-setup.jarをダブルクリックで実行します。
以下の様なツールが起動します。
ここでは「GdxAppWithSeveralMsgBox」というプロジェクトを作ることを前提に以下のように設定します。
- Name(プロジェクト名): GdxAppWithSeveralMsgBox
- Packege(パッケージ名): com.dokokano.gdxappwithseveralmsgbox
- Destination(プロジェクト作成フォルダ): C:\workspace_libgdx\GdxAppWithSeveralMsgBox
- Android SDK: ※AndroidSDKをインストールしたフォルダを指定
※ 必要に応じてBox2Dなどのエクステンションをチェックしてください。
[Genarate]ボタンをクリックするとプロジェクトが作成されます。
以下の様なメッセージが表示されれば成功です。
Generating app in C:\workspace_libgdx\GdxAppWithSeveralMsgBox
Executing 'C:\workspace_libgdx\GdxAppWithSeveralMsgBox/gradlew.bat clean'
プロジェクトのインポート
Eclipseのメニューの「ファイル」→「インポート」
「Gradle」→「Gradle Project」を選択
※ 「一般」→「既存プロジェクトをワークスペースへ」ではないので注意
「ルート・フォルダー」に先ほど作成したプロジェクトのパスを入力して[Build Model]ボタンを押す
しばらくすると対象プロジェクトの一覧が表示される。
ルートにチェックを入れると全部にチェックが入る
[完了]を押すとインポートが開始される。
ここでは必要なライブラリなども自動的にダウンロードされる。
※ ネットワークの状況にもよりますが、初回は5～10分かかることもあるので気長に待ってください。
インポートが完了すると以下の様な感じでプロジェクトが追加されます。
(パッケージエクスプローラーでの表示)
デフォルトでbadlogicのロゴが表示されるサンプルコードが生成されます。
package com.dokokano.gdxappwithseveralmsgbox;
import com.badlogic.gdx.ApplicationAdapter;
import com.badlogic.gdx.Gdx;
import com.badlogic.gdx.graphics.GL20;
import com.badlogic.gdx.graphics.Texture;
import com.badlogic.gdx.graphics.g2d.SpriteBatch;
public class MyGdxGame extends ApplicationAdapter {
SpriteBatch batch;
Texture img;
@Override
public void create () {
batch = new SpriteBatch();
img = new Texture("badlogic.jpg");
}
@Override
public void render () {
Gdx.gl.glClearColor(1, 0, 0, 1);
Gdx.gl.glClear(GL20.GL_COLOR_BUFFER_BIT);
batch.begin();
batch.draw(img, 0, 0);
batch.end();
}
}
プロジェクトの実行
Android
- パッケージエクスプローラーの「(プロジェクト名)-Android」を右クリックして「実行」→「Androidアプリケーション」
- 「Androidデバイスの選択」ダイアログが開くので、デバイスを選択して[OK]ボタンを押す。
- Androidデバイス上でアプリが起動する
Desktop (Windows)
- パッケージエクスプローラーの「(プロジェクト名)-Desktop」を右クリックして「実行」→「Javaアプリケーション」
- 「Javaアプリケーションの選択」ダイアログが開くので「DesktopLauncher」を選択して[OK]ボタンを押す
- Windows上でアプリが起動する
以上です。
追記
Gradleはライブラリのダウンロードや更新が自動で行われること、Workspace外にライブラリが格納されるのでリポジトリがライブラリで無駄に肥大化しないのは良いですね。
（リポジトリにコミット辞典のライブラリが含まれていないというのはちょっと不安もありますが、これはそういうものなのかなあ）
プラグインを入れてしまえばEclipseでも違和感なく使えます。
またgdx-setup.jarもずいぶんシンプルでわかりやすくなったし、自動生成されるコードも洗練されてきました。
ちなみにlibGDX、日本ではあまり有名ではないですが2Dゲーム用ライブラリとしては世界的にはCocos2Dを超えるシェアがあるんですよ。
Androidアプリでよく使われているライブラリを調べる方法 の記事で載せましたが、AppBrain statsによると
アプリ数、インストール合計数ともにlibGDXのほうが若干多いです。
先月1.0になったところですが、4年間の実績ありますので海外ではドキュメントやフォーラムの活動が活発です。StackOverflowでもかなりのlibGDX関連記事がありいざというときも安心です。
これを機会に日本でもユーザー増えるといいなあ。