Maven

新しい Maven プロジェクトを作成する

1. IntelliJ IDEA で現在開いているプロジェクトがない場合は、ウェルカム画面で新規プロジェクトをクリックします。それ以外の場合は、メインメニューからファイル | 新規 | プロジェクトを選択します。

   

2. 新しいプロジェクトに名前を付け、必要に応じてその場所を変更します。

3. Git リポジトリの作成を選択して、新しいプロジェクトをバージョン管理下に置きます。

   後でいつでもそれを行うことができます。

4. プロジェクトで使用する言語を選択します。プラグインを介して利用可能な他の言語を追加する場合は、 をクリックします。

5. ビルドシステムのリストから Maven を選択します。

6. プロジェクトの SDK(JDK) を指定するか、デフォルトの SDK を使用します。

7. サンプルコードの追加オプションを選択すると、基本的なコードサンプルを含むファイルが作成されます。

8. 詳細設定で、pom.xml ファイルに追加される次の Maven の座標(英語)を指定します。

   • グループ ID - 新しいプロジェクトのパッケージ。

   • アーティファクト ID - プロジェクトの名前。

   Maven 座標の詳細については、「Maven の命名規則(英語)」を参照してください。

9. 作成をクリックします。

   IntelliJ IDEA は、Java のコンパイラーソースバージョンとターゲットバージョン、専用の Maven ツールウィンドウ、および作業を開始するために必要なすべての依存関係を含む pom.xml ファイルを使用して Maven プロジェクトを作成します。

Maven アーキタイプで新しいプロジェクトを作成する

1. 新規プロジェクトウィザードを起動します。現在 IntelliJ IDEA でプロジェクトが開かれていない場合は、ウェルカム画面で新規プロジェクトをクリックします。それ以外の場合は、メインメニューからファイル | 新規 | プロジェクトを選択します。

   

2. 左側のオプションから Maven アーキタイプ(英語)を選択します。

3. 右側のオプションを使用して、プロジェクトを構成します。

   • 名前 : プロジェクトの名前を指定します。

   • ロケーション : プロジェクトの場所を指定します。

   • Git リポジトリの作成 :

     Git リポジトリの作成を選択して、新しいプロジェクトをバージョン管理下に置きます。

     後でいつでもそれを行うことができます。

   • JDK : プロジェクトの SDK(JDK) を指定するか、デフォルトの SDK を使用します。

   • カタログ : プロジェクトで使用する Maven リポジトリを指定します。

     内部 Maven カタログ(英語)はデフォルトのカタログです。.m2 ディレクトリにあるローカルリポジトリを選択することも、Maven 中央リポジトリ(英語)を選択することもできます。

     必要に応じて、カタログの管理をクリックして、カスタムリポジトリを追加することもできます。

   • アーキタイプ : 必要な Maven アーキタイプ(英語)を選択します。追加をクリックして、カスタムアーキタイプを指定します。

   • バージョン : バージョンは自動的に指定されます。

   • 追加プロパティ : プロパティを追加する

ビルドツールとして Maven を使用して Jakarta EE プロジェクトを作成する

1. 新規プロジェクトウィザードを起動します。現在 IntelliJ IDEA でプロジェクトが開かれていない場合は、ウェルカム画面で新規プロジェクトをクリックします。それ以外の場合は、メインメニューからファイル | 新規 | プロジェクトを選択します。

2. ジェネレーターのリストから Jakarta EE を選択します。

3. ビルドツールシステムとして、デフォルトオプション Maven を残します。

4. 追加のライブラリとフレームワークを選択します。

5. プロジェクトの名前、場所、アーティファクトの座標を指定します。作成をクリックします。

   IntelliJ IDEA は、専用の Maven ツールウィンドウで Maven プロジェクトを作成し、必要な依存関係を追加します。

   詳細については、チュートリアル: 最初の Jakarta EE アプリケーションを参照してください。

既存の Maven プロジェクトを開く

1. ファイル | オープンに移動します。

   または、ウェルカム画面でオープンをクリックします。

2. 開いたダイアログで、開きたいプロジェクトの pom.xml ファイルを選択します。

   OK をクリックします。

3. 開いたダイアログで、プロジェクトとして開くをクリックします。

IntelliJ IDEA は、IDE で Maven プロジェクトを開いて同期します。プロジェクトを開くときにインポートオプションを調整する必要がある場合は、Maven 設定を参照してください。例: maven/config ファイルで Maven オプションを構成していて、プロジェクトで使用する場合は、Maven 設定で .mvn/maven.config の設定を使用するオプションを選択します。

