IntelliJ IDEA 2025.3 ヘルプ

Gradle タスク

Gradle タスクは、Gradle ビルドサイクルで実行される小さな作業です。タスクの概念の詳細については、「Gradle のドキュメント(英語)」を参照してください。

IntelliJ IDEA を使用すると、プロジェクト内の Gradle タスクを実行、デバッグ、管理できます。

Gradle タスクの実行

Gradle タスクを実行するには、いくつかの方法を使用できます。たとえば、なんでも実行ウィンドウから実行構成を使用して、コンテキストメニューから実行したり、1 つの実行構成で複数のタスクを実行したりできます。

なんでも実行ウィンドウで Gradle タスクを実行する

  1. Gradle ツールウィンドウのツールバーで、Execute Gradle task をクリックします。または、Ctrl を 2 回押して、なんでも実行ウィンドウを開きます。

  2. なんでも実行ウィンドウで、実行するタスクの名前の入力を開始します。複数のタスクを実行するには、スペースを使用してタスク名を入力し、各新しいタスクを区切ります。または、Gradle タスクセクションまでスクロールダウンして、必要なタスクを選択します。Enter を押します。

    Enter a task name

    プロジェクトをリンクしていて、指定したプロジェクトのタスクを実行する場合は、なんでも実行ウィンドウの右上隅にあるプロジェクトリストからプロジェクトの名前を選択し、検索フィールドにタスクの名前を入力します。

  3. IntelliJ IDEA は指定されたタスクを実行し、結果を実行ツールウィンドウに表示します。

    Run tool window: Gradle task

    IntelliJ IDEA は、Gradle ツールウィンドウの実行構成ノードの下だけでなく、最近セクションのなんでも実行ウィンドウにもタスクを保存します。

    Run Anything: Recent

実行構成を介して Gradle タスクを実行する

タスクにいくつかの追加パラメーターを追加して、実行構成として構成し、保存して、必要なときにいつでもプロジェクトでその実行構成を使用できます。

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

  2. 実行構成を作成するタスクを右クリックします。

  3. コンテキストメニューから実行構成の変更を選択します。

    Create the task run configuration
  4. 実行構成の作成: 'タスク名' では、デフォルト設定を 使用するか、追加オプションを構成して OK をクリックできます。

    Run Configuration for a Gradle task

    IntelliJ IDEA は、実行構成ノードにタスクを表示します。

    Gradle tool window: Run Configurations
  5. タスクをダブルクリックして実行するか、タスクを右クリックし、コンテキストメニューから実行を選択します。

    Run Configurations: the context menu

コンテキストメニューから Gradle タスクを実行する

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

  2. 実行するタスクを右クリックします。

  3. コンテキストメニューから実行 'task name' を選択します。

    Gradle tool window: the context menu

複数の Gradle タスクを同時に実行する

複数のタスクの実行構成を作成できます。

  1. 実行 | 実行構成の編集 Alt+Shift+F10 を選択します。

    実行 / デバッグ構成ダイアログが開きます。

  2. 実行 / デバッグ構成ダイアログで Add icon をクリックし、Gradle を選択して新しい設定を追加します。

    Add new Gradle run/debug configuration
  3. 実行 / デバッグ構成ダイアログの右側の名前フィールドに、構成の名前を入力します。また、構成を実行する場所を指定することもできます。実行ドロップダウンリストを使用して、実行ターゲットオプションを指定します。

    実行セクションを使用して、実行構成の設定を指定します。

    例として、次の設定を確認してください。

    • タスクと引数 - この構成で実行するタスクと引数を指定(英語)します。複数のタスクを実行できます。フィールド内の the Options icon をクリックしてタスクと引数ダイアログを開き、必要なオプションを選択します。

      例: cleanbuild を指定し、引数 --debug を追加します。

    • Gradle プロジェクト - Choose one of registered Gradle projects をクリックして、登録されている Gradle プロジェクトを選択します。

    • VM オプションを追加する場合は、「オプションを変更」リンクをクリックし、表示されるダイアログの「Java」セクションで「VM オプションの追加」を選択します。VM オプションフィールドが実行構成に追加され、必要なパラメーターを指定できるようになります。例: -Xmx3g を指定します。

    Gradle Run/Debug configuration

    実行構成の詳細については、「実行 / デバッグ構成」を参照してください。

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

    作成された構成は、Gradle プロジェクトツールウィンドウの実行構成ノードに追加されます。

  5. 構成をダブルクリックしてタスクを実行するか、構成を右クリックして実行を選択します。

    Gradle tool window: run configuration

