TeamCity On-Premises 2024.03 Help

检查(ReSharper)

Inspections (ReSharper) 构建运行程序使您可以在 TeamCity 中直接使用 JetBrains ReSharper 代码质量分析 功能的优势,借助于捆绑的 JetBrains ReSharper 命令行工具。 您可以在没有任何额外 ReSharper 许可证的情况下使用 TeamCity 内的工具。
ReSharper 可以分析您的 C#、VB.NET、XAML、XML、ASP.NET、ASP.NET MVC、JavaScript、HTML、CSS 代码,并允许您:

  • 寻找可能的错误

  • 消除错误和代码异味

  • 检测性能问题

  • 提升代码结构和可维护性

  • 确保代码符合指南、标准和规范

ReSharper 命令行工具 2018.2 或更高版本需要 .NET Framework 4.6.1 或更高版本。

如果您想要使用特定的 ReSharper 版本运行 ReSharper 检查(例如,确保其与您在 Visual Studio 中安装的版本相匹配),您可以安装另一个版本的工具,并在 管理 | 工具 页面上将默认版本更改为要使用的版本。 这个页面包含关于 Inspections (.NET) 构建运行程序字段的参考信息。

您也可以参考 ReSharper 文档 以获取更多详情。

参考 配置构建步骤 以获取常见构建步骤设置的描述。 参考 容器包装器 了解您如何在 Docker 容器内运行此步骤。

待分析的源代码

选项

描述

解决方案文件路径

由 Microsoft Visual Studio 2005 或以后版本创建的 .sln 文件的路径。
指定的路径应相对于签出目录。

项目筛选器

指定项目名称通配符,以分析解决方案的一部分。 将 blank 留空以分析整个 whole 解决方案。 将通配符用新的行进行分隔。
例如:

JetBrains.CommandLine.* *.Common *.Tests.*

环境要求

选项

描述

目标框架

此选项允许您处理 Visual Studio 多目标 特性。
每个选中的项目都将创建代理要求。

支持 .NET Framework 版本 2.0 – 4.8.1。

JetBrains ReSharper 命令行工具设置

选项

描述

R# CLT 主目录

选择 ReSharper Command Line Tools 的版本。

您可以在 管理 | 工具 页面上检查已安装的 JetBrains ReSharper Command Line Tools 的版本。

检查已安装的 Resharper 工具的版本

如果您想要使用特定的 ReSharper 版本运行 ReSharper duplicates (例如,确保其版本与您在 Visual Studio 中安装的版本相匹配),您可以使用此页面来安装其他版本的工具并更改默认版本为要使用的版本。

R# CLT 插件

要安装的额外的 ReSharper 插件 列表。 此字段接受 pluginID / 版本 格式的值,例如: StyleCop.StyleCop/2023.2.0

  • pluginID s 可以在 JetBrains Marketplace 的主插件页面上找到(“概览”标签的“附加信息”部分)。

  • 版本 应与插件市场页面的 "版本" 选项卡上的格式保持一致。 省略版本号可以让 ReSharper 自动获取最新版。

如果您想从本地存储中安装插件,而不是从 JetBrains Marketplace 下载,将 额外的 InspectCode 参数 字段设置为 --source=<Directory_Path> 值。

从本地存储安装插件

请注意, --源 参数会影响所有插件,因此您不能混合使用 Marketplace 下载和本地存储安装。

InspectCode 平台

选择 InspectCode 工具的平台位数。 要在 C++ 项目中查找代码问题,请使用 x86 平台。 跨平台检查也在 ReSharper 2020.2.1 或更高版本中得到支持。

InspectCode 选项

选项

描述

自定义设置配置文件路径

包含由 JetBrains ReSharper 6.1 或更高版本 创建的 ReSharper 设置 的文件的路径。
指定的路径应该是相对于检出目录的 相对 路径。
如果指定,此设置层具有最高优先级,因此它将覆盖 ReSharper 内置的设置。 默认情况下,将应用 内置的 ReSharper 设置层。

有关 ReSharper 设置系统的更多信息,请查看 ReSharper 网络帮助JetBrains .NET 工具博客

启用调试输出

选择此选项,以在构建日志中包含调试消息,并将带有附加日志( dotnet-tools-inspectcode.log )的文件作为隐藏的工件发布。

额外的 inspectCode.exe 参数

指定换行分隔的命令行参数以添加到调用 inspectCode.exe

构建失败条件

如果构建出现太多的检查错误或警告,您可以通过设置一个 构建失败条件 来使其失败。

在分析之前构建

为了获得充分的检查执行结果,您可能需要先构建您的解决方案,再运行分析。 当您在项目中(隐式或显式地)使用 code generation 时,这个预步骤尤为实际。

捆绑的 ReSharper 版本

TeamCity 版本

ReSharper 版本

2018.1

2018.1.2

2018.2

2018.1.4

2019.1

2019.1.1

2019.2

2019.2.3

2020.1

2019.2.3

2020.2

2020.2.4

2021.1

2021.1.2

2021.2

2021.1.2

2022.04

2021.1.2

2022.10

2021.1.2

2023.05

2021.1.2

2023.11

2023.1.1

您可以在 服务器管理 | 工具 页面查看已安装的 ReSharper 版本。 捆绑版本已被设为默认,您可以安装其他版本并更改默认设置。

最后修改日期: 16日 7月 2024年