Swashbuckle.AspNetCore v 5.0.0 以降は扱うオプションの型が変わっているので注意

Swagger の名前が OpenAPI 仕様(OAS)と変わって Microsoft 名前空間の下にも用意された影響だろうか

Microsoft の公式リファレンスを追いかけていれば情報がアップデートされている

• Swashbuckle と ASP .NET Core の概要
  • https://docs.microsoft.com/ja-jp/aspnet/core/tutorials/getting-started-with-swashbuckle?view=aspnetcore-3.1&tabs=visual-studio-code

Swashbuckle.AspNetCore v 5.0.0 以降は SwaggerDoc で扱うオプションの型が変わっているので注意

Swashbuckle.AspNetCore version 5.0.0 未満

Startup.cs

// 前略
public void ConfigureServices(IServiceCollection services)
{
    services.AddSwaggerGen(c =>
    {
	c.SwaggerDoc("v1", new Info
	{
	    Version = "v1",
	    Title = "Example API",
	    Description = "A simple example ASP.NET Core Web API",
	    TermsOfService = "https://example.com/term",
	    Contact = new Contact
	    {
		Name = "Hoge Fuga",
		Email = string.Empty,
		Url = "https://example.com/hoge"
	    },
	    License = new License
	    {
		Name = "Use under LICX",
		Url = "https://example.com/license"
	    }
	});
    });
}
// 後略

Swashbuckle.AspNetCore version 5.0.0 以上

Startup.cs

using Microsoft.OpenApi.Models;    // 追加で必要
// 中略
public void ConfigureServices(IServiceCollection services)
{
    services.AddSwaggerGen(c =>
    {
	c.SwaggerDoc("v1", new OpenApiInfo
	{
	    Version = "v1",
	    Title = "Example API",
	    Description = "A simple example ASP.NET Core Web API",
	    TermsOfService = new Uri("https://example.com/term"),
	    Contact = new OpenApiContact
	    {
		Name = "Hoge Fuga",
		Email = string.Empty,
		Url = new Uri("https://example.com/hoge")
	    },
	    License = new OpenApiLicense
	    {
		Name = "Use under LICX",
		Url = new Uri("https://example.com/license")
	    }
	});
    });
}
// 後略

参考

• Why Swashbuckle.aspnet.core.swagger not being recognized - stackoverflow
  • https://stackoverflow.com/questions/53550096/why-swashbuckle-aspnet-core-swagger-not-being-recognized
• cannot convert from 'Microsoft.OpenApi.Models.OpenApiInfo' to 'Swashbuckle.AspNetCore.Swagger.Info'
  • https://stackoverflow.com/questions/57080588/cannot-convert-from-microsoft-openapi-models-openapiinfo-to-swashbuckle-aspne
• Get started with Swashbuckle and ASP .NET Core
  • https://github.com/dotnet/AspNetCore.Docs/tree/master/aspnetcore/tutorials/web-api-help-pages-using-swagger/samples/3.0/TodoApi.Swashbuckle