既存の Java プロジェクトに Maven サポートを追加する
このチュートリアルでは、既存の IntelliJ IDEA プロジェクトに Maven サポートを追加し、Maven を使用してビルドする方法を学習します。
Maven は、主に Java 向けのビルド自動化およびプロジェクト管理ツールです。 このチュートリアルでは、シンプルな Java プロジェクトを使用します。
Maven にまったく詳しくない場合は、 Maven スタートガイド(英語)で POM、ビルドライフサイクル、ゴールなどの基本概念について読むことができます。
ただし、このチュートリアルで参照する次の概念を簡単に説明しましょう。
プロジェクトオブジェクトモデル (POM): ビルド構成やその他のプロジェクト情報を含むプロジェクトを記述する XML ファイル (pom.xml)。
ビルドライフサイクル: Maven は、いくつかのタスク (ゴール) で構成されるビルドフェーズの標準的なシーケンスを定義します。
依存: Maven は他のプロジェクトやライブラリへの依存関係を管理し、正しいバージョンが使用されるようにします。
プラグイン: Maven プラグインは、追加のゴールとタスクを提供することで機能を拡張します。 コンパイル、テスト、パッケージ化、デプロイなどのタスクを自動化します。
前提条件を確認する
このチュートリアルでは、次のものを用意してください。
IDE を使い慣れており、 最新の安定バージョンをお持ちであること。 このチュートリアルでは、IntelliJ IDEA バージョン 2025.1 を使用します。
デフォルトでは、IntelliJ IDEA には Maven プラグインが インストールされ、有効化されています。 そうでない場合は、IDE の 設定を確認してください。
既存の Java プロジェクトがあり、それを IDE 内で開くことができます。
手元にプロジェクトがない場合は、 サンプルプロジェクトを使用するか、 初めての Java アプリケーションを作成する チュートリアルを完了して独自の Java サンプルプロジェクトを作成できます。
このチュートリアルでは、バンドルされている Maven バージョン 3.9 とデフォルトのプロジェクト JDK バージョン 21.0.1 を使用します。 サンプルではなく独自のプロジェクトを使用する場合は、互換性のあるバージョンの Maven と JDK を使用していることを確認してください。
Maven サポートの追加
まず pom.xml ファイルを追加することから始めます。
POM ファイルを追加する
既存の Java プロジェクトを開きます。
プロジェクト ツールウィンドウ（Alt+1 を押すと開きます）で、Maven を追加するモジュールまたはプロジェクトディレクトリを選択します。 この例では、 MortgageCalculator ディレクトリです。
右クリックして、コンテキストメニューから 新規 | ファイル を選択します。
新規ファイル ダイアログで、 pom.xml を追加します。
IntelliJ IDEA は Maven ビルドスクリプトを検出し、Maven プロジェクトのロードを促す通知を表示します。 Maven プロジェクトをロード をクリックします。
IntelliJ IDEA は、 プロジェクト ツールウィンドウに標準の Maven レイアウトを生成します。
IntelliJ IDEA は、 Maven ツールウィンドウに ライフサイクルと リポジトリを含む対応する構造も作成します。
Maven ツールウィンドウは、プロジェクトを表示し、ビルドライフサイクルのゴールを実行できます。
pom.xmlファイルにはプロジェクトに関する情報がないため、IDE は プロジェクト ツールウィンドウと Maven ツールウィンドウの両方でそれをハイライトします。
作成した pom.xml ファイルをエディターで開き、基本的な Maven プロジェクト情報(英語)を追加しましょう。
プロジェクトの説明
エディターで
pom.xmlファイルを開き、次の情報を追加します。<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd"> <modelVersion>4.0.0</modelVersion> <groupId>com.example</groupId> <artifactId>mortgage-calculator</artifactId> <version>1.0-SNAPSHOT</version> <name>Mortgage Calculator</name> </project>追加された情報は、Maven がプロジェクトを特定、構築、管理できます。 詳しく見てみましょう。
XML 名前空間宣言 は、Maven と XML パーサーに POM ファイルの検証および解釈方法を指示します。
modelVersion は、使用している POM モデルのバージョンです。 Maven は現在 4.0.0 のみをサポートしていますが、明示的に宣言する必要があります。
groupId は、プロジェクトグループの一意の識別子（Java パッケージ名のようなもの）です。 これにより、プロジェクトを他のプロジェクトと区別することができます。
アーティファクト Id は、アーティファクトの名前です（JAR や WAR などの出力をビルドした場合）。 Maven は、パッケージの作成時または参照時にこれを使用します。
version はプロジェクトのバージョンです。
SNAPSHOTという接尾辞は、現在開発中で頻繁に変更される可能性があることを意味します。name は、人間が読める形式のプロジェクト名です。
情報を追加すると、IntelliJ IDEA は変更を同期することを提案する
アイコンを表示します。 アイコンをクリックしてプロジェクトを同期しましょう。IntelliJ IDEA は、 Maven ツールウィンドウでプロジェクト構造を解析し、プロジェクトの変更された部分を再読み込みします。
Maven ツールウィンドウを確認してみましょう。IntelliJ IDEA は プラグイン セクションを追加します。
この時点で、プレーンな Java プロジェクトを Maven ベースのプロジェクトに変換できました。 プロジェクトに変更を加えたり、さらに開発を進めたい場合は、IntelliJ IDEA は pom.xml ファイルを唯一の信頼できる情報源とみなすため、すべての変更を POM で実行する必要があります。 それでは、他に何ができるか見ていきましょう。
Maven で開発
Maven を使ってプロジェクトをさらに発展させましょう。 実行可能な JAR を作成してチュートリアルを締めくくりましょう。
実行可能 JAR を作成する
メインメニューから (
) を選択してプロジェクトをビルドします。 IntelliJ IDEA は target フォルダーを生成します。 IntelliJ IDEA はソースをコンパイルするだけで、チュートリアルに必要な .jarファイルとMANIFEST.MFファイルは生成しないことに注意してください。 まずはMANIFEST.MFファイルから始めましょう。resources ディレクトリにマニフェストファイルを作成する必要があります。
ディレクトリを右クリックし、 を選択して META-INF サブディレクトリを作成します。 次に、サブディレクトリを右クリックし、 を選択して MANIFEST.MF ファイルを作成します。
エディターで MANIFEST.MF ファイルを開き、メインクラスに関する情報を追加します。 メインクラスの名前は
MortgageCalculatorです。追加しましょう。 （自身のプロジェクトを使用している場合は、そのメインクラスの名前を使用してください。）次のコードを追加します。
Main-Class: MortgageCalculatorまたは、Maven に、このコード行を
pom.xmlの次のコードを使用して MANIFEST.MF ファイルに追加するように依頼することもできます。<build> <plugins> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-jar-plugin</artifactId> <configuration> <archive> <manifest> <mainClass> MortgageCalculator </mainClass> </manifest> </archive> </configuration> </plugin> </plugins> </build>コードを追加した後、
アイコンをクリックして変更を同期します。このコードだけで実行可能な
.jarファイルを生成することができます。 マニフェストファイル(英語)の詳細については、Maven のドキュメントを参照してください。Maven ツールウィンドウの ライフサイクル リストで、
installコマンドをダブルクリックして.jarファイルを生成します。Maven は、
targetフォルダーに適切な情報と、 プロジェクト ツールウィンドウに実行可能な JAR を生成します。
生成された JAR を右クリックし、 実行 を選択してファイルを実行します。
結果は 実行 ツールウィンドウで確認できます。
作成した
.jarファイルを正常に実行しました。
このチュートリアルで行ったことをまとめてみましょう。
通常の Java プロジェクトをベースに、 pom.xml ファイルを追加し、その中にプロジェクト構成を定義することで、Maven プロジェクトに変換しました。 その後、プロジェクトをビルドし、Maven を使用して実行可能な JAR ファイルを作成し、実行しました。
ここで、自分自身に挑戦し、 親 POM(英語) を追加したり、 Maven デプロイ(英語)を試したりすることができます。