asp.net - 发布期间未复制引用程序集的 xml 文档

Question

在同一解决方案中发布引用类库(项目)的 ASP.NET 项目 (NET Framework 4.7.1) 时，所有类库都在构建过程中生成了 XML 文档，只有 ASP.NET 项目自己的 XML 文档文件包含在已发布的输出中。

这些文件是使用 Swashbuckle 的 API 文档所必需的。

这只是从 VS 发布期间的一个问题，而不是常规构建。我正在使用 VS Professional 2019 v16.4.2。

如何将引用的类库的 XML 文档文件作为发布的一部分包含在内？这似乎是一个正常的用例，我觉得我遗漏了一些明显的东西。

我试过:

• 在所述项目中包含 XML 文件并将它们标记为“内容”和“始终复制”到输出目录。没有变化。
• 更改不同的发布设置，这些设置似乎对此没有任何影响

Answer 1

关于这个问题有各种各样的讨论。

参见: https://github.com/dotnet/sdk/issues/795

以及后续问题: https://github.com/dotnet/sdk/issues/1458

但还是没有定下来。普遍的讨论是这些xml注释是build artifacts，发布时不支持发布。然而，当使用 swagger 并让它使用 xml 文件生成文档时，发布工件的情况就更强烈了。 (因为没有 then 根本行不通)

The solution proposed第一期中的内容与您的解决方案出奇地相似。