Swagger XML注释文件如何包含在ASP.NET Core服务器中？

Question

我正在使用Swashbuckle编写API文档，该文档需要输出中的projectname.xml文档，但是当我构建ASP.NET Core项目时却没有该文件。

https://docs.microsoft.com/en-us/aspnet/core/tutorials/web-api-help-pages-using-swagger

在服务器上发布时该怎么办？

var xmlFile = "${System.Reflection.Assembly.GetExecutingAssembly().GetName().Name}.xml";
c.IncludeXmlComments(System.IO.Path.Combine(AppContext.BaseDirectory, xmlFile));

Answer 1

为了从代码注释生成XML文档。您将要在所有项目上打开项目属性，转到 Build 标签，然后检查 XML文档文件。这将确保在指定位置生成XML文档。您将要为输出目录使用相对路径。