IntelliJ IDEA 2024.1 ヘルプ

Maven プロジェクト

IntelliJ IDEA を使用すると、Maven(英語) プロジェクトを管理できます。リンク、プロジェクトの無視、Maven および IntelliJ IDEA プロジェクトの変更の同期、ビルドおよび実行アクションの構成を行うことができます。

  1. Maven ツールウィンドウで、リンクされたプロジェクトを右クリックします。

  2. コンテキストメニューからソースに移動 F4 を選択します。

    IntelliJ IDEA は適切な Maven 構成ファイルに移動し、関連する POM がエディターで開きます。

Maven プロジェクトを無視する

プロジェクトを無視オプションを使用して、Maven プロジェクトを非アクティブ化できます。この場合、IntelliJ IDEA は無視された Maven プロジェクトとサブプロジェクトを Maven ツールウィンドウに保持しますが、プロジェクトへのそれらのインポート (モジュール、コンテンツルート、ゴールなど) を停止します。ただし、IntelliJ IDEA は無視されたプロジェクトを現在のプロジェクトと同期します。これは、複数のサブプロジェクトがあり、無関係なサブプロジェクトをスキップする必要があるプロジェクトを操作する場合に役立つ場合があります。

  1. Maven ツールウィンドウで、無視するプロジェクトを右クリックします。

  2. コンテキストメニューからプロジェクトを無視を選択します。

  3. プロジェクトツールウィンドウからプロジェクトを削除する場合は、開いたウィンドウではいをクリックします。

Maven プロジェクトまたはサブプロジェクトをアクティブにする場合は、コンテキストメニューからプロジェクトの無視を解除を選択します。

リンクされたプロジェクトの POM を Maven 設定から無視する

無視対象ファイル設定を使用して POM ファイルを無視できます。

  1. 設定ダイアログ(Ctrl+Alt+S)で、ビルド、実行、デプロイ | ビルドツール | Maven | 無視対象ファイルに移動します。

  2. 無視対象ファイルページで、無視する POM を選択し、OK をクリックして変更を保存します。

    Maven Settings
  3. IntelliJ IDEA はダイアログを表示し、プロジェクトツールウィンドウで選択した POM ファイルを削除または残すことができます。

    Reload Maven project

    無視されたファイルをプロジェクトツールウィンドウに保持すると、POM は無視されたものとして表示されますが、ファイルを操作してエディターで変更することはできます。

    Project tool window

Maven プロジェクトを再ロードする

エディターで pom.xml ファイルを手動で変更するたびに、変更をロードする必要があります。IntelliJ IDEA は、エディターの右側に通知アイコンを表示して、プロジェクトに対して作成された Maven の変更をロードCtrl+Shift+O)を提案します。

プロジェクトのインポートプロセスを制御する場合は、手動でアクションをトリガーできます。

  1. Maven ツールウィンドウで、リンクされたプロジェクトを右クリックします。

  2. コンテキストメニューからプロジェクトの再ロード the Reload project icon を選択します。

    このアクションを呼び出すと、IntelliJ IDEA は Maven ツールウィンドウのプロジェクト構造を解析します。

    IntelliJ IDEA はプロジェクトの一部だけを再ロードすることはできません。サブプロジェクトと依存関係を含むプロジェクト全体を再ロードします。

    プロジェクト構造ダイアログ (Ctrl+Alt+Shift+S) を通じて依存関係を構成する場合、その依存関係は IntelliJ IDEA プロジェクトツールウィンドウにのみ表示され、Maven ツールウィンドウには表示されません。IntelliJ IDEA は Maven 構成を唯一の信頼できる情報源と見なすため、次回プロジェクトを再ロードすると、IntelliJ IDEA は追加された依存関係を削除することに注意してください。

