ソースコードなしで .NET 実行可能ファイルを実行およびデバッグする

.NET 実行可能ファイルの実行構成を作成する

1. 以下のいずれかの方法で実行 / デバッグ構成ダイアログを開きます。

   • メインメニューから実行 | 実行構成の編集を選択します。

   • ナビゲーションバーが表示された状態（表示 | 外観 | ナビゲーションバー）で、実行 / デバッグ構成セレクターから実行構成の編集を選択します。

   • Alt+Shift+F10 を押してから、0 を押します。

2. 実行 / デバッグ構成ダイアログで、新規構成の追加 Alt+Insert をクリックし、.NET 実行可能ファイル構成タイプを選択して、将来この構成を識別するのに役立つ名前を指定します。

3. 必要に応じて、構成の共通設定を調整し、タスクを起動する前に構成します。

4. ターゲット実行可能ファイルへのパスを指定します。

5. 必要に応じて、構成の開始時に実行可能ファイルに渡されるプログラム引数を指定します。複数の引数は空白で区切る必要があります。

6. オプションで、カスタムの作業ディレクトリ(英語)を指定します。それ以外の場合は、ターゲット実行可能ファイルのディレクトリが使用されます。

7. 必要に応じて、ターゲット実行可能ファイルのカスタム環境変数(英語)を次の形式で指定します。

   envVar1=value1;envVar2=value2

8. オプションで、.NET ランタイム引数を指定します。複数の引数は空白で区切る必要があります。

   .NET と Mono はどちらも、アプリケーションの起動時にカスタムランタイム引数の設定をサポートしています。例: Mono は、アプリケーションの実行方法をカスタマイズするための多くのランタイム引数(英語)をサポートしています。使用するガベージコレクター (--gc=boehm または --gc=sgen) を選択できます。macOS では、使用するランタイムアーキテクチャ (--arch=32 または --arch=64) などを選択できます。

9. オプションで、ランタイムセレクターを使用して、マシンで使用可能なランタイムの 1 つを選択します。

   Windows で作業している場合は、アプリケーションが Mono ランタイムでどのように機能するかを確認できます。JetBrains Rider は、JetBrains Rider 設定 Ctrl+Alt+S のビルド、実行、デプロイ | ツールセットおよびビルドページで指定された Mono 実行可能ファイルを使用します。

   Mono ランタイムでデバッグするには、以下が必要です。

   • Mono 4.2+

   • プロジェクト内のポータブル PDB - .csproj ファイル内の <debugtype>portable</debugtype>、または pdb2mdb を使用して mdb を生成します。

10. オプションでターミナルモードを選択してください。デフォルトでは自動が選択されており、JetBrains Rider はプロジェクトと IDE の設定に基づいて最適なターミナル出力モードを決定します。必要に応じて、ターミナル出力モードを手動で選択することもできます。

    • 自動 - Rider は実行構成と実行可能ファイルの種類に基づいて最適なモードを選択します。

      • 通常、コンソールスタイルのプログラムでは PTY (擬似ターミナル) を使用して、対話型のターミナルエクスペリエンスを提供します (プロセスは実際のターミナルで実行されていると「考え」ます。isatty() は true であり、ターミナル制御シーケンスが機能する可能性があります)。

      • 通常、ターミナルが想定されていない GUI プログラム (たとえば、/SUBSYSTEM:WINDOWS とリンクすると Windows で自動検出される) には標準のストリームリダイレクトを使用します。

      • 注: デフォルトではすべてのエッジケースを回避できるわけではありません (特に Windows の場合)。そのため、出力やインタラクションが壊れた場合はモードを切り替えると役立ちます。

    • 擬似ターミナルを有効にする — 擬似ターミナル (Windows では PTY/ConPTY) 内でプロセスを実行します。

      • 対話型プロンプト、TUI アプリ、シェル、readline スタイルの入力など、実際のターミナルを必要とするプログラムに最適です。

      • 「完全なターミナルエクスペリエンス」を有効にします。isatty() は true を返し、ターミナル制御シーケンス (カーソルの移動、クリアなど) が機能するようになります。

      • 既知の制限: ターミナルエミュレーションは、シナリオによっては信頼できない場合があります (たとえば、特に Windows 上の特定のプログラムでの動作が正しくないなど)。

    • 標準ストリームをリダイレクトする — ターミナルで実行するのではなく、リダイレクトを介して stdin / stdout / stderr をキャプチャーします。

      • Rider ウィンドウを実行するで基本的なテキスト出力コレクションを提供します。

      • ターミナル固有の動作のほとんどは利用できません。多くのアプリは出力を「ターミナルではない」(isatty() は false) として扱うため、対話型機能やターミナル制御シーケンスは通常は機能しません。

      • このモードでは、プログラムによってカラー出力が削減 / 無効になることがよくあります (プログラムがリダイレクトされた出力で強制カラーをサポートしていない限り、通常は「カラーなし」になります)。

    • ANSI コードで標準ストリームをリダイレクトする — 前のオプションと同様にストリームをリダイレクトしますが、色付き / スタイル設定された出力のために ANSI エスケープシーケンスを通過させることができます。

      • 出力がリダイレクトされた場合でも (または構成 / 環境によって強制された場合でも) ANSI カラーコードを出力できるプログラムに役立ちます。

      • まだ実際のターミナルではありません。対話型ターミナルの動作は一般に利用できないままです (isatty() は false)。また、単純なスタイルを超えたターミナル制御シーケンスは期待どおりに動作しない可能性があります。

      • このモードは、完全な PTY モードに切り替えることなく読みやすさ (色) を向上させることを目的としています。

    • 外部コンソール — Rider ターミナルウィンドウの外部でプロセスを実行します。これは、ストリームがリダイレクトされると動作が停止する特定のプログラム（特に一部の GUI プログラム）（たとえば、GUIConsole.WPF/ConPTY デモシナリオなど）に対して推奨される回避策です。

    • 無効 — Rider のコンソール / ターミナル処理を実行構成の出力に関連付けません。これは、GUI アプリケーション（ターミナル出力のリダイレクトが不要な場合）や、Rider を介した出力が何らかの形で問題を引き起こす場合に役立ちます。

11. デフォルトでは、.NET および Mono アプリケーションの出力は、実行またはデバッグウィンドウに表示されます。外部コンソールを使用するを選択して、外部ウィンドウに出力を表示できます。

    このチェックボックスは、従来の .NET アプリケーションタイプ (.NET コンソールアプリケーションなど) には影響しないことに注意してください。これらのアプリケーションタイプの出力は常に外部ウィンドウに表示されます。

12. デバッグモードで構成を実行すると、JetBrains Rider は元の .NET プロセスにのみデバッガーをアタッチします。元のプロセスによって生成された子プロセスと孫プロセスをデバッグする場合は、子 .NET プロセスにアタッチするを選択してください。

    このオプションは .NET 8 以降でのみ機能することに注意してください。

13. 構成を保存するには、適用をクリックします。