MacにSpring Tool Suiteを導入する

# はじめに

仕事でJava Springを扱うことになったので、備忘録もかねて環境構築の手順を記載します。

各ソフトのダウンロードやインストールに時間がかかりますので、まとまった時間があるときに実施した方がよいです。



# 本記事のターゲット

本記事は、Web開発の経験はあるけどJava Springは初めてという人を対象にします。

また、PCはMacを想定しています。

Windowsの場合は、別に記事を作りましたので、こちらをご参照ください。

[WindowsにSpring Tool Suiteを導入する](https://qiita.com/segur/items/4cd283d9763a1953f336)



# JDKのインストール

まずはJDKのインストールが必要です。

Homebrewがあるなら、以下のコマンドでインストールできます。

```bash
brew cask install java
```

すると、以下のパスにインストールされます。

```bash
/Library/Java/JavaVirtualMachines/jdk1.8.0_172.jdk/Contents/Home
```

環境変数に以下を追加してください。

```bash
# JAVA_HOMEに1.8を指定
export JAVA_HOME=/Library/Java/JavaVirtualMachines/jdk1.8.0_172.jdk/Contents/Home

# 常に最新版のJDKを指定したい場合はこちら
export JAVA_HOME=`/usr/libexec/java_home`
```

環境変数の設定ファイルは.bash_profileや.zprofile等、ご自身の環境に合わせてご対応ください。同様に以下も追加してください。

```bash
# PATHの先頭に追加
export PATH=$JAVA_HOME/bin:$PATH
```



# Mavenのインストール

次にMavenのインストールが必要です。

Homebrewがあるなら、以下のコマンドでインストールできます。

```bash
brew install maven
```

すると、以下にインストールされます。

```bash
/usr/local/Cellar/maven/3.5.3/libexec
```

環境変数に以下を追加してください。

```bash
# M2_HOMEを作成
export M2_HOME=/usr/local/Cellar/maven/3.5.3/libexec
```

同様に以下も追加してください。

```bash
# PATHの先頭に追加
export PATH=$M2_HOME/bin:$PATH
```



## settings.xmlの設置

ユーザーディレクトリに.m2ファイルを作成し、settings.xmlをコピーします。

```bash
# .m2ディレクトリを作成
mkdir ~/.m2

# settings.xmlをコピー
cp $M2_HOME/conf/settings.xml ~/.m2
```

必要であれば、100行目あたりに、プロキシの設定ができるので、コメントアウトを外して編集します。

```xml
  <proxies>
    <!-- proxy
     | Specification for one proxy, to be used in connecting to the network.
     |
     |-->
    <proxy>
      <id>optional</id>
      <active>true</active>
      <protocol>http</protocol>
      <username>proxyuser</username>
      <password>proxypass</password>
      <host>proxy.host.net</host>
      <port>80</port>
      <nonProxyHosts>local.net|some.host.com</nonProxyHosts>
    </proxy>
  </proxies>
```



# Spring Tool Suite のインストール

Spring Tool Suite はSpring専用の統合開発環境です。Eclipseをベースにしています。

[Spring Tool Suite](https://spring.io/tools/sts)

Spring公式のこちらのページから**spring-tool-suite-3.9.4.RELEASE-e4.7.3a-macosx-cocoa-x86_64.dmg**をダウンロードします。

<img width="1052" alt="スクリーンショット 2018-06-21 14.10.35.png" src="https://qiita-image-store.s3.amazonaws.com/0/221845/a8596830-a10a-e5c0-9cdc-d8f7b8fb2779.png">

ダウンロードしたdmgファイルを実行し、中にある**STS.app**をこの**Applications**にコピーしてください。


# Spring Tool Suite の日本語化

必要であれば、日本語化します。

[Pleiades - Eclipse プラグイン日本語化プラグイン ](http://mergedoc.osdn.jp/)

EclipseのページからPleiades プラグイン**pleiades-mac.zip**をダウンロードします。

<img width="904" alt="スクリーンショット 2018-06-21 14.07.46.png" src="https://qiita-image-store.s3.amazonaws.com/0/221845/cc61c682-bd1f-b839-2033-95ec2d7266c1.png">

ZIPファイルを解凍すると、中に**setup.app**というファイルがありますので、実行します。

<img width="863" alt="スクリーンショット 2018-06-21 15.56.48.png" src="https://qiita-image-store.s3.amazonaws.com/0/221845/d5daca66-b895-4b9b-47a0-e928e18c3bce.png">

**選択**をクリックし、**/Applications/STS.app**を指定します。
ファイルが指定できたら、**日本語化する**をクリックします。



# Spring Tool Suite の起動

インストールができたので、**/Applications/STS.app**を起動します。

すると、ワークスペースを設定する画面が出ます。

<img width="606" alt="se67.png" src="https://qiita-image-store.s3.amazonaws.com/0/221845/b2691e76-227a-f89d-d9e4-badbee1ac523.png">

特にこだわりがなければ、そのままの設定で**起動**をクリックしましょう。

<img width="1025" alt="s67.png" src="https://qiita-image-store.s3.amazonaws.com/0/221845/50870860-e597-07fd-5bb8-9c6dc7158495.png">

こんな感じの画面が表示されれば成功です。

# Mavenの設定

STSを起動し、メニューバー→**環境設定**→**Maven**→**インストール**を確認してください。

<img width="754" alt="スクリーンショット 2018-06-21 16.52.39.png" src="https://qiita-image-store.s3.amazonaws.com/0/221845/2b50ea20-2b29-8348-02e3-f1fd1f2ea8e6.png">

もし、インストールしたMavenが一覧になければ、追加してください。


# Lombokの導入

必要であれば、Lombokを導入します。
Lombokは、ビルド時にgetter/setterを自動生成してくれるライブラリで、便利なので使っています。

[Lombok Project Download](https://projectlombok.org/download)

Lombokのページから**lombok.jar**をダウンロードします。

![image.png](https://qiita-image-store.s3.amazonaws.com/0/221845/28a27c77-fb32-5ed4-c8d5-5ca57790c15e.png)

ダウンロードができたら、コマンドプロンプトでlombok.jarを起動します。

```bash
# ダウンロードフォルダへ移動
cd ~/Downloads

# lombok.jarを起動
java -jar lombok.jar
```

起動すると、こんな画面になります。

<img width="837" alt="スクリーンショット 2018-08-04 21.23.14.png" src="https://qiita-image-store.s3.amazonaws.com/0/221845/42ed738a-82aa-28ef-8c94-bfeee603d6f8.png">

１分程待つと、**IDEs**の箇所に、STS.exeのパスがいくつか表示されます。
**/Applications/STS.app**を選択し、**Install / Update**をクリックします。

**Install successful**と表示されたら、lombokの導入は終了です。

以上で終了です。おつかれさまでした。