Net IGeekFan.AspNetCore.Knife4jUI

一、Net IGeekFan.AspNetCore.Knife4jUI

1.下载包

IGeekFan.AspNetCore.Knife4jUI
Swashbuckle.AspNetCore.Swagger
Swashbuckle.AspNetCore.SwaggerGen

2.服务配置

 builder.Services.AddSwaggerGen(c =>
 {
     c.SwaggerDoc("v1", new OpenApiInfo { Title = "API V1", Version = "v1" });
     c.AddServer(new OpenApiServer()
     {
         Url = "",
         Description = "vvv"
     });
     c.CustomOperationIds(apiDesc =>
     {
         var controllerAction = apiDesc.ActionDescriptor as ControllerActionDescriptor;
         return controllerAction?.ControllerName + "-" + controllerAction?.ActionName;
     });
     c.IncludeXmlComments(Path.Combine(AppContext.BaseDirectory, "Web.xml"), true);//为文档添加注释 在项目上右键--属性--生成
 });

3.中间件配置

 app.UseKnife4UI(c =>
 {
     c.RoutePrefix = ""; // serve the UI at root
     c.SwaggerEndpoint("/v1/api-docs", "V1");
 });

 app.MapControllers();
 app.MapSwagger("{documentName}/api-docs");