ツイートはてブ LINE Pocket

実行 / デバッグ構成

JetBrains Rider は、実行 / デバッグ構成を使用して、コードを実行、デバッグ、デプロイ、テストします。各構成は、何を実行し、どのパラメーターと環境を使用するかを定義する、名前付きのスタートアッププロパティのセットです。

実行 / デバッグ構成には 2 つのタイプがあります。

一時的 — エディターから .NET 静的メソッドを実行 / デバッグするたびに作成されます。
永続的 — テンプレートから明示的に作成されるか、一時的な構成を保存することによって作成されます。永続的な構成は、削除するまでプロジェクトの一部として残ります。

コードを実行、デバッグ、テストするたびに、JetBrains Rider は既存の永続的な実行 / デバッグ構成を使用するか、新しい一時的な構成を作成します。

永続的な構成のアイコンは不透明ですが、一時的な構成のアイコンは半透明です。構成アイコン上の赤い十字は、構成設定にエラーがあることを示します。

一時構成の最大数は 5 です。新しい構成が追加されると、古い構成は自動的に削除されます。必要に応じて、設定 / 環境設定 | 詳細設定 | 実行 / デバッグ | 一時的な構成の制限でこの制限を増やすことができます。

永続的な実行 / デバッグ構成を作成する

JetBrains Rider は、永続的な実行 / デバッグ構成を作成する次の方法を提供します。

一時的な実行 / デバッグ構成を永続的な構成として保存します。
テンプレートから作成または既存の構成をコピーします。

一時的な構成を永続的なものとして保存する

実行 / デバッグ構成スイッチャーで一時構成を選択し、 / をクリックして、構成の保存を選択します。
または、実行 / デバッグ構成ダイアログで一時構成を選択し、ツールバーのをクリックします。

JetBrains Rider は、さまざまな言語、ツール、フレームワーク用の実行 / デバッグ構成テンプレートを提供します。使用可能なテンプレートのリストは、インストールされているプラグインと有効になっているプラグインによって異なります。

テンプレートから実行 / デバッグ構成を作成する

実行 | 実行構成の編集に進みます。または、Alt+Shift+F10 を押してから 0 を押します。
実行 / デバッグ構成ダイアログで、ツールバーのをクリックするか、Alt+Insert を押します。リストには、実行 / デバッグ構成テンプレートが表示されます。
目的のテンプレートを選択します。選択するテンプレートがわからない場合は、特定のテンプレートの詳細について実行 / デバッグ構成テンプレートのリストを参照してください。
名前フィールドに実行 / デバッグ構成名を指定します。この名前は、リストやメニューで実行 / デバッグ構成を識別するために使用されます。
構成の複数のインスタンスを同時に実行できるようにする場合は、複数のインスタンスを許可するを選択します。このオプションが無効になっている場合、構成を再実行しようとすると、アクティブなセッションが終了します。
実行 / デバッグ構成パラメーターを構成します。必須パラメーターとオプションのパラメーターのリストは、選択した実行 / デバッグ構成型によって異なる場合があります。
一部のオプションのパラメーターは非表示になっています。これらを表示して有効にするには、オプションを変更リンクをクリックします。
選択したテンプレートの詳細については、実行 / デバッグ構成リファレンスのそれぞれのセクションを参照してください。
起動前セクションで、アプリケーションを起動する前に特定のアクションを実行するかどうかを定義します。たとえば、実行前に外部ツールまたは別のビルド構成を起動します。ビルド段階をスキップするには、起動前リストからビルドを削除します。
特定の起動前アクティビティの詳細については、起動前を参照してください。
構成をすぐに実行することも、構成を保存して後で実行することもできます。
- 実行構成を後で使用するために保存するには、OK をクリックします。
- 構成をすぐに実行するには、「実行」をクリックします。

起動前

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

