c# - 如何使用 .net 核心 Web 应用程序发布 XML 文档？

Question

在 csproj 文件中，我通过以下标记启用了 XML 文档生成:

  <PropertyGroup>
    <DocumentationFile>bin\xml\Project.Api.xml</DocumentationFile>
    <NoWarn>1701;1702;1705;1591;1573</NoWarn>
  </PropertyGroup>

这可以正常工作并正确构建 xml 文档。现在我需要这个 XML 文件与应用程序一起分发(用于 Swagger 支持等)。所以我添加了以下内容:

  <ItemGroup>
    <None Update="bin\xml\Project.Api.xml">
      <CopyToPublishDirectory>PreserveNewest</CopyToPublishDirectory>      
    </None>
  </ItemGroup>

但是，当我发布到一个文件夹(或发布到 Azure)时，找不到 XML 文档。

我错过了什么？

Answer 1

以下内容适用于您的场景(至少在发布到文件夹时):

  <!-- Run before PrepareForPublish target -->
  <Target Name="CopyDocumentationFile" BeforeTargets="PrepareForPublish">
    <ItemGroup>      
      <DocFile Include="$(DocumentationFile)" />
    </ItemGroup>
    <!--just copy doc file to target location -->
    <Copy SourceFiles="@(DocFile)" DestinationFolder="$(PublishDir)" SkipUnchangedFiles="true" />
  </Target>

Here您可以找到有关如何将自定义文件包含在一般发布输出中的文档。他们使用更复杂的方式，但只是多一点。