7. Asakusa Frameworkのインストール¶
このチュートリアルでは、開発環境に対してAsakusa Frameworkのインストールを行います。
7.1. 開発環境にAsakusa Frameworkをインストールする¶
プロジェクトの作成 でプロジェクトを準備したら、次に開発環境にAsakusa Frameworkの実行環境をインストールします。 この実行環境は、アプリケーションのテスト実行時などに使用します。
プロジェクトの作成 で作成したプロジェクトには、Asakusa Frameworkのインストールやデプロイに関する構成情報が含まれています。 このため、Asakusa Frameworkのインストールやデプロイ用のパッケージ生成はプロジェクトに対して実行します。
7.1.1. Eclipseからインストール¶
Shafuを導入したEclipse環境では、EclipseのコンテキストメニューからAsakusa Frameworkのインストールを実行することができます。
- Javaパースペクティブ上でプロジェクト
asakusa-tutorialを選択してコンテキストメニュー(右クリックなどで表示されるメニュー)を表示し、 コンテキストメニューから を選択します。
| [1] | 以降のチュートリアルでは、Consoleビューへの出力は単に「コンソール」と表記し、その出力内容のみを記述します。 |
| [2] | Shafuの他のメニューを実行する場合も同様です。以降のチュートリアルではメニューを実行した際に、このメッセージを確認してください。 |
7.1.2. コマンドラインからインストール¶
コマンドライン上からインストールする場合、Gradleの installAsakusafw タスクを実行します。
プロジェクト上でタスクを実行するには、ターミナル上でプロジェクトのディレクトリに移動して、 以下のように gradlew コマンド (Windows環境の場合は gradlew.bat コマンド) にタスク名を指定して実行します。
./gradlew installAsakusafw
gradlew.bat installAsakusafw
正常に終了すると、以下のように BUILD SUCCESSFUL と出力されます。
:installAsakusafw
Asakusa Framework is successfully installed: C:\Users\asakusa\asakusa
BUILD SUCCESSFUL
Total time: 12.358 secs
Note
以降のチュートリアルでは、Gradleを使ったコマンドラインの実行例はUnix系OSの例のみを記載します。 Windowsを利用している場合は、チュートリアルの説明を適宜読みかえて進めてください。
7.2. トラブルシューティング¶
このチュートリアルに関するトラブルシューティングです。
7.2.1. Asakusa Frameworkのインストールに失敗する¶
開発環境にAsakusa Frameworkをインストールする の手順を実行すると、以下のエラーメッセージが表示されインストールに失敗する。
...
:updateAsakusafw FAILED
FAILURE: Build failed with an exception.
* What went wrong:
Execution failed for task ':updateAsakusafw'.
> ASAKUSA_HOME is not defined
...