Tag: xml documentation

在Docker容器中获取依赖包的Xml文档

我们有一个Asp.Net Core 2.0 Web服务，我们将其部署在一个Docker容器中。 对于Web服务，我们生成一个XML文档文件，我们在Swagger-ui中使用该文件。 这对于项目本身生成的xml文档效果很好，但是当Web服务部署在Docker容器中时，我无法获得为包含的包生成的xml注释。 nuget包（也是我们创build的）包含一个xml文档文件，当在本地机器上运行服务时，我们可以使用它。 通过调用.IncludeXmlComments使文档变得可用，并通过获取程序集的path，然后用.xmlreplace.dll扩展来确定文档的path。 我怀疑包的xml doc文件不包含在容器中，因此无法find。 在Dockerfile中，我看到了这个命令 COPY publish . 我要么喜欢一个命令，也添加/复制包的XML文档文件，或知道如何使XML文档文件的一部分发布资产。 任何其他的解决scheme，使得这个工作在一个强大的方式（不只是在我的机器上）也是受欢迎的。 编辑：我们现在在Docker容器中有额外的XML文档文件，但Swagger仍然不显示该文件中提供的描述（它在本地运行时）。 我们用了类似的东西： <Target Name="PrepublishScript" BeforeTargets="PrepareForPublish"> <ItemGroup> <DocFile Include="$(USERPROFILE)\.nuget\packages\{packagename}\**\lib\$(TargetFramework)\{PackageName}.xml" /> </ItemGroup> <Copy SourceFiles="@(DocFile)" DestinationFolder="$(PublishDir)" SkipUnchangedFiles="false" /> </Target> 其中{PackageName}应该被你的包的实际名称replace。 path中的通配符保持版本独立（尽pipe我们必须检查这是否会导致问题，因为我们有多个版本）。