Swashbuckle.AspNetCore v11.0.0
Important
This release contains major breaking changes.
Read our v11 migration guide for further information.
With this release, Swashbuckle.AspNetCore adds support for generating OpenAPI 3.2 documents and for ASP.NET Core 11.
Swashbuckle.AspNetCore v11 depends on OpenAPI.NET v3.11 which introduces some breaking changes to the public API surface. More information can be found in their OpenAPI.NET v3 Upgrade Guide.
To reduce the number of breaking behavioural changes in Swashbuckle.AspNetCore v11, generation of OpenAPI 3.1 and 3.2 documents is opt-in.
To generate OpenAPI 3.1 or 3.2 documents, change the OpenAPI version as shown in the code snippet below:
app.UseSwagger(options =>
{
options.OpenApiVersion = OpenApiSpecVersion.OpenApi3_1;
// ...or
options.OpenApiVersion = OpenApiSpecVersion.OpenApi3_2;
});Tip
It is strongly recommended that you upgrade to Swashbuckle.AspNetCore v10.3.1 before upgrading to v11.
What's Changed
- Validate packages in parallel by @martincostello in #4223
- Do not generated response codes for empty XML by @Marynat in #4238
- Fix #2596: resolve query properties inherited from a parent interface by @RaphaelFakhri in #4236
- Skip open generic types when finding subtypes by @mohsinaliwork686-rgb in #4245
- Fix crash on non-public Newtonsoft members with UseAllOfForInheritance by @mohsinaliwork686-rgb in #4244
- Mark IReadOnlySet schemas as uniqueItems by @mohsinaliwork686-rgb in #4246
- Support ASP.NET Core 11 by @martincostello in #3786
- Update README by @martincostello in #4250
- Address review feedback by @martincostello in #4251
New Contributors
- @Marynat made their first contribution in #4238
- @mohsinaliwork686-rgb made their first contribution in #4245
Full Changelog: v10.3.1...v11.0.0