visual-studio-2008 - 为 TFS 上的 checkin 策略强制执行自定义 stylecop 规则

Question

我已经安装了 StyleCop CheckIn 策略(来自 here)并且效果很好。但是，我已经编写了一些自定义规则，我希望将其作为 checkin 策略的一部分执行(Visual Studio 2008、Team Explorer 2008、TFS 2005)。

当我右键单击项目并单击“StyleCop 设置”时，自定义规则在设置文件中显示正常。但是，当我添加我的 CheckIn 策略并尝试导入相同的 settings.StyleCop 文件时，我的自定义规则不会出现在编辑器窗口中。

另一个可能相关的问题是，当我从 Visual Studio 打开编辑器时，我的自定义规则出现在 StyleCop 设置编辑器中。但是，如果我通过双击 Windows 资源管理器中的设置文件打开编辑器，我的规则将无处可见。

现在谁能告诉我是否真的可以将自定义规则作为 checkin 策略的一部分，如果可以的话，如何在添加 checkin 策略时让它们出现在 StyleCop 设置编辑器窗口中。

谢谢，

尼尔

Answer 1

是的，绝对有可能!

要让它全部正常工作可能有点棘手，但了解一些关键的事情应该会有很大帮助。

第一步是让 StyleCop 使用自定义规则在开发人员机器上正常工作:
1) StyleCop必须安装在开发机器上
2) 自定义规则必须安装在与 StyleCop 相同的目录中(或者，可选地，安装到子目录中)。如果它们安装在其他任何地方，那么它们不太可能正常工作，即使它们能正常工作。
3) 该安装目录中的 Settings.StyleCop 文件、包含正在分析的项目的目录以及该目录之上的所有目录必须合并才能启用您的自定义规则。最好通过双击项目目录中的 Settings.StyleCop 文件并确保在编辑器中启用您的规则来验证这一点。

下一点更棘手，让 StyleCop 在构建机器上正常工作。
这三点几乎相同，但在将运行 StyleCop 以获取 checkin 策略的构建机器上。因此，构建机器必须安装 StyleCop、安装自定义规则和所有正确的 Settings.StyleCop 文件，以便在构建机器上创建与开发机器上相同的总体 StyleCop 规则设置。这是最容易打破的，只是没有意识到构建机器必须在其上安装 StyleCop。即使安装了 StyleCop，StyleCop 也可以通过 VS 集成(您一定很熟悉)或 StyleCop via MSBuild integration 运行。 (这种情况不太常见，通常也不太好理解)。构建机器通常设置为使用 MSBuild 集成，这意味着自定义规则需要安装在 %Program Files%\MSBuild\Microsoft\StyleCop\v4.3 目录中，而不是您安装的 %Program Files%\StyleCop 目录中可能在期待。此外，如果您修改了 %Program Files%\StyleCop 目录中的基本 Settings.StyleCop 文件，则必须将该文件复制到 %Program Files%\MSBuild\Microsoft\StyleCop\v4.3 目录中为了在构建机器上获得相同的效果。请注意，使用来自开发人员机器的经过验证的工作 Settings.StyleCop 文件进行复制/粘贴是确保构建机器具有正确设置的最佳方法。 StyleCop 对这些 XML 文件非常挑剔，最轻微的拼写错误都可能导致奇怪的行为，需要数天时间才能进行调试。不要手动编辑。你被警告了。 8)

所以肯定有很多方法不能完全正确，并且在你做到这一点之前，你会看到你所描述的陌生感。幸运的是，通过牢记我列出的三点以及“构建机器上的 StyleCop”和“开发机器上的 StyleCop”之间的区别，最终应该可以让它顺利运行。好吧，它至少对我一直有效。

祝你好运!