新しいプロジェクトを開く前に、Maven 設定を構成する

新しい Maven プロジェクトを開く前に、Maven 設定を表示するように IntelliJ IDEA を構成できます。（この場合の新しい Maven プロジェクトは、IntelliJ IDEA で初めて開く既存のプロジェクトです。）これらはアプリケーションレベルの設定であるため、開くすべての新しいプロジェクトに適用されます。

1. ウェルカム画面で、カスタマイズ | すべての設定を選択します。

   または、メインメニューのファイル | 新しいプロジェクトの設定 | 新規プロジェクトの設定に移動します。

2. 設定ダイアログで、ビルド、実行、デプロイ | ビルドツール | Maven を選択します。

3. Maven 設定ダイアログで、新規 Maven プロジェクトの設定ダイアログを表示するを選択します。

4. 変更を保存するには、OK をクリックします。

   次に新しいプロジェクトを開くと、IntelliJ IDEA は Maven 設定ダイアログを表示します。このダイアログでは、ローカル Maven リポジトリとユーザー設定ファイルの場所を指定できます。

   

既存のプロジェクトに新しい Maven モジュールを追加する

すでに作業しているプロジェクトに Maven モジュールを追加することができます。

1. プロジェクトツールウィンドウでプロジェクトフォルダーを右クリックし、新規 | モジュールを選択します。または、メインメニューのファイル | 新規 | モジュールに移動して、新規モジュールウィザードを開きます。

2. メインメニューを使用してモジュールを追加した場合、モジュールを追加するプロセスは新しい Maven プロジェクトの作成と同じです。

   ルートフォルダーを右クリックしてサブモジュールを追加する場合、新しいモジュールを追加するプロセスが短くなります。名前フィールドにモジュールの名前を指定する必要があります。残りの情報は自動的に追加され、デフォルト設定を使用することも、好みに応じて変更することもできます。

マルチモジュール Maven プロジェクトを構成する

IntelliJ IDEA でマルチモジュール Maven プロジェクト(英語)を作成できます。マルチモジュールプロジェクトは、いくつかのサブモジュールを含む親 POM ファイルによって定義されます。

1. Maven 親プロジェクトを作成します。IntelliJ IDEA は、src フォルダーを含む標準 Maven レイアウトを作成します。

2. 非常にまれなケース(英語)でのみ必要になるため、プロジェクトツールウィンドウで src フォルダーを削除します。一般的なプロジェクトでは、親 POM 用の src フォルダーは必要ありません。

3. プロジェクトツールウィンドウでプロジェクトを右クリックし (またはメインメニューでファイルに移動し)、新規 | モジュールを選択してサブプロジェクトを追加します。

4. 新規モジュールウィザードで、モジュールを追加する方法の指示に従って、必要な情報を指定し、完了をクリックします。

   src フォルダーが自動的に作成されるため、POM を開いて必要なパッケージを追加できます。IntelliJ IDEA はモジュールを親プロジェクトに追加します。IntelliJ IDEA は、サブプロジェクトの名前と説明も親 POM に追加します。

   

   最後に、IntelliJ IDEA は親 POM の説明をサブプロジェクトの POM に追加します。

   

   左側のガターにある をクリックすると、サブプロジェクトから親 POM をすぐに開くことができます。

5. サブプロジェクトによって継承される親 POM に依存関係を追加することもできます。

   

6. Maven ツールウィンドウを開いて、親 POM で行われたすべての変更がサブプロジェクトに反映されていることを確認します。

   

Maven 設定にアクセスする

Maven 設定を使用して、Maven バージョン、ローカルリポジトリ、オフラインモードなどのオプションを設定します。

1. 設定ダイアログ（Ctrl+Alt+S）で、ビルド、実行、デプロイ | Maven に移動します。

2. Maven 設定ページで、利用可能なオプションを設定し、OK をクリックして変更を保存します。

Maven ラッパーまたは Maven のカスタムバージョンを使用する

1. Ctrl+Alt+S を押して設定を開き、ビルド、実行、デプロイ | ビルドツール | Maven を選択します。

2. Maven 設定ページの Maven ホームパスフィールドで、Maven カスタムバージョンのインストール場所を指定します。Maven ラッパーの場合は、リストから Maven ラッパーを使用するオプションを選択します。この場合、.mvn/wrapper/maven-wrapper.properties ファイルで定義されているバージョンの Maven が使用されます。

   

3. OK をクリックします。