5. Eclipse環境のセットアップ

このチュートリアルでは、Asakusa Frameworkの開発で利用するEclipse環境のセットアップを行います。

Note

[Asakusa Framework documentation] - Asakusa Frameworkスタートガイド などの手順を実施済みなど、すでにEclipse環境が手元に整っている場合はこのチュートリアルの手順はスキップすることができます。

5.1. Eclipseの起動

開発環境の準備 で用意した環境上でEclipseを起動します。

起動時には、必ず環境変数 ASAKUSA_HOME が適用された状態で起動してください。

5.2. Eclipseの設定

Asakusa Frameworkの開発環境向けにEclipseの設定を行います。

以降の設定はEclipseの設定画面から行います。 Eclipseのメニューバーから Window ‣ Preferences で設定画面を表示します。

5.2.1. EclipseのJDK登録

Eclipse経由で実行するJavaにJREが設定されている場合、これをJDKに変更する必要があります。

  1. Eclipseの設定画面から Java ‣ Installed JREs を選択します。
  2. Installed JREs ダイアログにJREのJava定義が表示されている場合 (例えば以下のように jre8 から始まる項目が表示されている場合)、以降の手順を実施してください。JDKが登録されている場合は以降の手順は不要です。
_images/installed-jre-jre8.png
  1. JREを削除します。 削除する項目を選択して、 Remove ボタンを押下します。
  2. JDKを追加します。 Add ボタンを押下します。
  3. JRE Type ダイアログで Standard VM を選択し Next > ボタンを押下します。
  4. JRE Definition ダイアログで JRE home: の項目右の Directory… ボタンを押下し、JDKのフォルダを指定します。
_images/add-jre-jdk8.png
  1. JRE Definition ダイアログの各項目にインストールしたJDKの情報が設定されたことを確認して Finish ボタンを押下します。
  2. Installed JREs ダイアログに追加したJDKの項目が表示されるので、その項目の Name 欄に表示されているチェックボックスを ON にします。 JDKの項目が jdk1.8.0_XX (default) のような表示になれば設定完了です。
_images/installed-jre-jdk8.png

5.2.2. ネットワークプロキシの設定

オンラインとの接続にプロキシサーバを経由する必要がある場合は、Eclipseのプロキシ設定画面でプロキシの設定を行います。

  1. Eclipseの設定画面から General ‣ Network Connections を選択します。
  2. プロキシ設定画面で、 Active Provider:Manual に変更し、 Proxy entriesProxy bypass の内容を編集して OK ボタンを押します。

5.3. Shafuのインストール

Asakusa Frameworkには開発支援ツールを提供する Jinrikisha というサブプロジェクトがあります。 そこで公開しているツール Shafu はAsakusa Frameworkのアプリケーション開発を支援するEclipseプラグインです。

Asakusa Frameworkではアプリケーションのビルドに Gradle というビルドシステムを利用しますが、 Shafuを使うことでGradleに関する詳細な知識がなくてもAsakusa Frameworkの基本的な開発作業が行えるようになります。 また、コマンドライン上でのGradleの操作が不要となり、Eclipse上でアプリケーション開発に必要なほとんどの作業を行うことができるようになります。

Shafuは一般的なEclipseプラグインと同様の手順でEclipseにインストールすることができます。

  1. Eclipseのメニューバーから Help ‣ Install New Software… を選択します。
  2. Install ダイアログで Work with: の項目右の Add ボタンを押下します。
  3. Add Repository ダイアログに以下の値を入力します。
Name: Jinrikisha
Location: http://www.asakusafw.com/eclipse/jinrikisha/updates/
  1. Install ダイアログに表示された Jinrikisha (人力車) カテゴリを展開して Asakusa Gradle プラグインサポート を選択し、 Next > ボタンを押下します。
_images/install-shafu.png
  1. 以降、画面の指示に従いインストールを進めます。Eclipseの再起動を促されたら Yes を選択します。
  2. Eclipseの再起動が完了したら Java パースペクティブを選択し、 メニューバーから Window ‣ Perspective ‣ Reset Perspective.. を選択して Java パースペクティブを初期化します。
_images/reset-perspective.png

以降では、Eclipse上での作業は Java パースペクティブを使います。また、Eclipseの画面左側には Package Explorer を表示しているものとします。

5.4. Shafuの設定確認

チュートリアルの環境向けにShafuの設定を確認します。

  1. Eclipse設定画面から Jinrikisha (人力車) を選択します。
  2. 基本 タブの Gradleのバージョンをラッパーの設定情報から取得 のチェックがONになっていることを確認します。
_images/preference-jinrikisha-basic.png

Note

上記の設定画面に Gradleのバージョンをラッパーの設定情報から取得 の項目がない場合は、インストールされているShafuのバージョンが古い可能性があります。 この項目はShafuのバージョン 0.7.0 から追加されたため、これ以前のバージョンがインストールされている場合、通常のEclipse Pluginをアップデートする方法でShafuをアップデートしてください。

  1. Eclipseの設定画面から Jinrikisha (人力車) ‣ Asakusa Framework を選択します。
_images/preferences-asakusa-home.png
  1. フレームワークのインストール先 (ASAKUSA_HOME) の値に、環境変数 ASAKUSA_HOME の値が表示されていることを確認します。

    この値が空欄になっている場合、環境変数 ASAKUSA_HOME がEclipseの実行プロセスに反映されていないため、環境変数を正しく設定してEclipseを再起動してください。