外部ツール

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

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

.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 をクリックしてツールを追加し、変更を適用します。

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

次のいずれかを実行します：

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

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

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

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