項目	ショートカット	説明
	`Alt+Insert`	このアイコンをクリックして、以下の使用可能なタスクのいずれかを追加します。外部ツールの実行 : 外部アプリケーションを実行することを選択します。開いたダイアログで、実行したい 1 つまたは複数のアプリケーションを選択します。JetBrains Rider でまだ定義されていない場合は、その定義を追加してください。別の構成を実行 : 別の実行 / デバッグ構成を実行することを選択し、それが完了するまで待ってから現在の構成を開始します。複数の構成を並行して実行する場合は、複合実行 / デバッグ構成を使用してください。ソリューションのビルド : 構成を起動する前にソリューションを構築するには、このオプションを選択します。ファイル監視の実行 : JetBrains Rider に現在アクティブなすべての File Watchers を適用させるには、このオプションを選択します。 Grunt タスクの実行 : Grunt タスクを実行するには、このオプションを選択してください。表示される Grunt タスクダイアログで、必要なタスクが定義されている Gruntfile.js を指定し、実行するタスクを選択して、Grunt ツールに渡す引数を指定します。 Node.js インタープリターの場所、渡すパラメーター、grunt-cli パッケージへのパスを指定します。 gulp タスクの実行 : Gulp タスクを実行するには、このオプションを選択してください。表示される Gulp タスクダイアログで、必要なタスクが定義されている Gulpfile.js を指定し、実行するタスクを選択して、Gulp ツールに渡す引数を指定します。 Node.js インタープリターの場所、それに渡すパラメーター、gulp パッケージへのパスを指定します。 npm スクリプトの実行 : npm スクリプトを実行するには、このオプションを選択してください。開いた NPM スクリプトダイアログで、npm 実行 / デバッグ構成設定を指定します。 TypeScript のコンパイル : 組み込み TypeScript コンパイラーを実行するように選択し、TypeScript コードに加えたすべての変更が生成された JavaScript ファイルに反映されるようにします。表示される TypeScript のコンパイル設定ダイアログで、エラーの確認チェックボックスを選択または選択解除して、エラーが検出された場合のコンパイラーの動作を設定します。エラーの確認チェックボックスが選択されていると、コンパイラーはすべてのエラーを表示し、実行構成は開始されません。エラーの確認チェックボックスがオフの場合、コンパイラーは検出されたすべてのエラーを表示しますが、実行構成は起動されます。 CoffeeScript ソースマップの生成 : CoffeeScript ソースのソースマップを生成するには、このオプションを選択してください。表示されるダイアログで、CoffeeScript のソースファイルがある場所を指定します。リモートホストにファイルをアップロードする : このオプションを選択すると、デフォルトのサーバーアクセス構成に従って、アプリケーションファイルが自動的にサーバーにアップロードされます。リモート外部ツールの実行 : リモート SSH 外部ツールを追加します。
	`Alt+Delete`	このアイコンをクリックして、選択したタスクをリストから削除します。
	`Enter`	選択したタスクを編集するには、このアイコンをクリックします。開いたダイアログで必要な変更を加えます。
	`Alt+Up` `Alt+Down`	これらのアイコンをクリックして、選択したタスクをリスト内で 1 行上または下に移動します。タスクは、リストに表示されている順に実行されます。
このページを表示する		実行 / デバッグ構成を実際に開始する前に、実行 / デバッグ構成設定を表示するには、このチェックボックスを選択します。
ツールウィンドウをアクティブにする		デフォルトではこのチェックボックスは選択されており、実行 / デバッグ構成を開始すると実行またはデバッグツールウィンドウが開きます。それ以外の場合、チェックボックスがオフの場合、ツールウィンドウは非表示になります。ただし、構成が実行されている場合は、`Alt+4` または `Alt+5` を押すことにより、構成に対応するツールウィンドウを自分で開くことができます。

実行 / デバッグ構成を共有して、チームメイトが同じ構成を使用してアプリケーションを実行できるようにしたり、実行中のプロセスにリモートでアタッチできるようにしたりすることができます。

