IntelliJ IDEA 2024.1 ヘルプ

実行 / デバッグ構成: Gradle

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

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

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

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

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

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

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

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

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

  5. 実行フィールドに何も指定する必要がない場合は、help などのデフォルトのタスクとビルド前セクションで指定されたタスク。セクションが実行されます。または、Gradle ツールウィンドウから実行構成を作成している場合は、選択したタスクがこのフィールドに表示されます。ただし、実行構成に追加の外部タスクと引数を指定(英語)できます。スペースを使用して、あるタスクを別のタスクから分離します。Gradle タスクと引数の使用可能なリストを表示する場合は、フィールドの the Insert Tasks and Arguments icon をクリックします。

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

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

    Gradle 登録プロジェクト the Modules node アイコンをクリックして、既存の IntelliJ IDEA プロジェクトに登録されている Gradle モジュールのリストから使用可能な Gradle モジュールを選択することもできます。

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

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

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

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

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

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

実行オプションの追加

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

Gradle configuration settings

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

項目

説明

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

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

Java

項目

説明

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 オプションは、モジュールのクラスパスをオーバーライドします。

ログ

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

コードカバレッジ

コードカバレッジを使用した構成の実行に関連するオプションを選択できます。

起動前

実行構成を実行する前に、追加するオプションを選択できます。例: 構成を実行する前に実行する Gradle タスクを追加できます。

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

Gradle

項目

説明

実行グラフ上のすべてのタスクをデバッグします

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

別のデバッグタブでフォークされた Gradle タスクをデバッグ

デバッグツールウィンドウの別のタブでデバッグプロセスを実行するには、このオプションを選択します。

テストとして実行

デフォルトでは、このオプションは無効になっています。このような場合、IntelliJ IDEA は実行ツールウィンドウを開かず、テストタスクが最新であれば再実行しません。

ただし、IntelliJ IDEA が実行構成でテストタスクを見つけた場合、それらは Gradle ツールウィンドウでハイライトされ、IntelliJ IDEA はテストタスクを再実行せず、Gradle ツールウィンドウを開きます。

このオプションは、ガターまたはコンテキストメニューの the Run button を使用してエディターからテストの実行をトリガーすると有効になります。

この場合、IntelliJ IDEA は実行ツールウィンドウを開き、テストが最新であっても、実行がトリガーされるたびにテストタスクを再実行します。

このオプションは、プロジェクト内のテストタスクの再実行プロセスを制御するのに役立つ場合があります。

関連ページ:

Gradle タスク

Gradle タスクは、Gradle ビルドサイクルで実行される小さな作業です。タスクの概念の詳細については、「Gradle のドキュメント」を参照してください。IntelliJ IDEA を使用すると、プロジェクト内の Gradle タスクを実行、デバッグ、管理できます。Gradle タスクの実行:Gradle タスクを実行するには、いくつかの方法を使用できます。たとえば、なんでも実行ウィンドウから実行構成を使用して、コンテキストメニューから実行したり、1 つの実行構成で複数のタスクを実行したり...

ターゲットの実行

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...

実行ツールウィンドウ

実行ツールウィンドウには、アプリケーションによって生成された出力が表示されます。各タブの外観は、実行中のアプリケーションの種類によって異なり、追加のツールボックスとペインを含めることができます。ツールウィンドウのタブ:タブをピン留め複数のアプリケーションを実行している場合、各アプリケーションは、適用された実行 / デバッグ構成にちなんで名付けられたタブに表示されます。アプリケーションを再実行しても出力を保持するには、出力タブを固定します。タブを右クリックし、タブをピン留めを選択します。デフォル...

デバッグツールウィンドウ

デバッガーセッションを開始すると、デバッグツールウィンドウが表示されます。このウィンドウを使用して、デバッガーセッションを制御し、プログラムデータ(フレーム、スレッド、変数など)を表示して分析し、さまざまなデバッガーアクションを実行します。これは、デバッグツールウィンドウの概要です。ツールウィンドウの使用に関する一般的な手順については、ツールウィンドウを参照してください。ツールウィンドウのタブを切り替えるには、とを押します。セッション:使用可能なデバッグセッションは、デバッグツールウィンド

Gradle ツールウィンドウ

Gradle プロジェクトを作成または開くと、Gradle ツールウィンドウが自動的に有効になります。右側のサイドバーの Gradle をクリックしてツールウィンドウを開く: ツールウィンドウには、Gradle にリンクされたプロジェクト、そのタスク、依存関係、基礎となる build.gradle ファイルに加えられたすべての変更が表示されます。Gradle:このボタンをクリックすると、現在のビューを設定したりツールウィンドウの表示モードを変更したりするためのメニューが開きます。メニュー項目は、オンまた...