IntelliJ IDEA 2024.3 ヘルプ

Maven プロファイル

IntelliJ IDEA を使用すると、運用環境や開発環境など、特定の環境に合わせてビルドをカスタマイズするのに役立つ Maven ビルドプロファイル(英語)を使用できます。

Maven プロファイルを宣言する

IntelliJ IDEA では、プロジェクトの POM でプロファイルを明示的に宣言できます。コード補完を使用すると、profiles タグ内にいくつかの異なる構成を配置し、Maven プラグイン、依存関係、リポジトリなどの POM で指定されたデフォルト構成をオーバーライドできます。

  1. エディターで POM を開きます。

  2. <profiles> セクションを指定し、プロファイルを宣言します。

    Profile declaration

    IntelliJ IDEA は、Maven ツールウィンドウのプロファイルリストに表示します。

    Maven tool window

または、次のいずれかの方法でプロファイルを宣言できます。

  • Maven 設定ディレクトリ %USER_HOME%/.m2/settings.xml でローカルに定義することができます。

  • グローバル Maven 設定 ${maven.home}/conf/settings.xml でグローバルに定義することができます。

  • これらは、プロジェクトのベースディレクトリ (profiles.xml) にあるプロファイル記述子で定義できます。このオプションは Maven 3 ではサポートされていないことに注意してください。Maven 3 の互換性に関する注意(英語)を参照してください。

Maven プロファイルをアクティブにする

プロファイルノードと対応するプロファイルのチェックボックスを使用して、Maven ツールウィンドウでプロファイルをアクティブにできます。

Maven プロファイルを有効化

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

  2. プロファイルノードをクリックして、宣言されたプロファイルのリストを開きます。

  3. 適切なチェックボックスを選択して、必要なプロファイルを有効にします。いくつかのアクティブなプロファイルを持つことができます。それらがアクティブ化されると、それらの構成は POM プロファイル宣言に基づいてマージされます。

さまざまなコンテキスト条件に応じて、プロファイルを自動的にアクティブ化することもできます。例: JDK バージョン、OS 名とバージョン、特定のファイルまたはプロパティの有無などですが、POM 内のすべてのパラメーターを指定する必要があります。

Maven が他のアクティブなプロファイルを見つけられない場合にのみアクティブになる POM の activeByDefault タグで Maven プロファイルを宣言できます。詳細については、Maven プロファイル(英語)を参照してください。

POM: profile activation

IntelliJ IDEA は、Maven ツールウィンドウに activeByDefault プロファイルを表示します。選択されたチェックボックスはグレー表示になります。

the Maven tool window: selected profile

チェックボックスをクリックすると、このプロファイルを手動で非アクティブ化できます。また、他のプロファイルを手動でアクティブ化すると、activeByDefault プロファイルが非アクティブ化されることにも注意してください。

the Maven tool window: deactivate profile

マルチモジュールプロジェクトを使用する場合は、POM で activeByDefault プロファイルを指定した場合、他のプロファイルが別のモジュールの POM で宣言されている場合でも、手動で他のプロファイルをアクティブ化すると非アクティブ化されることに注意してください。

プロファイルを非アクティブ化する必要がある場合は、次の手順に従ってください。

Maven プロファイルを非アクティブ化

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

  2. プロファイルノードをクリックして、宣言されたプロファイルのリストを開きます。

  3. 必要なプロファイルを非アクティブ化するには、適切なチェックボックスをオフにします。これにより、IntelliJ IDEA は Maven コマンドをビルドまたは実行するときにそれらのプロファイルを使用しなくなります。

    宣言されたプロファイルを完全に削除する場合は、pom.xml ファイルを使用して、<profiles> セクションを見つけ、必要なプロファイル定義を削除します。

関連ページ:

Maven ツールウィンドウ

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

Maven

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

Maven 依存関係

IntelliJ IDEA を使用すると、プロジェクト内の Maven 依存関係を管理できます。Maven 依存関係の追加、インポート、ダイアグラムでの表示、分析を行うことができます。Maven 依存関係を追加する:IntelliJ IDEA を使用すると、プロジェクトに Maven 依存関係を追加できます。POM 内で依存関係を指定することをお勧めします。IntelliJ IDEA モジュール設定内で手動で設定した依存関係は、次回の Maven プロジェクトの再ロード時に破棄されます。エディターで P...

Maven リファクタリング

IntelliJ IDEA を使用すると、POM での作業中にいくつかの抽出リファクタリングを使用できます。例: マルチモジュールプロジェクトがある場合は、依存関係定義を親 POM に抽出できます。また、依存関係の反復可能なコンテンツをプロパティに抽出して、重複を排除することもできます。管理対象の依存関係を抽出:マルチモジュールプロジェクトがあり、サブプロジェクトの 1 つで、他のサブプロジェクトで使用できるいくつかの依存関係を定義したとします。管理対象の依存関係を抽出リファクタリングを使用し...