Gradle タスクとスクリプトのデバッグ

通常のアプリケーションをデバッグするのと同じ方法で、Gradle タスクとスクリプトをデバッグできます。

IntelliJ IDEA は、Gradle スクリプトおよび通常のテストのデバッグセッションごとに 1 つのタブを開きます。デバッグツールウィンドウには、フレーム変数、およびコンソール出力が含まれています。

Debug tool window

デバッグセッションの単一のタブで、build.gradle および通常のテストクラスで設定したブレークポイントでステップアクションを実行し、停止することができます。

Stepping through the breakpoints

Gradle デバッグプロセスを構成する

  1. 実行 / デバッグ構成を作成します。既存の実行 / デバッグ構成がある場合は、メインメニューからそれを選択し、実行構成の編集をクリックします。

  2. 実行 / デバッグ構成ページで、Gradle デバッグタブをクリックします。

  3. 次のオプションを使用して、Gradle デバッグプロセスを構成します。

    • Gradle スクリプトのデバッグ :

      エディターまたはコンテキストメニューの左ガターを使用してテストを実行する場合、このオプションは無効になります。これは、デバッグプロセスを高速化するために行われます。

    • 別のデバッグタブでフォークされた Gradle タスクをデバッグ : このオプションを選択すると、新しいデバッグプロセスがデバッグツールウィンドウの別のタブで実行されます。デフォルトでは、このオプションは無効になっており、デバッグプロセスは同じタブで実行されます。

    • 実行グラフ上のすべてのタスクをデバッグする : このオプションを選択すると、実行グラフのすべてのタスクがデバッグされます。例: デバッグしようとしているタスクのすべての依存タスクもデバッグされます。

Gradle スクリプトタスクをデバッグする

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

  2. ブレークポイントを設定し、ガターで の実行アイコンを右クリックします。コンテキストメニューからデバッグ <名前> を選択します。

    Debug build script
  3. IntelliJ IDEA はデバッグセッションを開始し、デバッグツールウィンドウで結果を確認できます。

    Debug tool window

Gradle タスクをデバッグする

Gradle ツールウィンドウを使用して、テスト(英語)実行(英語)など、org.gradle.process.JavaForkOptions インターフェースを実装する Gradle タスクをデバッグします。

  1. Gradle ツールウィンドウでプロジェクトをクリックし、タスクノードを開いて、デバッグするタスクを右クリックします。

  2. コンテキストメニューからデバッグを選択します。

    デバッグプロセスが開始され、タスクが実行構成ノードにある最近のタスクのリストに追加されます。

Gradle タスクへのショートカットを割り当てる

IntelliJ IDEA を使用すると、Gradle タスクにショートカットを割り当て、それらのタスクを 1 つのキーで実行できます。複数のタスクを含めることができる Gradle 実行 / デバッグ構成へのショートカットを割り当てることもできます。

  1. Gradle ツールウィンドウで、目的のタスクを右クリックします。

  2. コンテキストメニューからショートカットの割り当てを選択します。

    Gradle tool window: Assign Shortcut

    キーマップダイアログが開きます。

  3. キーマップダイアログで、Gradle ノードにあるタスクに移動します。

  4. タスクを右クリックし、表示されたリストから割り当てたいショートカットのタイプを選択します。

    Add a shortcut
  5. 開いたダイアログで、ショートカットの種類に応じてショートカットを設定し、OK をクリックします。

    この場合、キーボードショートカットを追加しましょう。

    Keyboard shortcut dialog

    ショートカットが Gradle ツールウィンドウにタスクに対して表示されていることがわかります。

    Gradle tool window: displayed shortcut

キーマップダイアログでは、ショートカットを割り当てる新しいタスクを追加できます。

  1. キーマップダイアログの Gradle ノードで、ショートカットを割り当てるタスクを選択をクリックします。

    Keymap dialog: Choose a task to assign a shortcut
  2. ダイアログが開き、必要なタスクを選択して OK をクリックします。

    Choose Gradle task dialog

    タスクが Gradle ノードのリストに追加されます。これで、ショートカットを構成できます

Gradle タスクの実行トリガーを構成する

IntelliJ IDEA を使用すると、プロジェクトの実行前に Gradle タスクを実行したり、タスクアクティブ化構成を使用して他の条件を設定したりできます。

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

  2. コンテキストメニューからタスクのアクティブ化を選択します。

  3. タスクのアクティブ化ダイアログで、Add icon をクリックします。

  4. アクティブ化フェーズの選択メニューで、タスクを実行するタイミングを選択します。たとえば、ビルド前同期後などです。

  5. タスクの選択メニューで、実際のタスクを選択します。

    タスクとアクティベーションフェーズが Task アクティベーションダイアログのリストに追加されます。また、Gradle ツールウィンドウで、選択したタスクに対してアクティベーションフェーズ名を表示することもできます。

