IntelliJ IDEA 2024.1 ヘルプ

実行 / デバッグ構成: Maven

実行構成を使用して Maven のゴールを実行できます: このような設定にリストされているデフォルトのオプションは、タスクを実行するのに十分です。必要に応じて、追加のオプションを使用したり、ゴールや引数を追加したりして、高度な構成を作成することもできます。

実行 / デバッグ Maven 構成を作成する

  1. メインメニューから、構成の追加を選択します。または、Maven ツールウィンドウで任意のタスクを右クリックして、実行構成の変更を選択します。

    Maven run configuration
  2. 名前フィールドに構成の名前を指定して、構成を編集または実行するときに、たとえば実行ポップアップ Alt+Shift+F10 または Maven ツールウィンドウから構成をすばやく識別できるようにします。

  3. 構成を実行する場所を指定します。デフォルトのローカルマシンオプションは、コンピューター上でローカルに構成を実行します。

    実行実行の場所を変更できます。例: SSH または Docker を使用してターゲットを実行します

    WSL でターゲットを実行することもできます。新しいターゲットを構成するか、既存の構成を変更する必要がある場合は、ターゲットの管理をクリックし、ターゲットの実行ダイアログで変更を追加します。詳細については、ターゲットの実行を参照してください。

  4. 必要に応じて、実行構成設定を含むファイルを保存するプロジェクトファイルとして保存を指定すると、他のチームメンバーとファイルを共有できます。デフォルトの場所は .idea/runConfigurations です。ただし、.idea ディレクトリを共有したくない場合は、プロジェクト内の他のディレクトリに構成を保存できます。

    場所を変更するには、このオプションを選択して the Manage File Location icon をクリックし、開いたダイアログで新しい場所を追加します。

  5. 実行構成の実行に使用する Maven バージョンを指定します。

    このリストを使用して、使用可能なバンドルされた Maven バージョン (Maven2 の場合はバージョン 2.2.1、Maven3 の場合はバージョン 3.1)、MAVEN_HOMEMAVEN2_HOME などの解決されたシステム変数の結果、または Maven ラッパーを選択します。マシンにインストールされている独自の Maven バージョンを指定することもできます。「 the Browse button 」をクリックし、表示されるダイアログで必要なディレクトリを選択します。

  6. 実行可能な実行構成を使用するには、実行フィールドに有効なサイクルフェーズまたはゴールを指定する必要があります。または、Maven ツールウィンドウから実行構成を作成している場合は、選択したゴールがこのフィールドに表示されます。ただし、実行構成に追加の外部ゴールと引数を指定できます。スペースを使用して、あるゴールを別のゴールから分離します。Maven のゴールと引数の利用可能なリストを表示する場合は、フィールドの the Insert Tasks and Arguments icon をクリックします。

  7. Maven プロジェクトの場所を指定します。

    手動で入力するか、the Browse button をクリックして、開いたダイアログで目的の場所をポイントすることができます。ただし、Maven ツールウィンドウから実行構成を作成している場合、IntelliJ IDEA はプロジェクトの名前を自動的に表示します。

    必要に応じて、プロジェクトパスの代わりにビルドスクリプトファイルへのパスを指定できます。これは、参照するカスタムビルドスクリプトがある場合に役立ちます。

  8. プロジェクトでプロファイルを宣言している場合は、プロファイルを指定します。Maven プロファイルの詳細については、「Maven プロファイル」を参照してください。

  9. 必要に応じて、プロジェクトで使用する環境変数を指定します。

  10. 以下のデフォルトオプションが有効になっていますが、オプションを変更をクリックして新しいオプションを追加したり、実行オプションの追加のデフォルトオプションの一部を削除したりできます。

    • 開始時に実行 / デバッグツールウィンドウを開く - 構成といくつかのデバッガーオプションが実行されると、実行 / デバッグツールウィンドウが自動的に開きます

    • Maven オプション - Maven 設定から継承されたデフォルトの Maven オプションを一覧表示します。変更する場合は、設定から継承オプションの選択を解除するか、変更をクリックして新しい Maven オプションを追加します。

    • Java オプション - Maven 設定から継承されたデフォルトの Java オプションをリストします。変更する場合は、設定から継承オプションの選択を解除するか、変更をクリックして新しい Maven オプションを追加します。

