如何配置TFS2010构建服务器以使用SHFB生成帮助

Question

我在谷歌上搜索了很多试图找到解决方案，但似乎我错过了一些东西。

大多数文章告诉我应该修改构建文件（

TfsBuild.proj

）。但我在任何地方都找不到该文件。进一步搜索后，我发现它已被 TFS2010 中的新构建模型所取代？

SHFB 的官方文档只是说：

修改您的构建文件。此示例使用每日构建来生成文档：

它没有提及什么文件以及如何。

有人可以善意地告诉我如何配置我们的 TFS 构建服务器以使用 Sandcastle Helpfile Builder 生成文档吗？

Answer 1

最简单的方法是将 SHFB 项目文件包含在构建配置中。 SHFB 项目文件的工作方式与 Visual Studio 中的任何项目文件一样。

Answer 2

你是对的。 Team Build 2010 基于 Workflow Foundation，要实现此目的，您需要创建自定义构建过程模板。

即使核心项目已被弃用，您也可以在这里找到您正在寻找的内容： http://tfs2010extendedbuild.codeplex.com/

有关如何自定义构建过程模板的信息可以在此处找到： http://rabcg.codeplex.com/

Answer 3

首先，我希望您谈论的是 TFS2010，否则这个答案超出了范围。

我们已经通过按以下顺序额外调用 MSBuild 自定义了构建过程模板：

enter image description here

参数如下所示：

enter image description here

为了让所有功能正常运行，我们添加了另一个名为

SandcastleProject

的参数，其中我们在构建定义中提供 .shfbproj 文件的源代码管理路径 ($/.../.shfbproj)。

就在这个序列爆发之前，我们使用活动

ConvertWorkspaceItem

将此路径转换为本地路径，该活动使用本地条目填充名为

localSandcastleProject

的变量：