Skip to content

Upgrading Swashbuckle.AspNetCore.SwaggerGen 10 to 11

Breaking10.3.1 → 11.0.1Breaking1Platform1New2Changed2Fixed4Other4

BreakingUpgrade verdict

1 breaking change and a platform requirement change.

  • The library now uses a newer version of the OpenAPI.NET library, and some code that used the old version's API may need updating.
  • The library now works with ASP.NET Core 11.
2 items need code or config changes

Swashbuckle.AspNetCore.SwaggerGen publishes official migration guides for versions 11, 11. They cover more than the release notes do.

V11 migration guide ↗OpenAPI.NET v3 Upgrade Guide ↗

Target frameworks requirement changed in 11.0.0: net10.0, net8.0, net9.0 → net10.0, net11.0.

1 package of its own release moves with it.

Breaking1
v11 depends on OpenAPI.NET v3.11, which introduces breaking changes to the public API surface.
Platform1
Adds support for ASP.NET Core 11.

Generated by DepDelta from published .NET assemblies. Not mixed with prose notes.

  • added: static method SwaggerGenOptionsExtensions.SelectDiscriminatorDefaultMappingUsing(SwaggerGenOptions swaggerGenOptions, Func<Type, Type> customSelector): void
  • added: property SchemaGeneratorOptions.DiscriminatorDefaultMappingSelector: Func<Type, Type> { get; set; }