.NET CORE 配置Swagger文档

1、先通过NuGet安装Swashbuckle.AspNetCore ，支持.NET core,版本是4.0.1，以上版本好像有些功能不支持

 

 

2、startup文件里注入swagger，ConfigureServices 方法注入swagger内容，

?

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16

#region  添加SwaggerUI          services.AddSwaggerGen(options =>        {            options.SwaggerDoc("v1", new Info            {                Title = "钉钉测试文档",                Version = "v1"                   });            //Determine base path for the application.             var basePath = PlatformServices.Default.Application.ApplicationBasePath;            //Set the comments path for the swagger json and ui.           var xmlPath = Path.Combine(basePath, "DingDingTest.xml");            options.IncludeXmlComments(xmlPath);        });        #endregion

　　以上最坑地方是PlatformServices这个类找不到，查了半天资料才知道需要引入dll，通过nuget添加程序集，Microsoft.Extensions.PlatformAbstractions

 

?

1	DingDingTest.xml 文件通过属性生成里打钩自动生成xml文件<br>管道里增加swagger管道，

app.UseSwagger();
app.UseSwaggerUI(c =>
{
c.SwaggerEndpoint("/swagger/v1/swagger.json", "钉钉测试 API V1");
});

运行报错，

Fetch error

undefined /swagger/v1/swagger.json

 

 

 

 swagger.JSON是动态生成的，无法手工找到，找了半天才发现，有一个方法我没有设置路由造成生成json文件报错，不是找不到的问题，所以所有方法都要设置路由，不然会报这种莫名的错误

地址栏输入地址，

 

 

 测试成功，搭建成功，但是每次都要输入地址才会出现，现在默认显示swagger，修改launchsettings.json文件

 

{
  "iisSettings": {
    "windowsAuthentication": false,
    "anonymousAuthentication": true,
    "iisExpress": {
      "applicationUrl": "http://localhost:12569/",
      "sslPort": 0
    }
  },
  "profiles": {
    "IIS Express": {
      "commandName": "IISExpress",
      "launchBrowser": true,
      "launchUrl": "swagger/ui",
      "environmentVariables": {
        "ASPNETCORE_ENVIRONMENT": "Development"
      }
    },
    "DataSaas": {
      "commandName": "Project", 
      "launchBrowser": false,
      "launchUrl": "swagger/ui",
      "environmentVariables": {
        "ASPNETCORE_ENVIRONMENT": "Development"
      },
      "applicationUrl": "http://localhost:12570/"
    }
  }
}