実行オプションの変更

オプションを変更をクリックして、実行オプションをさらに追加するか、上記のデフォルトのオプションの一部を削除します。

項目

説明

複数のインスタンスを許可する

この実行構成の複数のインスタンスを並行して実行できるようにするには、このオプションを選択します。デフォルトでは無効になっており、別のインスタンスがまだ実行されているときにこの構成を開始すると、IntelliJ IDEA は実行中のインスタンスを停止して別のインスタンスを開始することを提案します。これは、実行構成が多くのリソースを消費し、複数のインスタンスを実行する正当な理由がない場合に役立ちます。

項目

説明

VM オプション

アプリケーションの起動時に Java 仮想マシンに渡すオプション ( -mx-verbose など) を指定します。

JVM オプションを指定するときは、次の規則に従ってください。

  • スペースを使用して個々のオプションを区切ります。

  • オプションの値にスペースが含まれる場合は、値または実際のスペースを二重引用符で囲みます。

  • オプションに値の一部として二重引用符が含まれている場合は、バックスラッシュを使用して二重引用符をエスケープします。

  • 環境変数の値をカスタム Java プロパティに渡すことができます。

-Xmx1024m -Dspaces="some arg" -Dmy.prop=\"quoted_value\" -Dfoo=${MY_ENV_VAR}

このフィールドでコード補完を使用します。フラグの名前を入力し始めると、IDE が使用可能なコマンドラインオプションのリストを提案します。これは、-XX: および -X オプション、および IntelliJ IDEA によって自動的に構成されない -ea などのいくつかの標準オプションでは機能しますが、-cp または – release では機能しません。

このフィールドで指定された -classpath オプションは、モジュールのクラスパスをオーバーライドします。

JRE

実行構成で使用する Java のバージョンを指定します。

項目

説明

プロファイル

使用するプロファイルをスペースで区切って指定します。

ユーザー設定

テキストフィールドに、Maven 用のユーザー固有の設定を含むファイルを指定します。別のファイルを指定する必要がある場合は、オーバーライドオプションをチェックして、省略記号ボタンをクリックし、Maven 設定ファイルを選択ダイアログで目的のファイルを選択します。

ローカルリポジトリ

既定では、このフィールドには、ダウンロードを格納し、まだリリースしていない一時的なビルドアーティファクトが含まれているユーザーホームのローカルディレクトリへのパスが表示されます。別のディレクトリを指定する必要がある場合は、オーバーライドオプションをチェックして、省略記号ボタンをクリックし、Maven ローカルリポジトリの選択ダイアログで目的のパスを選択します。

スレッド数

このフィールドを使用して、並列ビルドの -T オプションを設定します。このオプションは、Maven 3 以降のバージョンで使用できます。

詳細については、「Maven 3 で並列ビルド(英語)機能」を参照してください。

テストのスキップ

このオプションをオンにすると、Maven プロジェクトの実行中またはデバッグ中にテストがスキップされます。

プラグインレジストリを使用する

Maven Plugin Registry を参照できるようにするには、このオプションをチェックします。

このオプションは、--no-plugin-registry コマンドラインオプションに対応します。

例外スタックトレースを出力する

このオプションをオンにすると、例外スタックトレースが生成されます。

このオプションは、--errors コマンドラインオプションに対応します。

常にスナップショットを更新する

スナップショットの依存関係を常に更新するには、このチェックボックスを選択します。

ワークスペースアーティファクトの解決

プロジェクトに依存モジュールがある場合は、このチェックボックスを使用することをお勧めします。

デフォルトでは、このチェックボックスは選択されていません。この場合、依存モジュールのクラスは、Maven ローカルリポジトリの .jar ファイルで検索されます。このチェックボックスを選択すると、依存モジュールのクラスがモジュールコンパイル出力で検索されます。この場合、依存モジュールを変更するたびに、ローカルリポジトリにデプロイする必要はありません。

再帰的に実行されるゴール

このオプションをオフにすると、ビルドはネストされたプロジェクトに再帰しません。

このオプションをクリアすると、--non-recursive コマンドラインオプションと同じになります。

オフラインで作業します

