Maven 入門 | Maven 準備 | Maven のインストール
それでは Maven を準備する。 Maven は次のサイトで公開されている。
Maven のダウンロード
左側のメニューにある “Download” リンクをクリックし、ダウンロードページへ移動する。 ダウンロードページの “Files” に Maven ファイルのダウンロードリンクがある。
Maven は圧縮ファイルとして配布されている。 “Binary tar.gz archive” または “Binary zip archive” のリンクからファイルをダウンロードする。 どちらも内容は同じである。
インストールファイルをダウンロードしたら、圧縮ファイルを展開し、生成されたフォルダを適切な場所に配置する。 Maven のインストールはこれだけである。
ただし、このままでは Maven コマンドを実行するときに正確なパスを指定する必要がある。 どの場所からでもコマンド名だけで実行できるように追加設定を行う。
Maven の実行ファイルは、インストールしたフォルダ内の bin にある。
このフォルダのパスを PATH 環境変数に追加する。
Windows で環境変数を設定する
Windows の場合、環境変数は「システム」コントロールパネルで管理する。 まず「システム」コントロールパネルを開く。
Windows 10 で場所が分からない場合は、スタートメニューを右クリックし、「ファイル名を指定して実行」を選択して control と入力して実行する。
コントロールパネルが表示されるので、そこから「システム」を開く。
「システム」ウィンドウを開き、「詳細設定」をクリックする。
「システム」コントロールパネルの「詳細設定」タブを選択し、「環境変数」ボタンをクリックする。
表示されたダイアログで Path を探し、「編集」ボタンをクリックして Maven の bin フォルダのパスを末尾にセミコロン区切りで追加する。
たとえば C ドライブの maven フォルダに保存している場合は次のようになる。
... existing path value ...;c:\maven\bin\
入力したら OK ボタンを押し、ダイアログとコントロールパネルを閉じれば作業は完了である。
macOS で環境変数を設定する
macOS ではターミナルから bash の隠しファイルを開き、パスを追加する。
$ vi ~/.bash_profile
.bash_profile の末尾に次のように記述する。
PATH=$PATH:/[Maven bin directory]/
export PATH
記述後、Shift + : を押して入力を終え、:wq で保存して終了する。
macOS で Homebrew を使ってインストールする
また、Homebrew を使って Maven をインストールすることもできる。
Homebrew を使った Maven のインストールコマンドは次のとおりである。
% brew install maven
このコマンドを実行すると、次のような出力が表示されながらインストールされる。
Updating Homebrew...
==> Homebrew is run entirely by unpaid volunteers. Please consider donating:
https://github.com/Homebrew/brew#donations
==> Auto-updated Homebrew!
Updated 2 taps (homebrew/core and adoptopenjdk/openjdk).
==> New Formulae
fabric-installer gnupg@2.2 lefthook lychee revive stp webhook
==> Updated Formulae
Updated 250 formulae.
==> Updated Casks
Updated 23 casks.
==> Downloading https://ghcr.io/v2/homebrew/core/openjdk/manifests/15.0.2
######################################################################## 100.0%
... 省略 ...
For compilers to find openjdk you may need to set:
export CPPFLAGS="-I/usr/local/opt/openjdk/include"
mvn コマンドでインストールを確認する
Windows または macOS で環境変数を設定したら、Maven コマンドが正しく認識されているか確認する。 コマンドプロンプトまたはターミナルを開き、次のように実行する。
$ mvn -version
mvn が Maven コマンドである。
Maven が正しく設定されていれば、Maven のバージョン情報が出力される。
おそらく次のような内容が表示される。
Apache Maven version name
Maven home : ... path to Maven's bin directory ...
Java version : ... JDK version ...
Java home : ... Java path ...
Default locale : ... default locale ...
OS name : ... operating system name ...
実際の出力例は次のようになる。
Apache Maven 3.8.1 (05c21c65bdfed0f71a2f2ada8b84da59348c4c5d)
Maven home: /usr/local/Cellar/maven/3.8.1/libexec
Java version: 15.0.2, vendor: N/A, runtime: /usr/local/Cellar/openjdk/15.0.2/libexec/openjdk.jdk/Contents/Home
Default locale: ko_KR, platform encoding: UTF-8
OS name: "mac os x", version: "11.2.3", arch: "x86_64", family: "mac"
kimkc@kimkcui-MacBookPro macaront %
このように表示されれば、Maven のパスは正しく設定されている。
エラーメッセージが表示される場合は、パスが正しく設定されていないか、Java のバージョンが古い可能性がある。
PATH に誤ったパスが追加されていないか、Java が新しいバージョンかを確認する。
インストール場所の確認
% which mvn
/usr/local/bin/mvn