在发布 ASP.NET Core 时排除 xml 文件

【问题标题】：Excludes xml file on publish ASP.NET Core在发布 ASP.NET Core 时排除 xml 文件
【发布时间】：2019-03-09 15:13:31
【问题描述】：

我的博客引擎有一个 API 服务。我已经将 OpenAPI 文档与 swagger 集成到我的 API 中，但在我看来却遇到了相当特殊的问题。在项目根目录下有个文件叫APIService.xml，其实就是xml文档规范。此 API 通过 Azure CI/CD 管道部署在 Azure 中。 API 部署成功，但是当我尝试运行此 api 时，它不会，因为它实际上正在寻找 apiservice.xml 文件，因此无法运行，因为所述文件不会包含在项目中。我最初认为这可能是 Azure DevOps 管道的问题，因此我尝试在本地发布它，但文件不存在，这意味着它没有在发布时发布/包含在项目中。我尝试在 Kudu 控制台中手动添加它，但它不会添加任何内容。在发布时添加此文件的方法是什么？有什么我应该看的设置吗？

谢谢！！

【问题讨论】：

标签： asp.net-web-api asp.net-core swagger swagger-ui

【解决方案1】：

谢谢大家，我通过在我的 csproj 文件中添加一个衬垫设置来解决它：-

<PropertyGroup>
    <GenerateDocumentationFile>true</GenerateDocumentationFile>
</PropertyGroup>

但是，我很好奇为什么我需要不必要地添加这个额外的行，这些文件不应该在发布时自动添加到项目运行所需的位置。

谢谢！！

【讨论】：

您认为dotnet 应该如何知道项目运行是否需要 xml 文档？
既然我的 csproj 文件已经添加了：- APIService.xml 那么我为什么需要输入额外的行，为什么 Asp.Net Core 不应该理解该行做任何需要的事情是我的观点。我已经告诉我的asp.net核心项目我的apiservice.xml是我的文档文件，所以让我们添加这个文件但不幸的是它无法理解。