更新到Swashbuckle.AspNetCore 3.0不再按标签分组

时间:2018-08-16 08:21:29

标签: swagger swagger-ui swashbuckle swagger-codegen

我当时使用[SwaggerOperation(Tags = new[] { "GroupA" })]在Swagger UI的控制器内对我的操作进行分组。

更新到3.0后,不再考虑此问题,仅按控制器名称分组。

来自属性的“已更改”标签名称也不再生成到Swagger JSON / YAML中,只是控制器名称作为标签。

我无法在release notes中找到有关打破这种行为变化的提示。

任何有关行为改变和/或如何恢复的见解将不胜感激。

1 个答案:

答案 0 :(得分:1)

因此,所有这些内容都在发行说明中得到了很好的记录,在阅读时,您应该不要着急。

在我的问题中我没有提到的是我需要安装Swashbuckle.AspNetCore.Annotations才能收回[SwaggerOperation](已分离)。

现在需要通过以下方式主动启用这些功能:

services.AddSwaggerGen(c =>
{
   ...

   c.EnableAnnotations();
});

摘自发行说明:

  

更新注释:继续使用特定的招摇   批注,您需要明确安装并启用新的   Swashbuckle.AspNetCore.Annotations程序包,如此处所述。

“这里”将您带到描述此步骤的地方:

https://github.com/domaindrivendev/Swashbuckle.AspNetCore#swashbuckleaspnetcoreannotations