domaindrivendev/Swashbuckle.AspNetCore v8.0.0

on GitHub

Swashbuckle.AspNetCore v8.0.0 makes the following notable changes:

• Drops support for net6.0.
• The netstandard2.0 TFM now depends on ASP.NET Core 2.3 instead of ASP.NET Core 2.1.
• Updates Microsoft.OpenApi to v1.6.23. This update requires the use of swagger-ui v5.19.0 or later (v5.20.1 is included in the Swashbuckle.AspNetCore.SwaggerUI NuGet package).
• To prepare for future support for OpenAPI 3.1 documents, deprecates the SerializeAsV2 property by marking it as [Obsolete]. Users should update their code as illustrated below, depending on their use case:

  - options.SerializeAsV2 = true;
  + options.OpenApiVersion = Microsoft.OpenApi.OpenApiSpecVersion.OpenApi2_0;
  
  // or if explicitly disabling (the same as the default behaviour)
  - options.SerializeAsV2 = false;
  + options.OpenApiVersion = Microsoft.OpenApi.OpenApiSpecVersion.OpenApi3_0;

• To prepare for future support for OpenAPI 3.1 documents, the Swashbuckle.AspNetCore.Cli tool has deprecated the --serializeasv2 option and logs a warning to the console. Users should update their usage as illustrated below, depending on their use case:

  - swagger tofile --output [output] [startupassembly] [swaggerdoc] --serializeasv2
  + swagger tofile --output [output] [startupassembly] [swaggerdoc] --openapiversion "2.0"

What's Changed

• More reliable coverage by @martincostello in #3294
• Apply IDE refactoring suggestions by @martincostello in #3254
• .NET 10 preparation by @martincostello in #3285
• Move snapshots by @martincostello in #3314
• Snapshot OpenApiDocument as JSON by @martincostello in #3315
• Enable implicit usings by @martincostello in #3316
• Drop .NET 6 by @martincostello in #3183
• Deprecate SerializeAsV2 by @martincostello in #3286
• Improve release automation by @martincostello in #3317
• Bump NuGet packages by @martincostello in #3319

Full Changelog: v7.3.2...v8.0.0