swashbuckle.aspnetcore 支持 asp.net core 3.0 吗？

Question

我正在安装新的 asp.net core 3.0它使用 services.AddControllers();而不是services.addMvc();及其使用  app.UseEndpoints(endpoints =>             {                 endpoints.MapControllers();             });代替app.UserMvc();我尝试添加swashbuckle.aspnetcore以生成其 swagger ui。它不工作。swashbuckle.aspnetcore已经支持 asp.net core 3.0 了吗？

Answer 1

是的，ASP.NET Core 3.0 支持 Swashbuckle。

1）您可以通过在程序包管理器控制台中运行以下命令来安装它：

Install-Package Swashbuckle.AspNetCore -Version 5.0.0-rc3

2）然后将Swagger生成器添加到方法中的services集合中Startup.ConfigureServices：

services.AddSwaggerGen(c =>

{

    c.SwaggerDoc("v1", new OpenApiInfo { Title = "My API", Version = "v1" });

});

3) 在Startup.Configure方法中，添加这两个以使中间件能够为生成的 JSON 文档和 Swagger UI 提供服务：

// Enable middleware to serve generated Swagger as a JSON endpoint.

app.UseSwagger();

// Enable middleware to serve swagger-ui (HTML, JS, CSS, etc.),

// specifying the Swagger JSON endpoint.

app.UseSwaggerUI(c =>

{

    c.SwaggerEndpoint("/swagger/v1/swagger.json", "My API V1");

});

Answer 2

我可以使用以下命令访问 3.0 Preview 7 中的 swagger ui：

<PackageReference Include="NSwag.AspNetCore" Version="13.0.4" />

public void ConfigureServices(IServiceCollection services) {

...

   services.AddSwaggerDocument();

}

Configure() {

...

   app.UseSwaggerUi3();

}

Answer 3

使用 SwashBuckle.AspNetCore 版本 5.0.0-rc2 修复了它。