MSBUILD 使用 XML 文档文件构建项目答案

【问题标题】：MSBUILD build a project WITH the XML documentation filesMSBUILD 使用 XML 文档文件构建项目
【发布时间】：2015-07-24 09:37:55
【问题描述】：

这应该很容易，但我无法让它工作。

我有一个 Web 项目，它在我的解决方案中引用了另一个项目（我们称之为 Project1）。这两个项目都设置为创建 XML 文档文件。

当我右键单击 Web 项目并在 Visual Studio 中构建时，我的 web/bin 文件夹包含 Web 项目和 Project1 的 XML doc 文件。

我希望在 MSBUILD 中具有完全相同的行为，所以当我构建时，我在 bin 文件夹中获取了两个 XML 文件，但我无法让它发挥作用 - 发生的情况是创建了 Web 项目的 XML 文件，但不适用于 project1。

我试过了

救命！

【问题讨论】：

“不起作用”的描述性不是很好 - 你得到 no XML 吗？或者只是一个项目的 XML 文件而不是另一个？还有什么？
@MattRoberts 它适用于我的机器。 File -> New web app follow my msbuild 生成 xml。检查两个调试版本的文档输出路径。 Msbuild 默认进行 Debug 构建，所以我猜你的调试输出路径不是 bin 文件夹。可能是错的:)
干杯@CosminOnea - 你在正确的轨道上 - 我在下面添加了我自己的答案！

标签： msbuild

【解决方案1】：

呸。我明白了。

我指定了Configuration (/p:Configuration=Release)，但没有指定平台 (/p:Platform="Any CPU")。所以，它选择了x64 platform，这是一个我没有勾选构建 XML 文档的平台。

TLD：确保为解决方案指定配置和平台，然后将创建 XML 文档！

【讨论】：

这个答案不完整。您需要提供 p:GenerateDocumentation 和可选的 p:DocumentationFile msdn.microsoft.com/en-us/library/bb629394.aspx

【解决方案2】：

在我这边，XML 是在 VS 中本地构建时生成的，但不是在 TFS/Azure DevOps 上使用 MSBuild 任务。

“神奇”部分是指定p:/DocumentationFile 参数。在我的工作场景中是：/p:DocumentationFile="$(ApplicationName).xml"

因此该文件与项目 dll 一起出现在输出目录中。

【讨论】：