JetBrains Rider は、実行 / デバッグ構成をプロジェクトファイルとして保存し、VCS を通じて共有するメカニズムを提供します。同じメカニズムは、構成をファイルとして他のユーザーに送信したり、実行 / デバッグ構成のローカルバックアップを作成したり、ファイルからインポートしたりする場合にも使用できます。

実行 | 実行構成の編集に進みます。または、Alt+Shift+F10 を押してから 0 を押します。
共有する実行 / デバッグ構成を選択し、プロジェクトファイルとして保存オプションを有効にして、構成ファイルを保存する場所を指定します。
デフォルトでは、共有構成はソリューションディレクトリの .run フォルダーに保存されます。

実行 / デバッグ構成テンプレート

すべての実行 / デバッグ構成はテンプレートに基づいており、テンプレートは起動ロジックを実装し、パラメーターのリストとそのデフォルト値を定義します。使用可能なテンプレートのリストはインストール時に事前定義されており、プラグインを介してのみ拡張できます。ただし、各テンプレートのデフォルトのパラメーター値を編集して、新しい実行 / デバッグ構成のセットアップを容易にすることができます。

テンプレートのデフォルト値を構成する

実行 | 実行構成の編集に進みます。または、Alt+Shift+F10 を押してから 0 を押します。
実行 / デバッグ構成ダイアログの左側のペインで、構成テンプレートの編集…をクリックします。
開いた実行 / デバッグ構成テンプレートダイアログで、構成タイプを選択します。
必要なデフォルトパラメーターを指定し、OK をクリックしてテンプレートを保存します。

環境変数とプログラム引数

プログラム引数と環境変数を適切な実行 / デバッグ構成に追加することで、アプリの実行時の動作に影響を与えることができます。

実行 | 実行構成の編集に進みます。または、Alt+Shift+F10 を押してから 0 を押します。
開いた実行 / デバッグ構成ダイアログで、引数を渡す構成を選択し、環境変数を追加します。
プログラム引数フィールドに引数を入力します。引数はスペースまたは改行で区切る必要があります。
「」をクリックしてテキストフィールドを展開すると、引数をリストとして表示および編集できます。
「環境変数」フィールドに、変数名と値「 <name>=<value> 」を入力します。複数の変数を追加する場合は、セミコロンで区切る必要があります。
または、をクリックして、変数名と値をユーザー環境変数リストに追加します。
開いたダイアログには、使用可能なシステム環境変数のリストも表示されます。選択した構成にシステム環境変数を使用しない場合は、システム環境変数チェックボックスをオフにします。
$VAR$ 構文を使用して、親環境変数を含む既存の変数を参照できます。このような参照では大文字と小文字が区別されることに注意してください。たとえば、Linux/macOS の場合は PATH=xxx:$PATH$、Windows の場合は Path=xxx;$Path$ です。

実行 / デバッグ構成フォルダー

同じタイプの実行 / デバッグ構成が多数ある場合は、アクセスしやすいようにフォルダーにグループ化できます。

実行 / デバッグ構成用のフォルダーを作成する

実行 | 実行構成の編集に進みます。または、Alt+Shift+F10 を押してから 0 を押します。
実行 / デバッグ構成ダイアログで、構成タイプを選択し、ツールバーのをクリックします。選択したタイプの新しい空のフォルダーが作成されます。
右側のテキストフィールドにフォルダー名を指定するか、デフォルトの名前を受け入れます。
目的の実行 / デバッグ構成を選択し、ターゲットフォルダーに移動します。
変更を適用します。フォルダーが空の場合、保存されません。

フォルダーが不要になった場合は、Delete を削除できます。このフォルダーにグループ化された実行 / デバッグ構成は、対応する実行 / デバッグ構成タイプのルートに移動されます。

サービスツールウィンドウで実行 / デバッグ構成

サービスツールウィンドウで複数の実行 / デバッグ構成を管理できます。例: 複数のアプリケーションを開始、一時停止、停止し、それらのステータスを追跡し、アプリケーション固有の詳細を調べることができます。

