既存の 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 デプロイ(英語)を試したりすることができます。
関連ページ：
プラグインのインストール
プラグインは IntelliJ IDEA のコア機能を拡張します。例: プラグインをインストールして、次の機能を取得します。バージョン管理システム、課題追跡システム、ビルド管理サーバー、その他のツールとの統合。さまざまな言語とフレームワークのコーディング支援サポート。ショートカットのヒント、ライブプレビュー、ファイルウォッチャーなど。新しいプログラミング言語を学ぶのに役立つコーディング演習。プラグイン設定を開くを押して設定を開き、を選択します。マーケットプレースタブを使用して、JetBrains...
必須プラグイン
このページを使用して、プロジェクトを正しく機能させるために必要なプラグインを指定します。IntelliJ IDEA はあなたのプロジェクトが動作するのに必要なプラグインが利用可能であることを保証します。このアイコンをクリックして、プロジェクトに必要なプラグインを追加します。開いたダイアログで、次のオプションを指定します。プラグイン — このリストを使用して、必要に応じて追加するプラグインを選択します。最小バージョン — このフィールドを使用して、選択したプラグインの最小バージョンを指定します。最大バ...
初めての Java アプリケーションを作成する
このチュートリアルでは、をシステム出力に出力する単純な Java アプリケーションを作成、実行、パッケージ化する方法を学びます。Java 25 のコンパクトなソースファイルに慣れ、それを通常のクラスに変換する方法を学びます。その過程で、開発者の生産性を向上させる IntelliJ IDEA の機能、つまりコーディング支援や補助ツールについても理解を深めていきます。このチュートリアルでは、Java の基本的な知識と IntelliJ IDEA の知識のみが必要です。新規 Java プロジェクトを作成...
Maven リファクタリング
IntelliJ IDEA を使用すると、POM での作業中にいくつかの抽出リファクタリングを使用できます。例: マルチモジュールプロジェクトがある場合は、依存関係定義を親 POM に抽出できます。また、依存関係の反復可能なコンテンツをプロパティに抽出して、重複を排除することもできます。管理対象の依存関係を抽出：マルチモジュールプロジェクトがあり、サブプロジェクトの 1 つで、他のサブプロジェクトで使用できるいくつかの依存関係を定義したとします。管理対象の依存関係を抽出リファクタリングを使用し...
Gradle
IntelliJ IDEA は Gradle との完全な統合をサポートしており、ビルドプロセスの自動化に役立ちます。新しい Gradle プロジェクトを簡単に作成したり、既存のプロジェクトを開いて同期したり、複数のリンクされたプロジェクトを同時に操作したり、管理したりできます。Gradle プロジェクトを作成して WSL 環境に保存したり、WSL ファイルシステムから開いたりすることもできます。詳細については、WSL のセクションを参照してください。新規 Gradle プロジェクトを作成する新規プロジ...