または、Gradle ツールウィンドウで実行するタスクを右クリックすると、コンテキストメニューからアクティベーションフェーズ名を選択できます。

また、Gradle タスクに依存する実行 / デバッグ構成を作成することもできます。

  1. メインメニューで実行 | 実行構成の編集に移動し、プロジェクトの実行 / デバッグ構成を開きます。

  2. 実行 / デバッグ構成ダイアログの起動前セクションで、 アイコンをクリックします。

  3. 表示されるリストで、Gradle タスクの実行を選択します。

  4. Gradle タスクの選択ダイアログで、プロジェクトを起動する前に、実行するプロジェクトとタスクを指定します。Gradle リンクされたプロジェクトまたは他の Gradle プロジェクトを指定できます。Gradle プロジェクトがリンクされていない場合、IntelliJ IDEA はデフォルト構成 (たとえば、バンドルされた Gradle バージョン) を使用してタスクを実行することに注意してください。

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

2025 年 4 月 10 日

関連ページ:

Gradle

IntelliJ IDEA は Gradle との完全な統合をサポートしており、ビルドプロセスの自動化に役立ちます。新しい Gradle プロジェクトを簡単に作成したり、既存のプロジェクトを開いて同期したり、複数のリンクされたプロジェクトを同時に操作したり、管理したりできます。Gradle プロジェクトを作成して WSL 環境に保存したり、WSL ファイルシステムから開いたりすることもできます。詳細については、WSL のセクションを参照してください。新規 Gradle プロジェクトを作成する新規プロジ...

実行 / デバッグ構成: Gradle

実行構成を使用して Gradle タスクを実行できます。このような構成にリストされているデフォルトのオプションは、タスクを実行するのに十分です。必要に応じて、追加のオプションを使用したり、タスクや引数を追加したりして、高度な構成を作成することもできます。実行 / デバッグ Gradle 構成を作成するメインメニューから、構成の追加を選択します。または、Gradle ツールウィンドウで任意のタスクを右クリックして、実行構成の変更を選択します。名前フィールドに構成の名前を指定して、構成を編集または実行す...

実行 / デバッグ構成

IntelliJ IDEA は、実行 / デバッグ構成を使用して、コードを実行、デバッグ、テストします。各構成は、何を実行し、どのパラメーターと環境を使用するかを定義する、名前付きのスタートアッププロパティのセットです。実行 / デバッグ構成には 2 つのタイプがあります。一時的 — 永続的な構成を持たないクラスを実行するたびに作成されます。これは、メソッドを持つクラスの実行を可能にする最低限のものを提供します。永続的 — テンプレートから明示的に作成されるか、一時的な構成を保存することによって作成...

実行 / デバッグ構成ダイアログ

このダイアログを使用して、実行 / デバッグ構成を作成、編集、調整、削除したり、新しく作成されたすべての実行 / デバッグ構成に適用されるデフォルトのテンプレートを構成したりします。既存の実行 / デバッグ構成は、構成タイプごとにグループ化されています。新しい構成を作成するためのテンプレートは編集可能であり、ダイアログの左側のペインにある構成テンプレートの編集リンクから利用できます。共通設定:実行構成を編集するとき(ただし実行構成テンプレートは編集しないとき)、次のオプションを指定できます。名...

メニューおよびツールバー

IDE を操作するとき、いくつかのアクションを他のアクションより頻繁に実行します。生産性を最大化するには、お気に入りのアクションのデフォルトのショートカットを学ぶか、それらにショートカットを割り当てます。メニューとツールバーをカスタマイズして、必要なアクションのみを含め、再グループ化し、アイコンを構成することもできます。例: Java プロジェクトで作業している場合、使用しない他のフレームワークファイルをメニューから削除して、メニューのその部分を短くし、必要なオプションのみを残すことができます。...

Gradle プロジェクト

IntelliJ IDEA では、Gradle プロジェクトを管理できます。リンク、プロジェクトの無視、プロファイルの操作、Gradle プロジェクトと IntelliJ IDEA プロジェクトの変更の同期を行うことができます。Gradle コンポジットビルド、Gradle ソースセット、ビルドおよび実行アクションを構成することもできます。build.gradle ファイルに移動する:Gradle ツールウィンドウで、リンクされたプロジェクトを右クリックします。コンテキストメニューから Gradle...