Mavenの基礎インストールと設定

Mavenの基本操作と環境構築

1. Mavenとは?

MavenはJavaプロジェクトにおける依存管理とプロジェクト情報の標準化を実現するビルドツールです。

2. Mavenの主な機能

  • ライブラリ(jarファイル)の自動ダウンロードと管理
  • プロジェクト構造の標準化
  • 一貫したビルドプロセスの提供

3. Mavenのインストール手順

ステップ1:ダウンロードと解凍

公式サイト Download Apache Maven から最新バージョンをダウンロードし、任意のディレクトリに解凍します。

ディレクトリ構成の説明:

  • bin:Mavenの実行ファイルが含まれます。Java_HOMEのパスが設定されていることを確認できます。
  • boot:Mavenのクラスローダーに関するファイルが含まれます。
  • conf:設定ファイル(settings.xmlなど)が含まれます。
  • lib:Mavenの動作に必要なライブラリが含まれます。

ステップ2:環境変数の設定

  1. M2_HOME(またはMAVEN_HOME)を新規作成し、Mavenのインストールディレクトリを指定します(例:C:\Maven\apache-maven-3.9.2)。
  2. システムのPathに%M2_HOME%\binを追加します。
  3. コマンドプロンプトでmvn -vを実行し、バージョン情報が表示されればインストール成功です。

4. Mavenの基本コンセプト

4.1 リポジトリ

  • ローカルリポジトリ:開発者のPC上に存在するライブラリのキャッシュ
  • リモートリポジトリ:ネットワーク経由でアクセスするリポジトリ
    • 中央リポジトリ:Maven公式のデフォルトリポジトリ
    • プライベートリポジトリ:企業やチーム内でのみ使用されるリポジトリ

4.2 座標(Coordinates)

Mavenでは、ライブラリを一意に識別するために以下の座標を使用します:

  • groupId:組織名(例:com.example)
  • artifactId:プロジェクト名(例:my-app)
  • version:バージョン番号(例:1.0.0)
  • packaging:出力形式(jar, warなど)

5. ローカルリポジトリのカスタム設定

デフォルトではC:\Users\ユーザー名\.m2\repositoryに保存されますが、容量が大きくなるためDドライブなどに変更する例:

<localRepository>D:/maven/repository</localRepository>

この設定をconf/settings.xmlに記載します。

6. リモートリポジトリのミラー設定

海外のリポジトリはアクセスが遅いため、Aliyunのミラーを使用する設定:

<mirrors>
  <mirror>
    <id>aliyun-mirror</id>
    <url>https://maven.aliyun.com/repository/public</url>
    <mirrorOf>central</mirrorOf>
  </mirror>
</mirrors>

7. グローバル設定とユーザ設定の違い

  • グローバル設定(conf/settings.xml):マシン全体に適用される共通設定
  • ユーザ設定(~/.m2/settings.xml):特定のユーザにのみ適用される個別設定

タグ: Maven Java 依存管理 プロジェクト構成 リポジトリ

7月8日 23:31 投稿