IntelliJ IDEA 2026.1 Help

Gradle settings

設定 | ビルド、実行、デプロイ | Gradle

このページを使用して、 作成オープン 、または リンクされた Gradle プロジェクトの設定を構成します。

項目

説明

Gradle ユーザーホーム

このフィールドを使用して、Gradle のグローバル構成プロパティ、初期化スクリプト、キャッシュ、ログファイルなどを保存する場所を指定します。 詳細については、 Gradle のドキュメント(英語)を参照してください。

デフォルトは $USER_HOME/.gradle に設定されています。 次のいずれかの方法でオーバーライドできます。

  • GRADLE_USER_HOME 環境変数(たとえば、 %APPDATA%\.gradle )を設定できます。 詳細については、 Gradle のドキュメント(英語)を参照してください。 変数の値は自動的に取得されます。 新しいパスがフィールドに反映されます。

  • ロケーションは手動で指定できます。パスにロケーションを入力するか、 参照ボタン をクリックし、表示されるダイアログで必要なディレクトリを選択してください。

Gradle ロケーションが 指定された場所 オプションを使用して 使用する Gradle に設定され、そのパスが環境変数 GRADLE_HOME または PATH で定義されている場合、IntelliJ IDEA はこのロケーションを推定し、そのパスをデフォルト値として提案します。

IntelliJ IDEA は、 Homebrew(英語) パッケージマネージャーからインストールされたカスタム Gradle ロケーションもサポートします。

Gradle からインポートしたモジュール用の *.iml ファイルを生成する

生成された .iml およびライブラリファイルを idea.system.path ではなく .idea ディレクトリに保存するには、このオプションを選択します。

次のような場合に役立ちます。

  • .idea ディレクトリには プロジェクトレベル設定が格納されているため、VCS を介して IDE 固有のモジュール設定を共有します。 build.gradle ファイルで プロジェクト設定を記述するのに役立つ gradle-idea-ext(英語) プラグインを選択することもできます。

  • 通常の IntelliJ IDEA モジュールと Gradle モジュールの両方を含むプロジェクトを正しく開きます。

  • IntelliJ IDEA は最初に .iml ファイルを読み取り、次にインポートプロセスを開始するため、プロジェクトを開くとプロジェクトにすばやくアクセスできます。

Gradle 7.4 向けに Gradle モデルの並列取得を有効にする

プロジェクトのインポートを高速化するには、このオプションを選択します。

このオプションは、新しく作成されたプロジェクトでは自動的に無効になります。 ファイル | 新規プロジェクトのセットアップ | 新規プロジェクトの設定 でも無効になります。

すでに平行インポート機能が無効になっている .idea フォルダーを含むプロジェクトを VCS からチェックアウトすると、プロジェクトは Gradle 7.4 向けに Gradle モデルの並列取得を有効にする が無効になった状態で開かれます。

Gradle プロジェクト

IntelliJ IDEA で作業する場合、複数の Gradle プロジェクトをリンクさせることができます。 選択したプロジェクトごとに設定を構成できます。

依存関係の外部アノテーションをダウンロードする

このチェックボックスが選択されている場合、IntelliJ IDEA は JetBrains パブリックリポジトリ(英語)から外部アノテーションのセットを含むファイルをダウンロードします。

ビルドと実行

このセクションを使用して、選択したリンクプロジェクトでテストの実行、ビルド、タスクの実行を行うときに IntelliJ IDEA が使用する必要があるものを指定します。

ビルドおよび実行に使用

このリストを使用して、 プロジェクトをビルドおよび実行する方法を選択します。 デフォルトオプションとして Gradle を使用するか、 IntelliJ IDEA を選択します。

この場合、メインメニューから ビルド | プロジェクトのビルド を選択すると、IntelliJ IDEA は、Gradle タスク クラス を実行するすべてのモジュールのソースセットを通過します。

ビルド出力

純粋な Java または Kotlin プロジェクトがある場合は、プロジェクトのビルドに IntelliJ IDEA を選択する方が良い場合があります。 IntelliJ IDEA は、ビルドプロセスを大幅に高速化する インクリメンタルビルドをサポートしています。 ただし、IntelliJ IDEA コンパイラーは Gradle プロジェクトビルド処理の一部をサポートしていないため、プロジェクトを正しくビルドする際に問題が生じる可能性があります。

テストの実行に使用

このリストを使用して、プロジェクトで テストを実行する方法を選択します。 デフォルトオプションとして Gradle を使用するか、 IntelliJ IDEA を選択します。

Gradle

分布

このリストを使用して、プロジェクト用に Gradle バージョンを構成します。

以下のいずれかのオプションを選択できます。

  • 「gradle-wrapper.properties」ファイル: これは Gradle ラッパー(英語)を使用する推奨デフォルトオプションです。

    この場合は、Gradle バージョンの更新を Gradle に委譲して、ビルド用の自動 Gradle ダウンロードを入手します。 このオプションはまた正確な Gradle バージョンで構築することを可能にします。 Gradle バージョンは、プロジェクトの gradle ディレクトリの gradle-wrapper.properties ファイルに保存され、Gradle バージョンの問題を解消できます。

  • Gradle ビルドスクリプトの「ラッパー」タスク: wrapper タスク構成に従って Gradle ラッパーを構成するには、このオプションを選択します。 プロジェクトで使用する Gradle のバージョンを制御したい場合は便利かもしれません。

    デフォルトの Gradle ラッパーオプションを使用してから Gradle wrapper タスク設定に切り替えた場合、タスクで行った変更はプロジェクトのインポート中に自動的に更新されます。

  • 指定された場所: Gradle ラッパーを使用せず、代わりに特定の Gradle バージョンを手動でダウンロードして使用する場合は、このオプションを選択します。 Gradle インストールの場所を指定します。

Gradle JVM

このフィールドを使用して、指定された Gradle プロジェクトをインポートしてそのタスクを実行するときに IntelliJ IDEA が Gradle を実行する JVM を指定します。 デフォルトはプロジェクトの JDK に設定されています。

このフィールドは、他の Gradle JVM 選択をオーバーライドします。 Gradle JVM の選択 セクションで、IntelliJ IDEA が Gradle JVM のバージョンを選択する手順を確認できます。

Gradle JVM 基準

このセクションは、 Gradle デーモンツールチェーンのサポート(英語)が有効な場合に使用可能になります。

サポートを有効化する方法については、 Gradle デーモンツールチェーンを構成する を参照してください。

プロジェクトの JDK バージョンとベンダーを選択できます。

2026 年 3 月 30 日