このオプションがチェックされている場合、Maven はオフラインモードで動作し、ローカルで利用可能なリソースのみを使用します。

このオプションは、--offline コマンドラインオプションに対応します。

チェックサムポリシー

アーティファクトのダウンロード中に、希望するチェックサム一致レベルを選択します。チェックサムが --strict-checksums と一致しない場合にダウンロードを失敗するか、警告 --lax-checksums を発行するかを選択できます。

出力レベル

プラグインがデバッグ情報警告エラーのレベルでメッセージを作成できるようにする出力ログの目的のレベルを選択するか、出力ログを無効にします。

マルチプロジェクトビルド失敗ポリシー

マルチプロジェクトビルドで障害を処理する方法を指定します。以下を選択することができます:

  • コマンドラインオプション --fail-fast に対応する最初の失敗時にビルドに失敗します。

  • 最後にビルドに失敗します。これはコマンドラインオプション --fail-at-end に相当します。

  • コマンド行オプション --fail-never に対応する失敗を無視します。

実行中またはデバッグ中に生成されるログファイルをコンソール、つまり実行またはデバッグツールウィンドウの専用タブに表示するかを選択できます。コンソール出力をファイルに保存するオプションを選択したり、メッセージが stdout または stderr に出力されるときにコンソール出力を表示したりすることもできます。

実行構成を実行する前に、追加するオプションを選択できます。例: 構成を実行する前に、実行する Maven ゴールまたは引数を追加できます。

起動前タスクの追加をクリックし、開いたリストで Maven ゴールの実行を選択し、開いたダイアログでタスクを構成します。

関連ページ:

Maven ゴール

プロジェクトで使用できるすべてのゴールのリストは、ライフサイクルノード内の Maven ツールウィンドウにあります。デフォルトでは、ノードには実行、デバッグ、管理できる基本的なゴールのリストが表示されます。ゴールの拡張リストを表示するには、をクリックし、基本フェーズのみ表示のチェックマークを外します。Maven ライフサイクルの詳細については、「Maven ライフサイクルリファレンス」を参照してください。Maven ゴールの実行:Maven ゴールを実行するには、なんでも実行ウィンドウの使用、...

ターゲットの実行

IntelliJ IDEA から直接、クラウドや Docker コンテナーなどの別の環境でコードを実行できます。特定の実行 / デバッグ構成については、クラウドや Docker コンテナーなどの別の環境でコードを IntelliJ IDEA から直接実行できます。この機能を使用すると、アプリが対象としている実際の環境に対して変更を即座にテストできます。これにより、本番環境に移行するときに非互換性が発生しなくなります。これは、環境に大きく依存するコードで作業する場合に特に重要です。このような環境でアプ...

WSL

WSL(WSL 2) – Windows Subsystem for Linux – は、Windows 10 以降で Linux バイナリ実行可能ファイルをネイティブに実行するための互換性レイヤーです。現在、Ubuntu、OpenSUSE、SLES など、いくつかの Linux ディストリビューションをサポートしています。IntelliJ IDEA を使用すると、WSL ファイルシステムでプロジェクトを作成して開き、WSL 環境でアプリケーションを実行およびデバッグできます。また、ローカルの W...

Maven

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

Maven プロファイル

IntelliJ IDEA を使用すると、運用環境や開発環境など、特定の環境に合わせてビルドをカスタマイズするのに役立つ Maven ビルドプロファイルを使用できます。Maven プロファイルを宣言する:IntelliJ IDEA では、プロジェクトの POM でプロファイルを明示的に宣言できます。コード補完を使用すると、タグ内にいくつかの異なる構成を配置し、Maven プラグイン、依存関係、リポジトリなどの POM で指定されたデフォルト構成をオーバーライドできます。エディターで POM を開...

Maven

IntelliJ IDEA で Maven をインストールして操作する方法については、Maven サポートセクションを参照してください。オフラインで作業しますこのチェックボックスがオンの場合、Maven はオフラインモードで動作し、ローカルで利用可能なリソースのみを使用します。このオプションは、コマンドラインオプションに対応します。再帰的にゴールを実行するこのチェックボックスを選択すると、ビルドはネストされたプロジェクトに再帰的に実行されます。このチェックボックスをオフにすると、コマンドラインオ...