One significant change in this major version is the separation of Win32 metadata from the package. Instead of bundling it with the package, the Win32 metadata is now obtained from the NuGet package Microsoft.Windows.SDK.Win32Metadata. Additionally, this update introduces the capability to load a specific version of the metadata.
(Note that the 51.0.33-preview version corresponds to the same metadata that was previously bundled with the winmd v3.)
As explained in the documentation, it is crucial to increment this version only when gearing up for a major release of the win32 package, as such updates may introduce breaking changes in the generated code.
One significant change in this major version is the separation of Win32 metadata from the package. Instead of bundling it with the package, the Win32 metadata is now obtained from the NuGet package Microsoft.Windows.SDK.Win32Metadata. Additionally, this update introduces the capability to load a specific version of the metadata.
These changes eliminate the necessity of locking the
winmddependency to a specific version. Nevertheless, we still need to load a specific metadata version when generating projections and running tests to maintain consistency. To facilitate this, I've introduced a new constant calledwin32MetadataVersion: https://github.com/dart-windows/win32/blob/53b6445170b5d400c48cf84cfdcf369588c6b5ad/tool/win32gen/lib/src/constants.dart#L1-L7(Note that the
51.0.33-previewversion corresponds to the same metadata that was previously bundled with thewinmdv3.)As explained in the documentation, it is crucial to increment this version only when gearing up for a major release of the
win32package, as such updates may introduce breaking changes in the generated code.