如何在ASP.NET中包含Swagger中的XML注释文件

Question

我需要Swagger生成API文档包括UI以测试操作。

当我的项目中使用ASP.NET，XML的DEP文件的产生，一切都OK了，是这样的： enter image description here

但是，当我在我的项目中使用ASP.NET核心，DEPS XML文件是不产生。它只是产生我的项目评论XML文件，看起来像这样： enter image description here

而当我将我的项目部署到IIS，项目XML不在部署文件列表中。

Answer 1

为每个项目启用“XML文档文件”复选框您需要在构建时生成其文件。它可以在项目的属性“构建”选项卡上完成。

要包括上部署所有的XML文件，这个目标添加到发布的项目的csproj文件：

<Target Name="PrepublishScript" BeforeTargets="PrepareForPublish"> 
    <ItemGroup> 
     <DocFile Include="bin\*\*\*.xml" /> 
    </ItemGroup> 
    <Copy SourceFiles="@(DocFile)" 
      DestinationFolder="$(PublishDir)" 
      SkipUnchangedFiles="false" /> 
</Target> 

这将从bin文件夹中的所有XML文件和嵌套子文件夹（如bin\Release\netcoreapp1.1\）复制到publish目录。当然你可以定制这个目标。