发布.net core3.0 webapi +swagger
程序员文章站
2024-01-21 18:48:40
...
填坑。。。
今天弄了个.net core3.0 webapi +swagger的项目,想发布看下啥效果,就像平常发布项目一样。
发布运行之后发现我的xml注释全没了。这就奇怪了,本地运行是有的呢,经过一番查找发现要在项目的.csproj文件中加一段代码
<PropertyGroup>
<GenerateDocumentationFile>true</GenerateDocumentationFile>
</PropertyGroup>
如果还是不行,看看发布的文件夹里面有没有xml,没有的话复制过去也能显示。
然后在用swagger过程中还遇到一个坑,比如我想让我的放回参数有注释,swagger里面注释都是通过xml读出来的,如果你使用的返回参数的类在同一个当前项目中,那就自然能显示,比如我现在的项目是Test.API,如果我的返回参数的类在这个项目里面,那自然会有注释,如果在别的类库中,那么就需要拿到类库的xml,先在属性中勾线xml文档文件,然后在Startup中把类库的xml也注册一下,这样的话注释就有了,这也不能算是个坑,只能说swagger的逻辑是这么处理的,理解了就好多了。
i.IncludeXmlComments(xmlPathEntity);
上一篇: JavaSE知识点笔记Day02
下一篇: 邮件发送、失败
推荐阅读
-
发布.net core3.0 webapi +swagger
-
Asp.Net Core WebApi中接入Swagger组件(初级)
-
Asp.Net Core WebAPI使用Swagger时API隐藏和分组详解
-
Asp.net core WebApi 使用Swagger生成帮助页实例
-
Asp.Net Core WebAPI使用Swagger时API隐藏和分组详解
-
ASP.NET Core 3.0 WebApi中使用Swagger生成API文档简介
-
Asp.net core WebApi 使用Swagger生成帮助页实例
-
net core WebApi——公用库April.Util公开及发布
-
.net core webapi 文件上传在 Swagger 文档中的有好提示处理
-
ASP.NET Core 2.2 WebApi 系列【四】集成Swagger