外部工具

添加自定义 MSBuild 工具

您可以配置 自定义工具 （带有自定义参数的 MsBuild 或外部可执行文件），以便在特定文件更改时自动处理它们。 例如，JetBrains Rider 使用 ResXFileCodeGenerator 工具从 .resx 文件生成代码（此关联是内置的）。

假设您需要在编辑 .aspx 文件时生成 .aspx.designer.cs 文件。 您可以使用 Redesigner ，这是一种开源的 WebForms 生成器。

1. 要将 Redesigner 作为可执行文件使用，可以从源代码构建它，或者从 JetBrains 网站下载带有 .NET Framework 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 选择保存位置，或者通过从 保存 选择器中选择特定设置层来保存修改。 如需了解更多信息，请参见 基于层的设置。

配置的自定义工具将在每次您编辑具有指定扩展名的文件时触发。 您还可以通过右键单击解决方案资源管理器中的文件并从上下文菜单中选择 执行 [tool name] 来手动触发它。

如果自定义工具提供了一些输出，您可以在 backend.log （帮助 | 在资源管理器/访达中显示 Lot ）中找到它。

添加本地外部工具

此示例演示如何将 OptiPNG添加为外部工具，并使用它优化项目中的图像。

1. 按下 Ctrl+Alt+S 以打开设置，然后选择 工具 | 外部工具。

2. 点击 并指定工具的设置。

   

   欲了解更多信息，请参阅 外部工具。

   在我们的示例中， OptiPNG 将使用 -o4 $FilePath$ 参数运行。 您可以使用可以引用项目名称、当前文件路径、PHP 可执行文件路径等的宏。 点击 将打开 宏 对话框，其中列出了所有可用宏及其值。

3. 点击 确定 添加工具，然后应用更改。

运行新增的本地外部工具

要在新添加的工具中打开选定的文件，请执行以下操作之一：

• 在主菜单中，进入 工具 | 图像 | 优化 PNG。

• 在 资源管理器 工具窗口中右键点击文件，然后从上下文菜单中选择 工具 | 图像 | 优化 PNG。

• 创建一个快捷方式来运行该工具。

  按下 Ctrl+Alt+S 打开设置，然后选择 按键映射。 在 外部工具 节点下找到 优化 PNG 操作，并为其分配一个快捷方式。

  

运行工具时，输出会显示在 运行 工具窗口中。

添加远程外部工具

远程 SSH 外部工具的配置与本地外部工具类似，但还需要定义执行这些工具的远程服务器，并需要通过 SSH 连接到该服务器的凭证。 有关使用内置 SSH 终端的更多信息，请参阅 运行 SSH 终端。

此示例演示了如何将 date 作为通过 SSH 在远程服务器上执行的远程 SSH 外部工具并返回其当前日期和时间。

1. 按下 Ctrl+Alt+S 以打开设置，然后选择 工具 | 远程 SSH 外部工具。

2. 点击 以打开 创建工具 对话框。

   

   此对话框提供了与您添加 local external tool时相同的设置集，但还允许您选择远程连接。 如果您不指定连接设置，每次在服务器上运行该工具时，JetBrains Rider 都会要求您提供主机、端口和相关的 SSH 凭证。 更多信息请参阅 远程 SSH 外部工具。

3. 点击 确定 添加工具，然后应用更改。

在远程服务器上运行新增的工具

请执行以下操作之一：

• 在主菜单中，转到 工具 | 远程工具 并查看所添加的远程外部工具的名称。

• 创建一个快捷方式来运行该工具。

  按下 Ctrl+Alt+S 以打开设置，然后选择 按键映射。 找到已配置的远程外部工具的名称，并为其分配一个快捷键。

指定主机、端口和凭证后，JetBrains Rider 将通过 SSH 连接到服务器并运行 date 命令，将输出返回到 JetBrains Rider 中的 运行 工具窗口。