サービスウィンドウに実行 / デバッグ構成を追加する

メインメニューから表示 | ツールウィンドウ | サービスを選択するか、Alt+8 を押します。
サービスツールウィンドウで、サービスの追加をクリックし、実行構成タイプ…を選択します。
リストから実行 / デバッグ構成タイプを選択して、このタイプのすべての構成をウィンドウに追加します。
ツールウィンドウには、1 つ以上の構成を作成した構成タイプのみが表示されることに注意してください。

実行 / デバッグ構成を起動する前にタスクを実行する

ほとんどのタイプの実行 / デバッグ構成には起動前セクションがあり、構成を実行する前に実行する必要のあるタスクを指定できます。例: アプリケーションを起動する前に、ソリューションを自動的に構築することをお勧めします。

タスクを追加するには、起動前セクションを展開し、追加をクリックして、目的のタスク型を選択し、必要に応じてそのパラメーターを指定します。

実行 / デバッグ構成を起動する前に、次のタスクを実行できます。

Web ブラウザーの起動	選択したブラウザーで指定した URL を開きます。
外部ツールの実行	外部ツールで構成された別のアプリケーションを起動します。開いたダイアログで、実行する 1 つまたは複数のアプリケーションを選択します。
別の構成を実行	別の実行 / デバッグ構成を開始します。複合構成とは対照的に、複数の構成を実行するこの方法では、構成が開始される順序を定義できます。
プロジェクトのビルド	現在のソリューションからプロジェクトを構築します。構成が特定のプロジェクトを対象としている場合は、選択されたプロジェクトを選択して、構成設定で選択したプロジェクトをビルドできます。コンパイル中にエラーが発生した場合、JetBrains Rider は実行 / デバッグ構成を開始しようとしません。
プロジェクトをクリーンにする	指定されたプロジェクトの中間ファイルと出力ファイルであるすべてのビルドアーティファクトを削除します。
ソリューションのビルド	ソリューション全体を構築します。
ソリューションのクリーン	ソリューションからすべてのビルドアーティファクト（中間ファイルと出力ファイル）を削除します。
ソリューションの公開
ファイル監視の実行	現在アクティブなすべてのファイルウォッチャーを適用します。
リモート外部ツールの実行	リモート SSH 外部ツールを実行します。
Grunt タスクの実行	Grunt タスクを実行します。
gulp タスクの実行	Gulp タスクを実行します。
npm スクリプトの実行	npm スクリプトを実行します。
TypeScript のコンパイル	組み込みの TypeScript コンパイラーを実行し、TypeScript コードに加えたすべての変更が生成された JavaScript ファイルに反映されていることを確認します。開いた TypeScript のコンパイル設定ダイアログで、エラーの確認チェックボックスを選択またはクリアして、エラーが検出された場合のコンパイラーの動作を構成します。エラーの確認チェックボックスが選択されていると、コンパイラーはすべてのエラーを表示し、実行構成は開始されません。エラーの確認チェックボックスがオフの場合、コンパイラーは検出されたすべてのエラーを表示しますが、実行構成は起動されます。
CoffeeScript ソースマップの生成	CoffeeScript ソースのソースマップを生成します。開いたダイアログで、CoffeeScript ソースファイルの場所を指定します。
このページを表示する	実行 / デバッグ構成を実際に開始する前に、実行 / デバッグ構成設定を表示するには、このチェックボックスを選択します。
ツールウィンドウをアクティブにする	デフォルトではこのチェックボックスは選択されており、実行 / デバッグ構成を開始すると実行またはデバッグツールウィンドウが開きます。それ以外の場合、チェックボックスをオフにすると、ツールウィンドウが非表示になります。ただし、構成の実行中に、`Alt+4` または `Alt+5` を押すと、対応するツールウィンドウを自分で開くことができます。

最終更新日: 2024 年 12 月 02 日

JetBrains Rider 2024.3 ヘルプ

実行 / デバッグ構成