Play Frameworkハンズオン環境構築

環境構築

環境構築にはターミナル(Mac)とコマンドプロンプト(Windows)を使用します。
それぞれ起動方法は次のサイトを参照してください。

ターミナル(Mac)
参考サイト

コマンドプロンプト(Windows)
参考サイト

1.Homebrewのインストール(Macユーザーのみ)

Macでは以降の環境構築手順でHomebrewというパッケージ管理システムを使用します。
Homebrew 公式サイトに書かれている方法を用いてインストールします。

1)Command Line Tools のインストール

Homebrewを使うためには、Command Line Tools for Xcodeをインストールする必要があります。

次のコマンドをターミナルから実行すると、インストールの確認ダイアログが表示されます。
インストールボタンをクリックします。

xcode-select --install

2)Homebrewのインストール

次のコマンドを実行するとインストールされます。

/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

3)インストールの確認

次のコマンドを実行します。

brew --version

次のように表示されれば大丈夫です。
(2019年1月8日時点の最新バージョン：1.8.6)

Homebrew 1.8.6
Homebrew/homebrew-core (git revision 7dfcc; last commit 2019-01-07)

バージョンが古い場合は次のコマンドでアップデートしてください。

brew update

2.Java環境構築

ScalaはJavaプラットフォーム（Java仮想マシン）上で動作するためJVMのインストールが必要になります。また、使用するJDKとしてMac、Windowsでは Amazon Corretto 8 を使用します。

Mac

1)pkgファイルをダウンロード

次のサイトから「amazon-corretto-preview2-8u192-macosx-x64.pkg」をダウンロードします。
https://docs.aws.amazon.com/ja_jp/corretto/latest/corretto-8-ug/downloads-list.html

2)インストール

ダウンロードしたpkgファイルをダブルクリックし、インストール手順に従ってインストールします。

3)環境変数の設定

次の設定を .bash_profile や .zshrc などに記述します。

export JAVA_HOME=/Library/Java/JavaVirtualMachines/amazon-corretto-8.jdk/Contents/Home
export PATH=$JAVA_HOME/bin:$PATH

※ JAVA_HOMEに設定するパスは、こちらのコマンドから取得できます。

 /usr/libexec/java_home

4)インストールの確認

ターミナルを起動し次のコマンドを実行します。

java -version

次のように表示されたら成功です。
(2019年1月8日時点の最新バージョン：1.8.0_192)

openjdk version "1.8.0_192"
OpenJDK Runtime Environment (build 1.8.0_192-amazon-corretto-preview2-b12)
OpenJDK 64-Bit Server VM (build 25.192-b12, mixed mode)

Windows

1)Windowsが32bit版か64bit版か確認する

Windows10の場合次のサイトの手順で確認してください。
確認サイト

Windows8の場合次のサイトの手順で確認してください。
確認サイト

2)ダウンロード

次のサイトから、Windowsが32bit版の場合「amazon-corretto-preview2-8u192-windows-x86.msi」をダウンロードします。64bit版の場合「amazon-corretto-preview2-8u192-windows-x64.msi」をダウンロードします。

3)インストール

ダウンロードしたファイルをダブルクリックしインストールウィザードに従ってください。

4)インストールの確認

コマンドプロンプトを起動し次のコマンドを実行します。

java -version

次のように表示されたら成功です。
(2018年1月8日時点の最新バージョン：1.8.0_192)

openjdk version "1.8.0_192"
OpenJDK Runtime Environment (build 1.8.0_192-amazon-corretto-preview2-b12)
OpenJDK 64-Bit Server VM (build 25.192-b12, mixed mode)

5)もし上記のように表示されない場合は環境変数の設定をお試しください

次のサイトを参考にして環境変数を設定してください。

環境変数の設定

Linux(Ubuntu)

1)インストール

次のコマンドを実行します。

sudo apt install openjdk-8-jdk

2)インストールの確認

コマンドプロンプトを起動し次のコマンドを実行します。

java -version

次のように表示されたら成功です。バージョンは1.8以上であれば大丈夫です。
(2019年1月8日時点の最新バージョン：1.8.0_191)

