Skip to content

NSwag v14.0.0

Compare
Choose a tag to compare
@RicoSuter RicoSuter released this 03 Jan 15:58
· 70 commits to master since this release

See #4524

NSwag v14

Breaking changes

  • NJsonSchema generator settings moved from being directly on the generator settings to the "SchemaSettings" property.
  • nswag.json now only supports .csproj based specification generation (reflection/assembly based removed, only aspnetcore2openapi)
  • Now only supports .NET Standard 2.0, .NET 4.6.2, .NET Core 3.1, .NET 5, .NET 7 and up
  • Requires latest Newtonsoft.Json v13.0.0.3
  • Removed many deprecated properties, settings and methods (marked a long time as obsolete)
  • Removed WebApiToOpenApiCommand:
    • Use the WebApiOpenApiDocumentGenerator to build your own CLI referencing controllers project to generate OpenAPI without starting the app
  • Renamed UseSwaggerUi3 to UseSwaggerUi (v2 has been removed)

NJsonSchema v11

Breaking changes

  • All Newtonsoft.Json based generators, converters (e.g. JsonInheritance) moved to NJsonSchema.NewtonsoftJson; NJsonSchema contains the converters for System.Text.Json
  • Requires latest Newtonsoft.Json v13.0.0.3
  • Now only supports .NET Standard 2.0, .NET 4.6.2 and up
  • Updated to latest Namotion.Reflection v3
  • Breaking change in IJsonExtensionObject interface (now supports multiple data tuples)

Other changes:

  • Add support for STJ-native inheritance schema generation (JsonDerivedType, JsonPolymorphic)
  • Many more smaller improvements and fixes (see git history)