FrameworkReference nahrazeno WindowsSdkPackageVersion pro Windows SDK

Počínaje verzí .NET 5.0.8 (která zahrnuje sadu .NET SDK 5.0.302 a .NET SDK 5.0.205), nemůžou vývojáři, kteří cílí na Windows, použít položku FrameworkReference k přepsání jejich verze balíčku cílení na sadu Windows SDK. Vlastnost WindowsSdkPackageVersion nahrazuje tuto funkci.

Poznámka

Nedoporučujeme přepisovat verzi sady Windows SDK, protože balíčky cílení sady Windows SDK jsou součástí sady .NET 5+ SDK. Pokud chcete odkazovat na nejnovější balíček sady Windows SDK, aktualizujte svou verzi sady .NET SDK.

Zavedená verze

.NET SDK 5.0.302, .NET SDK 5.0.205

Předchozí chování

Vývojáři můžou použít položku FrameworkReference k přepsání verze balíčku sady Windows SDK v aplikacích .NET 5. Například:

<ItemGroup>
  <FrameworkReference Update="Microsoft.Windows.SDK.NET.Ref" RuntimeFrameworkVersion="10.0.19041.18" />
  <FrameworkReference Update="Microsoft.Windows.SDK.NET.Ref" TargetingPackVersion="10.0.19041.18" />
</ItemGroup>

Nové chování

Vlastnost WindowsSdkPackageVersion nahrazuje chování překrytí FrameworkReference. Například:

<PropertyGroup>
  <WindowsSdkPackageVersion>10.0.19041.18</WindowsSdkPackageVersion>
</PropertyGroup>

Kategorie změn

Tato změna může mít vliv na zdrojovou kompatibilitu .

Důvod změny

Tato změna byla zavedena, aby se zjednodušilo chování při přepisování balíčků, které cílí na balíčky Windows SDK vytvářené pomocí C#/WinRT.

Doporučená akce

Při cílení na Windows SDK odeberte jakékoli použití FrameworkReference v souboru projektu aplikace pro .NET 5+.

Při práci se sadou Windows App SDKmožná budete muset explicitně přidat vlastnost WindowsSdkPackageVersion, pokud požadovaná balíček sady Windows SDK verzi nelze přeložit sadou .NET SDK. K tomuto problému může dojít z důvodu různých mechanismů vydávání sady Windows App SDK a sady .NET SDK, kde se sada .NET SDK dodává prostřednictvím sady Visual Studio. Podrobnosti najdete v tomto problému s GitHubem. Po vyřešení požadované verze balíčku sady Windows SDK pomocí sady .NET SDK můžete také zvážit odebrání vlastnosti WindowsSdkPackageVersion a zajistit tak nejnovější balíček sady Windows SDK. K tomu obvykle dochází po vydání nové verze sady Visual Studio a upgradovali jste na tuto verzi.

Ovlivněná rozhraní API

Rozhraní API systému Windows v .NET 5 a novějších verzích, které poskytuje sada Windows SDK, která cílí na balíček.