MacにSpring Tool Suiteを導入する

はじめに

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

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

本記事のターゲット

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

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

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

WindowsにSpring Tool Suiteを導入する

JDKのインストール

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

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

brew cask install java

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

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

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

# 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等、ご自身の環境に合わせてご対応ください。同様に以下も追加してください。

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

Mavenのインストール

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

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

brew install maven

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

/usr/local/Cellar/maven/3.5.3/libexec

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

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

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

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

settings.xmlの設置

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

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

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

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

  <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

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

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

Spring Tool Suite の日本語化

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

Pleiades - Eclipse プラグイン日本語化プラグイン

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

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

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

Spring Tool Suite の起動

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

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

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

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

Mavenの設定

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

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

Lombokの導入

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

Lombok Project Download

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

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

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

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

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

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

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

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