openjdk version "1.8.0_191"
OpenJDK Runtime Environment (build 1.8.0_191-8u191-b12-0ubuntu0.16.04.1-b12)
OpenJDK 64-Bit Server VM (build 25.191-b12, mixed mode)

3.IntelliJ環境構築

今回のハンズオンはIntelliJを使います。
IntelliJとは、Java言語など多言語対応の統合開発環境です。
Androidの開発環境として有名なAndroid Studioのベースにもなっています。

IntelliJのインストール

1)ダウンロード

Mac

こちらのサイトからCommunityエディションの「DOWNLOAD」をクリックし、.dmgファイルをダウンロードしてください。
ダウンロードサイト

Windows

こちらのサイトからCommunityエディションの「DOWNLOAD」をクリックし、.exeファイルをダウンロードしてください。
ダウンロードサイト

Linux

こちらのサイトからCommunityエディションの「DOWNLOAD」をクリックし、.tar.gzファイルをダウンロードしてください。
ダウンロードサイト

2)インストール

Mac

.dmg パッケージを開いてIntelliJ IDEAをアプリケーションフォルダにドラッグ&ドロップしてください

Windows

.exe ファイルを起動してインストールウィザードに従ってください

Linux

.tar.gzファイルを展開しbin/idea.shを実行します。

./idea.sh

3)IntelliJの設定

IntelliJを起動します。
次のダイアログが表示されますので[I do not have...]を選択し[OK]をクリックします。

[I confirm ...]をチェックし[Continue]をクリックします。

次の画面が表示されます好きなデザインを選択し[Next: Keymaps]をクリックします。

[Next: Launcher Script]をクリックします。

[Next: Default plugins]をクリックします。

[Next: Featured plugins]をクリックします。

Scalaの[Install]をクリックしScalaプラグインをインストールします。最後に[Start using Intellij IDEA]をクリックし完了です。

4.sbtのインストール

sbtとは？

sbtとはScala用のビルドツールになります。
Playframeworkのプロジェクト作成やビルドをするために必要になります。

1)sbtのインストール

Mac

brew install sbt

Windows

次のサイトから[sbt-1.2.8.msi]をダウンロードし、ダブルクリックしてインストールします。
ダウンロードサイト

Linux

こちらのサイトの手順に沿ってインストールします。

インストール

5.プロジェクトの作成

1)プロジェクトを配置するディレクトリに移動

プロジェクトファイルを配置するための適当なディレクトリに移動します。

cd <プロジェクトを配置するディレクトリ>

2)新規プロジェクト作成

sbt new playframework/play-scala-seed.g8

This template generates a Play Scala project 

name [play-scala-seed]: 

ここで「play-hands-on」と入力します。

あとはデフォルトで問題ありません。

This template generates a Play Scala project

name [play-scala-seed]: play-hands-on
organization [com.example]:

Template applied in ./play-hands-on

Windowsでは次のようなエラーが出ることがありますが、無視して問題ありません。

[error] java.io.IOException: Unable to delete file: \AppData\Local\Temp\giter8-86279809762767\src\main\g8\.gitignore
[error] Use 'last' for the full log.

3)プロジェクトが作成されたかの確認

コマンドを実行したディレクトリに「play-hands-on」ディレクトリがあれば大丈夫です。

6.プロジェクトのインポート

1)Import Projectをクリックします。

2)上記で作成したプロジェクトのルートディレクトリを選択します。

3)[Import project from external model]とSBTを選択し[Next]ボタンをクリックします。

4)インポート設定

[Project JDK]の[New...]ボタンをクリックします。

5)次のダイアログで[JDK]を選択します。

6)ディレクトリ選択ダイアログが表示されます。上記でインストールしたJavaを選択します。

Mac

/Library/Java/JavaVirtualMachines/amazon-corretto-8.jdk/Contents/Home

Windows

C:\Program Files\Amazon Corretto\jdk1.8.0_192

Linux

/usr/lib/jvm/java-8-openjdk-amd64

7)Syncが始まります。Syncが完了したら準備は全て完了です。

以上でハンズオンの環境構築は完了です。