![](/img/trans.png)
[英]How to define controller descriptions in ASP.NET Core Swagger (Swashbuckle.AspNetCore)?
[英]Is swashbuckle.aspnetcore supporting asp.net core 3.0?
我正在安裝一個新的 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?
是的,ASP.NET Core 3.0 支持 Swashbuckle。
1)您可以通過在包管理器控制台中運行以下命令來簡單地安裝它:
Install-Package Swashbuckle.AspNetCore -Version 5.0.0-rc3
2)然后在Startup.ConfigureServices
方法的services集合中添加Swagger生成器:
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");
});
要自定義它,您可以在此處查看完整指南: https : //docs.microsoft.com/en-us/aspnet/core/tutorials/getting-started-with-swashbuckle?view=aspnetcore-3.0&tabs=visual-studio
我可以使用以下內容訪問 3.0 Preview 7 中的 swagger ui:
<PackageReference Include="NSwag.AspNetCore" Version="13.0.4" />
public void ConfigureServices(IServiceCollection services) {
...
services.AddSwaggerDocument();
}
Configure() {
...
app.UseSwaggerUi3();
}
使用 SwashBuckle.AspNetCore 版本 5.0.0-rc2 修復了它。
聲明:本站的技術帖子網頁,遵循CC BY-SA 4.0協議,如果您需要轉載,請注明本站網址或者原文地址。任何問題請咨詢:yoyou2525@163.com.