# 実行 / デバッグ構成: Gradle

> For the complete documentation index, see [llms.txt](https://www.jetbrains.com/ja-jp/help/clion/llms.txt).

> **TL;DR**
> 必須プラグイン  ： [Gradle](https://plugins.jetbrains.com/plugin/13112-gradle)
>
>
>
> 作成:  `実行 | 構成の編集 |`  ![新規構成の追加](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg)  `| Gradle`

> **Tip:**
> 詳細は、 [Gradle 設定のセットアップ](gradle-support.html#gradle-config)を参照してください。

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

Procedure: 実行 / デバッグ Gradle 構成を作成する

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

![Gradle 構成設定](https://resources.jetbrains.com/help/img/idea/2026.3/cl_gradle_config_prj.png)

2. 命名方法名   フィールドに構成の名前を指定して、構成を編集または実行するときに、たとえば   実行   ポップアップ `Alt+Shift+F10` (Windows), `⌃ ⌥ R` (macOS), `⌥ ⇧ F10` (IntelliJ IDEA Classic (macOS)), `⌃ ⌥ R` (macOS System Shortcuts), `Alt+Shift+F10` (XWin), `Alt+Shift+F10` (GNOME), `Alt+Shift+F10` (KDE), `Alt+Shift+F10` (Emacs), `Alt+Shift+F10` (Sublime Text), `⌃ ⌥ R` (Sublime Text (macOS)), `⌘ ⌃ ⌥ ⇧ R` (Xcode), `Ctrl+Alt+Shift+R` (Visual Studio), `⌘ ⌥ ⇧ R` (Visual Studio (macOS)), `Ctrl+Alt+Shift+R` (ReSharper), `⌘ ⌥ ⇧ R` (ReSharper (macOS)), `Ctrl+T` (QtCreator), `⌘ T` (QtCreator (macOS)), `Alt+Shift+F10` (NetBeans), `Alt+Shift+F10` (Eclipse), `⌃ ⌥ R` (Eclipse (macOS)) または   Gradle   ツールウィンドウから構成をすばやく識別できるようにします。

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

場所を変更するには、このオプションを選択して ![ファイルの保存場所を管理するアイコン](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.settings.svg) をクリックし、開いたダイアログで新しい場所を追加します。

4. 実行   フィールドに何も指定する必要がない場合は、  `help`  などのデフォルトのタスクと [ビルド前](null)セクションで指定されたタスク。 セクションが実行されます。 または、   Gradle   ツールウィンドウから実行構成を作成している場合は、選択したタスクがこのフィールドに表示されます。 ただし、実行構成に追加の外部タスクと [引数を指定(英語)](https://docs.gradle.org/current/userguide/gradle_command_line.html)できます。 スペースを使用して、あるタスクを別のタスクから分離します。 Gradle タスクと引数の使用可能なリストを表示する場合は、フィールドの ![タスクと引数を挿入するアイコン](https://resources.jetbrains.com/help/img/idea/2026.3/app.general.inlineVariables.svg) をクリックします。

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

手動で入力するか、 ![参照ボタン](https://resources.jetbrains.com/help/img/idea/2026.3/app.general.ellipsis.svg) をクリックして、開いたダイアログで目的の場所をポイントすることができます。 ただし、   Gradle   ツールウィンドウから実行構成を作成する場合、CLion はプロジェクト名を自動的に表示します。

Gradle 登録プロジェクト   ![モジュールノード](https://resources.jetbrains.com/help/img/idea/2026.3/app.nodes.Module.svg) アイコンをクリックして、既存の CLion プロジェクトに登録されている Gradle モジュールの一覧から利用可能な Gradle モジュールを選択することもできます。

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

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

7. 次のデフォルトオプションは有効化されていますが、   オプションを変更   をクリックして [実行オプションの追加](#add_advanced)リストを使用し、新しいオプションを追加または一部のデフォルトオプションを削除できます：

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

* Gradle スクリプトのデバッグ - Gradle スクリプトでブレークポイントを有効にします。

## 実行オプションの追加

> **Tip:**
> 実行 / デバッグ構成   ダイアログで   オプションを変更   をクリックして、実行オプションのリストを開きます。

実行オプションの追加   リストを使用すると、   実行 / デバッグ構成   ダイアログに実行オプションを追加したり、デフォルトのオプションの一部を削除したりできます。 リストはさまざまなセクションに分かれているため、利用可能なオプション間を簡単に移動できます。

![Gradle 構成設定](https://resources.jetbrains.com/help/img/idea/2026.3/cl_gradle_config_options.png)

### オペレーティングシステム

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

### Java

|  項目  |  説明  |
| --- | --- |
|    VM オプション    |     アプリケーションの起動時に Java 仮想マシンに渡すオプション (  `-mx`  、  `-verbose`  など) を指定します。       JVM オプションを指定する場合は、次のルールに従ってください：        * スペースを使用して個々のオプションを区切ります。    * オプションの値にスペースが含まれる場合は、値または実際のスペースを二重引用符で囲みます。    * オプションに値の一部として二重引用符が含まれている場合は、バックスラッシュを使用して二重引用符をエスケープします。    * 環境変数の値をカスタム Java プロパティに渡すことができます。      ```PLAINTEXT -Xmx1024m -Dspaces="some arg" -Dmy.prop=\"quoted_value\" -Dfoo=${MY_ENV_VAR}  ```      このフィールドでコード補完を使用できます: フラグの名前を入力し始めると、IDE は利用可能なコマンドラインオプションのリストを提案します。 これは  `-XX:`  および  `-X`  オプションや CLion で自動的に設定されない一部の標準オプション（  `-ea`  など）には機能しますが、  `-cp`  または  `–release`  には機能しません。       このフィールドで指定された  `-classpath`  オプションは、モジュールのクラスパスをオーバーライドします。     |

### ログ

次のオプションは、この構成の実行のログ記録に関連しています。 詳細については、 [](null)を参照してください。

|  項目  |  説明  |
| --- | --- |
|     コンソールに表示するログを指定する。     |     アプリケーション実行中に表示するログファイルを指定します。       ![追加ボタン](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg) をクリックして新しいログを追加します。   ログファイルエイリアスの編集   ダイアログで、次のように構成します。        * エイリアス : ログが表示されるタブの名前。    * ログファイルのロケーション : ログファイルまたは [Ant パターン(英語)](https://ant.apache.org/manual/dirtasks.html)へのパスを指定します。 ローリングログの複数ファイルがパターンに一致する場合、CLion は最も新しいものを表示します。    * パターンでカバーできるすべてのファイルを表示する。 : パターンに一致するすべてのログを表示します。      テーブル内のログに対して、次のオプションを構成できます：        * アクティブ : 指定したログファイルを表示します。    * 内容のスキップ​​​ : 以前の実行からの古いログメッセージを表示しません。    |
|     コンソール出力をファイルに保存する     |  コンソール出力を指定の場所に保存します。 パスを手動で入力するか、参照ボタンをクリックして [表示されるダイアログ](select-path-dialog.html)で目的の場所を指定します。  |
|     メッセージが標準出力に出力されたときにコンソールを表示する     |  アプリケーションが標準出力ストリームに書き込む際にコンソールを有効化します。  |
|     メッセージが標準エラーに出力されたときにコンソールを表示する     |  アプリケーションが標準エラーストリームに書き込む際にコンソールを有効化します。  |

### コードカバレッジ

次のオプションはコードカバレッジに関連しています。 詳細については、 [コードカバレッジ](code-coverage-clion.html)を参照してください。

|  項目  |  説明  |
| --- | --- |
|    クラスとパッケージを指定する    |  このテーブルでは、測定するクラスとパッケージを指定します。 ![追加ボタン](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg) をクリックし、指定する ![クラス追加ボタン](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.nodes.class.svg)   クラスの追加   または ![パッケージ追加ボタン](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.nodes.package.png)   パッケージの追加   を選択します。 リストでクラスとパッケージを選択し、 ![パッケージの削除](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.remove.svg) ボタンをクリックして、リストからクラスとパッケージを削除することもできます。  |
|    クラスとパッケージを除外する    |     カバレッジから除外したいクラスやパッケージを指定します。       ![追加ボタン](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg) をクリックし、 ![クラス追加ボタン](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.nodes.class.svg)   クラスの追加   または ![パッケージ追加ボタン](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.nodes.package.png)   パッケージの追加   を選択して、クラスとパッケージを指定します。     |

### 起動前

この領域では、選択した実行 / デバッグ構成を開始する前に実行するタスクを指定できます。 タスクは、リストに表示されている順序で実行されます。

|  項目  |  説明  |
| --- | --- |
|     起動前タスクの追加​     |     このオプションを有効化して、次の利用可能なタスクのいずれかを追加します：        * 外部ツールの実行 : 外部アプリケーションを実行します。 開いたダイアログで、実行する 1 つまたは複数のアプリケーションを選択します。 CLion でまだ定義されていない場合は、定義を追加してください。 詳細については、 [外部ツール](configuring-third-party-tools.html) を参照してください。    * 別の構成を実行 : 別の実行 / デバッグ構成を実行することを選択し、それが完了するまで待ってから現在の構成を開始します。 複数の構成を並行して実行する場合は、 [複合実行 / デバッグ構成](run-debug-multiple.html#compound-configs)を使用してください。    * Grunt タスクの実行 : Grunt タスクを実行するには、このオプションを選択してください。 表示される Grunt タスク ダイアログで、必要なタスクが定義されている `Gruntfile.js` を指定し、実行するタスクを選択して、Grunt ツールに渡す引数を指定します。 Node.js ランタイムの場所、それに渡すパラメーター、 grunt-cli パッケージへのパスを指定します。    * gulp タスクの実行 : Gulp タスクを実行するには、このオプションを選択してください。 表示される Gulp タスク ダイアログで、必要なタスクが定義されている `Gulpfile.js` を指定し、実行するタスクを選択して、Gulp ツールに渡す引数を指定します。 Node.js ランタイムの場所、それに渡すパラメーター、 gulp パッケージへのパスを指定します。    * npm スクリプトを実行 : npm スクリプトを実行するには、このオプションを選択してください。 開いた NPM スクリプト ダイアログで、 [npm 実行 / デバッグ構成設定](null)を指定します。    * TypeScript のコンパイル : 組み込み TypeScript コンパイラーを実行するように選択し、TypeScript コードに加えたすべての変更が生成された JavaScript ファイルに反映されるようにします。 表示される TypeScript のコンパイル設定 ダイアログで、 エラーの確認 チェックボックスを選択または選択解除して、エラーが検出された場合のコンパイラーの動作を設定します。 * エラーの確認 チェックボックスが選択されていると、コンパイラーはすべてのエラーを表示し、実行構成は開始されません。 * エラーの確認 チェックボックスがオフの場合、コンパイラーは検出されたすべてのエラーを表示しますが、実行構成は起動されます。    |
|     開始時に実行 / デバッグツールウィンドウを開く     |     構成のタイプに応じて、この実行構成を開始するときに [実行](run-tool-window.html)、 [デバッグ](debug-tool-window.html)、 [サービス](services-tool-window.html)ツールウィンドウを開きます。 このオプションが無効になっている場合は、ツールウィンドウを手動で開くことができます。        * `表示 \| ツールウィンドウ \| 実行` または `Alt+4` (Windows), `⌘ 4` (macOS), `⌘ 4` (IntelliJ IDEA Classic (macOS)), `⌘ 4` (macOS System Shortcuts), `Alt+4` (XWin), `Alt+4` (GNOME), `Alt+4` (KDE), `Alt+4` (Emacs), `Alt+4` (Sublime Text), `⌘ 4` (Sublime Text (macOS)), `⌘ 6` (Xcode), `Alt+4` (Visual Studio), `⌘ 4` (Visual Studio (macOS)), `Alt+4` (ReSharper), `⌘ 4` (ReSharper (macOS)), `Alt+3` (QtCreator), `⌘ 3` (QtCreator (macOS)), `Alt+4` (NetBeans), `Alt+4` (Eclipse), `⌘ 4` (Eclipse (macOS))    * `表示 \| ツールウィンドウ \| デバッグ` または `Alt+5` (Windows), `⌘ 5` (macOS), `⌘ 5` (IntelliJ IDEA Classic (macOS)), `⌘ 5` (macOS System Shortcuts), `Alt+5` (XWin), `Alt+5` (GNOME), `Alt+5` (KDE), `Alt+5` (Emacs), `Alt+5` (Sublime Text), `⌘ 5` (Sublime Text (macOS)), `⌘ 7` (Xcode), `Alt+5` (Visual Studio), `⌘ 5` (Visual Studio (macOS)), `Alt+5` (ReSharper), `⌘ 5` (ReSharper (macOS)), `Alt+5` (QtCreator), `⌘ 5` (QtCreator (macOS)), `Alt+5` (NetBeans), `Alt+5` (Eclipse), `⌘ 5` (Eclipse (macOS))    * `表示 \| ツールウィンドウ \| サービス` または `Alt+8` (Windows), `⌘ 8` (macOS), `⌘ 8` (IntelliJ IDEA Classic (macOS)), `⌘ 8` (macOS System Shortcuts), `Alt+8` (XWin), `Alt+8` (GNOME), `Alt+8` (KDE), `Alt+8` (Emacs), `Alt+8` (Sublime Text), `⌘ 8` (Sublime Text (macOS)), `⌘ 8` (Xcode), `Alt+8` (Visual Studio), `Alt+8` (Visual Studio (macOS)), `Alt+8` (ReSharper), `Alt+8` (ReSharper (macOS)), `Alt+8` (QtCreator), `⌘ 8` (QtCreator (macOS)), `Alt+8` (NetBeans), `Alt+8` (Eclipse), `⌘ 8` (Eclipse (macOS))    |
|     開始時に 実行/デバッグ ツールウィンドウにフォーカスする     |  テストの実行中は、実行構成ツールウィンドウにフォーカスを当てます。  |
|     開始前に実行 / デバッグ構成を表示する     |  実際に起動する前に、実行構成設定を表示します。  |

### Gradle

|  項目  |  説明  |
| --- | --- |
|    実行グラフ上のすべてのタスクをデバッグする    |     このオプションを選択すると、実行グラフのすべてのタスクがデバッグされます。 例: デバッグしようとしているタスクのすべての依存タスク。     |
|    別のデバッグタブでフォークされた Gradle タスクをデバッグ    |  デバッグツールウィンドウの別のタブでデバッグプロセスを実行するには、このオプションを選択します。  |
|    テストとして実行    |     デフォルトでは、このオプションは無効になっています。 このような場合、CLion は   実行   ツールウィンドウを開かず、テストタスクが最新であれば再実行しません。       ただし、CLion が実行構成内でテストタスクを検出した場合、それらは [Gradle](jetgradle-tool-window.html)ツールウィンドウでハイライトされ、CLion はテストタスクを再実行せず、Gradle ツールウィンドウを開きます。       このオプションは、ガターまたはコンテキストメニューの ![the Run button](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.run.run.svg) を使用してエディターからテストの実行をトリガーすると有効になります。       この場合、CLion は   実行   ツールウィンドウを開き、テストが最新でも実行のたびにテストタスクを再実行します。       このオプションは、プロジェクト内のテストタスクの再実行処理を制御するときに役立つことがあります。     |