自動再読み込みを構成する

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

    または、Maven ツールウィンドウで Build Tools Settings をクリックし、自動再ロードの設定オプションを選択します。

    the Maven tool window
  2. ビルドツール設定で、次のオプションを指定します。

    the Build Tools settings
    • ビルドスクリプトの変更を再読み込みする : このオプションはデフォルトで選択されています。自動再ロードを無効にして再ロードプロセスを手動で制御する場合は、このチェックボックスをオフにします。

    • 任意の変更 : pom.xml に加えた変更または外部の変更の後にプロジェクトを自動的に再ロードする場合は、このオプションを選択します。

      エディターで Maven ビルドスクリプトを手動で変更するたびに、変更をロードする必要があります。IntelliJ IDEA は、エディターの右側に通知アイコンを表示して、プロジェクトに対して作成された Maven の変更をロードCtrl+Shift+O)を提案します。任意の変更オプションを使用すると、IntelliJ IDEA はすべての変更を自動的に再ロードします。

    • 外部の変更 : このオプションを選択すると、IntelliJ IDEA は、VCS が変更され、IDE の外部でビルドファイルが変更された後にのみ、プロジェクトを自動的に再ロードします。

Maven プロジェクトに Maven 構成ファイルを追加する

maven.configjvm.config などのファイルを追加する場合は、プロジェクトに空のファイルを作成することで追加できます。

  1. プロジェクトツールウィンドウで、ファイルを作成するディレクトリを右クリックします。

  2. コンテキストメニューで、新規 | ファイルを選択します。

  3. 開いたダイアログで、ファイルの名前(maven.config または jvm.config)を入力し、OK をクリックします。

    プロジェクトをインポートすると、IntelliJ IDEA は maven.config ファイルにあるコンテンツを読み取りますが、jvm.config のコンテンツは無視されることに注意してください。

    Maven 構成ファイルの詳細については、https://maven.apache.org/configure.html(英語) を参照してください。

1 つの IntelliJ IDEA プロジェクト内に複数の Maven プロジェクトを含めることができます。コードの一部を別のプロジェクトに保持したり、作業が必要なレガシープロジェクトがある場合に役立つことがあります。このようなプロジェクトを IntelliJ IDEA でリンクし、同時に管理することができます。このようなプロジェクトを Maven 構造からすばやく削除することもできます。

  1. Maven ツールウィンドウを開きます。

  2. Maven ツールウィンドウで、the Link Maven Projects icon をクリックして Maven プロジェクトをアタッチします。

  3. 開いたダイアログで、目的の pom.xml ファイルを選択し、OK をクリックします。

    プロジェクトはリンクされています。Maven ツールウィンドウには、ツールバーと Maven エンティティのツリービューが表示されます。

Maven プロジェクトのリンクを解除すると、IntelliJ IDEA はすべての関連プロジェクトとコンテンツルートを削除し、Maven ツールウィンドウとプロジェクトツールウィンドウの両方から Maven プロジェクトを削除し、同期を停止します。以前にリンクされた Maven プロジェクトを現在の IntelliJ IDEA プロジェクトから完全に削除する必要がある場合に役立ちます。

  1. Maven ツールウィンドウで、リンクされたプロジェクトを右クリックします。

  2. コンテキストメニューから Maven プロジェクトのリンクを解除するDelete)を選択します。あるいは、リンクされたプロジェクトを選択してツールウィンドウのツールバーの the Remove icon をクリックすることもできます。

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

ビルドおよび実行アクションを Maven に委譲する

デフォルトでは、IntelliJ IDEA はネイティブ IntelliJ IDEA ビルダーを使用して Maven プロジェクトをビルドします。IntelliJ IDEA はビルドプロセスを大幅に高速化するインクリメンタルビルドをサポートしているため、純粋な Java プロジェクトまたは Kotlin プロジェクトがある場合に役立つ可能性があります。ただし、オンザフライでコンパイルを変更する構成がある場合、またはビルドでカスタムレイアウトのアーティファクトが生成される場合は、ビルドプロセスには Maven の方が適しています。

Maven でプロジェクトをビルドする

  1. Maven ツールウィンドウで Maven settings をクリックします。あるいは、メインメニューからファイル | 設定 | ビルド、実行、デプロイ | ビルドツール | Maven を選択します。

  2. Maven をクリックし、リストからランナーを選択します。

  3. ランナーページで、IDE のビルド / 実行アクションを maven に委譲するを選択します。

    Maven Settings / Runner page
  4. OK をクリックします。

  5. メインメニューで、ビルド | プロジェクトのビルド Ctrl+F9 に移動します。IntelliJ IDEA は、適切な Maven ゴールを呼び出します。

  6. ステータスバーの the Build icon をクリックして、ビルドツールウィンドウに同期の結果を表示します。

    Build tool window

