外部ツール

カスタム MSBuild ツールを追加する

特定のファイルが変更されたときに自動的に処理するカスタムツール（カスタム引数または外部実行可能ファイルを含む MsBuild）を構成できます。例: JetBrains Rider は、ResXFileCodeGenerator ツールを使用して .resx ファイルからコードを生成します（この関連付けは組み込みです）。

.aspx ファイルを編集するときに .aspx.designer.cs ファイルを生成する必要があるとします。これは、オープンソースの WebForms ジェネレーターであるリデザイナー(英語)を使用して実行できます。

1. Redesigner を実行可能ファイルとして作成するには、ソースからビルドするか、JetBrainsWeb サイト(英語)から .NET フレームワーク 4.6.2 を使用して Redesigner.exe ビルドをダウンロードします。

2. Ctrl+Alt+S を押して設定を開き、ツール | カスタムツールを選択します。

3. をクリックして、必要な詳細をすべて入力します。

   • 名前 : — ツールを識別する任意の名前。

   • 拡張 : — ツールで処理するファイル拡張子のコンマ区切りリスト（ドットなし）。

   • パス : — パスが正しく指定されていることを確認するには、... をクリックして、ファイルチューザーダイアログを使用します。

   • 引き数 : — ツールのコマンドライン引数。さまざまなソリューションやプロジェクトで引数を機能させるには、ダイアログで説明されているマクロを使用します。コマンドライン引数はファイルパスの空白に敏感であることが多いため、ファイルパスを引用符で囲むことを忘れないでください。Redesigner.exe のコマンドライン引数は次のようになります: -r "$PROJECT_FOLDER$" -w "$PROJECT_FOLDER$\bin\$PROJECT_NAME$.dll" "$FILE$"

   

4. 設定ダイアログで保存をクリックして変更を適用し、JetBrains Rider が変更を保存する場所を選択できるようにするか、保存セレクターからこのレイヤーを選択して特定の設定レイヤーに変更を保存します。詳細については、「レイヤーベースの設定」を参照してください。

構成されたカスタムツールは、指定された拡張子を持つファイルを編集するたびにトリガーされます。ソリューションエクスプローラーでファイルを右クリックし、コンテキストメニューから実行 [ ツール名 ] を選択して、手動でトリガーすることもできます。

カスタムツールが何らかの出力を提供する場合、backend.log（ヘルプ | Explorer/Finder でロットを表示）で見つけることができます。

ローカル外部ツールを追加する

この例は、OptiPNG(英語) を外部ツールとして追加し、それを使用してプロジェクト内のイメージを最適化する方法を示しています。

1. Ctrl+Alt+S を押して設定を開き、ツール | 外部ツールを選択します。

2. をクリックし、ツールの設定を指定します。

   

   詳細は、外部ツールを参照してください。

   この場合、OptiPNG は -o4 $FilePath$ 引数を使用して実行されます。プロジェクト名、現在のファイルパス、PHP 実行可能ファイルへのパスなどを参照できるマクロを使用できます。 をクリックすると、使用可能なすべてのマクロとその値をリストするマクロダイアログが開きます。

3. OK をクリックしてツールを追加してから変更を適用します。

追加されたローカル外部ツールを実行する

新しく追加されたツールイメージで選択したファイルを開くには、次のいずれかを実行します。

• ツール | イメージ | PNG の最適化に移動します。

• エクスプローラーツールウィンドウでファイルを右クリックして、コンテキストメニューからツール | イメージ | PNG の最適化を選択します。

• ツールを実行するためのショートカットを作成します。

  Ctrl+Alt+S を押して設定を開き、キーマップを選択します。外部ツールノードにある PNG の最適化アクションを見つけて、ショートカットを割り当てます。

  

ツールを実行すると、出力が実行ツールウィンドウに表示されます。

リモート外部ツールを追加する

リモート SSH 外部ツールはローカル外部ツールと同様に構成されますが、実行されるリモートサーバーも定義し、SSH 経由で接続するための資格情報を必要とします。組み込み SSH ターミナルの使用方法の詳細については、「SSH ターミナルを実行する」を参照してください。

この例では、SSH を介してリモートサーバーで実行され、現在の日付と時刻を返すリモート SSH 外部ツールとして date を追加する方法を示します。

1. Ctrl+Alt+S を押して設定を開き、ツール | リモート SSH 外部ツールを選択します。

2. をクリックしてツールの作成ダイアログを開きます。

   

   このダイアログでは、ローカル外部ツールを追加するときと同じ設定セットが提供されますが、リモート接続を選択することもできます。接続設定を指定しない場合、JetBrains Rider はサーバー上でツールを実行するたびに、ホスト、ポート、関連する SSH 資格情報を要求します。詳細については、リモート SSH 外部ツールを参照してください。

3. OK をクリックしてツールを追加してから変更を適用します。

追加されたツールをリモートサーバーで実行する

以下のいずれか 1 つを実行します:

• メインメニューで、ツール | リモートツールと追加されたリモート外部ツールの名前に移動します。

• ツールを実行するためのショートカットを作成します。

  Ctrl+Alt+S を押して設定を開き、キーマップを選択します。設定したリモート外部ツールの名前のアクションを見つけて、ショートカットを割り当てます。

ホスト、ポート、資格情報を指定した後、JetBrains Rider は SSH 経由でサーバーに接続して date コマンドを実行し、JetBrains Rider の実行ツールウィンドウに出力を返します。