search

microsoft / windows-rs

Rust for Windows
https://kennykerr.ca/rust-getting-started/
Apache License 2.0
10.35k stars 486 forks source link

Suggestion: Document the associated version of Win32 metadata for windows-rs releases. #3118

Closed talagrand closed 3 months ago

talagrand commented 3 months ago

Suggestion

When generating winmds from win32 code for use with windows-rs, it's important to ensure that we use the same version of base metadata on both sides, esp as things occasionally move around. Right now, I look this up by looking for the Windows.Win32.winmd in this repo at the correct commit, and opening it with ildasm.exe to look at the version metadata. That's not super discoverable.

I'd suggest just documenting the associated NuGet version, which is where the checked in copy presumably comes from: https://www.nuget.org/packages/Microsoft.Windows.SDK.Win32Metadata/

talagrand commented 3 months ago

I hang my head in shame, this is already present! I don't know how I missed it