Maven を使用して実行およびデバッグする

IDE のビルド / 実行アクションを maven に委譲するを選択すると、IntelliJ IDEA が実行され、Maven を使用してコードがデバッグされます。ホットスワップもトリガーされ、デバッグプロセス中にクラスが再ロードされます。

他のプロジェクトで使用する場合と同様に、通常の実行およびデバッグアクションを使用できます。

  1. 使用するアクションに応じて、メインメニューから実行 | 実行または実行 | デバッグを選択します。

  2. コードをデバッグする場合は、実行ツールウィンドウまたはデバッグツールウィンドウで結果を確認してください。例: Java プロジェクトでメインメソッド Ctrl+Shift+F10 を実行すると、IntelliJ IDEA は Maven を使用してクラスを実行します。

    Run tool window

関連ページ:

Maven ツールウィンドウ

Maven プロジェクトを作成または開くと、Maven ツールウィンドウが自動的に有効になります。Maven ツールウィンドウを使用して、利用可能な Maven プロジェクトを表示し、ソースと Javadoc をダウンロードし、ビルドライフサイクルのフェーズを実行します。ツールウィンドウには、ライフサイクル、プラグインサブノードとともに、各 Maven プロジェクトのノードが表示されます。pom.xml ファイルの少なくとも 1 つにプロファイル定義が含まれている場合、プロファイルノードがツールウィン...

IntelliJ IDEA を使用してアプリケーションをコンパイルおよびビルドする

IntelliJ IDEA のコンパイルおよびビルドプロセスは、ソースファイルをコンパイルし、外部ライブラリ、プロパティファイル、構成をまとめて、生きたアプリケーションを生成します。IntelliJ IDEA は、Java 仕様に従って動作するコンパイラーを使用します。単一のファイルをコンパイルし、モジュールまたはプロジェクトの増分ビルドを使用して、プロジェクトを最初から再ビルドできます。純粋な Java または Kotlin プロジェクトがある場合、IntelliJ IDEA はビルドプロセス...

Maven: ランナー

このページを使用して、ゴールを実行するために使用される外部 Maven の設定を構成します。IDE のビルド / 実行アクションを Maven に委譲する Maven を介してコードをビルド、実行、デバッグするには、このチェックボックスを選択します。コンパイルをオンザフライで変更する構成がある場合、またはビルドがカスタムレイアウトのアーティファクトを生成する場合に役立ちます。詳細は、Maven プロジェクトを参照してください。VM オプション選択した JRE に渡す VM オプションを指定します。...

ビルドツールウィンドウ

ビルドツールウィンドウは、IntelliJ IDEA によって行われ、Maven または Gradle に委譲されたビルドの出力、およびプロジェクトの同期の結果を表示できます。ビルド出力タブ:IntelliJ IDEA はビルドの結果をビルドの出力タブに表示します。プロジェクトに応じて、ビルド出力には、実行されたタスク、ゴール、コマンド、生成されたエラーメッセージが表示されます。デフォルトでは、タブには成功したすべてのステップと警告も表示されます。プロジェクトを構築するメインメニューで、ビルド | プ...

プログラムの実行フローを変更する

アプリケーションのデバッグ中は、通常、プログラムの通常のフローに従います。ただし、それから逸脱する必要がある場合があります。これは、特定の条件を再現するため、またはプログラムが問題を処理する方法をテストするために必要になる場合があります(たとえば、値の処理や例外の処理)。また、これは、現在調査中の問題に関係のないプログラムの特定の部分をスキップする必要がある場合に便利です。前のスタックフレームに戻る:IntelliJ IDEA を使用すると、プログラムの実行フローで前のスタックフレームにフォー...

Maven

IntelliJ IDEA は Maven との完全な機能統合をサポートしており、構築プロセスの自動化に役立ちます。新しい Maven プロジェクトを簡単に作成したり、既存のプロジェクトを開いて同期したり、既存の IntelliJ IDEA プロジェクトに Maven サポートを追加したり、マルチモジュールプロジェクトを構成および管理したりできます。Maven プロジェクトを作成して WSL 環境に保存したり、WSL ファイルシステムから開いたりすることもできます。詳細については、WSL のセクションを...