Upgrading Swashbuckle.AspNetCore.SwaggerUI 7 to 8
Review needed7.3.2 → 8.1.4Deprecated2New1Changed6Fixed4Other16
Review neededUpgrade verdict
2 deprecations.
In plain terms
- The SerializeAsV2 setting is being retired; switch to the new OpenApiVersion setting instead.
- The command-line tool's --serializeasv2 flag is being retired; use --openapiversion "2.0" instead.
Must act 2 items need code or config changes
Target frameworks requirement changed in 8.0.0: .NETStandard2.0, net6.0, net8.0, net9.0 → .NETStandard2.0, net8.0, net9.0.
Nothing in this upgrade needs a code or configuration change.
Deprecations to plan for
Deprecated2
Deprecates the SerializeAsV2 property by marking it [Obsolete] in preparation for OpenAPI 3.1 support.
SerializeAsV2OpenApiVersionMicrosoft.OpenApi.OpenApiSpecVersion.OpenApi2_0Microsoft.OpenApi.OpenApiSpecVersion.OpenApi3_0Deprecates the --serializeasv2 option of the Swashbuckle.AspNetCore.Cli tool and logs a warning to the console.
--serializeasv2--openapiversion