Remplacement de FrameworkReference par WindowsSdkPackageVersion pour le kit SDK Windows

Article
05/10/2023

À compter de .NET 5.0.8 (qui comprend les kits SDK .NET 5.0.302 et 5.0.205), les développeurs ciblant Windows ne peuvent pas utiliser l’élément FrameworkReference pour écraser leur version du package de ciblage du kit SDK Windows. La propriété WindowsSdkPackageVersion remplace cette fonctionnalité.

Notes

Nous vous déconseillons d’écraser la version du kit SDK Windows, car les packages de ciblage du kit SDK Windows sont inclus avec le kit SDK .NET 5+. Pour faire référence au dernier package du kit SDK Windows, mettez plutôt à jour votre version du kit SDK .NET.

Version introduite

Kit SDK .NET 5.0.302, kit SDK .NET 5.0.205

Comportement précédent

Les développeurs peuvent utiliser l’élément FrameworkReference pour écraser la version du package du kit SDK Windows dans les applications .NET 5. Par exemple :

<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>

Nouveau comportement

La propriété WindowsSdkPackageVersion remplace le comportement d’écrasement de FrameworkReference. Par exemple :

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

Catégorie de la modification

Ce changement peut affecter la compatibilité source.

Raison du changement

Ce changement a été introduit pour simplifier le comportement d’écrasement de package dans le cadre du ciblage des packages du kit SDK Windows produits par C#/WinRT.

Action recommandée

Supprimez toute utilisation de FrameworkReference dans le fichier projet de votre application .NET 5 (ou version ultérieure) lorsque vous ciblez le kit SDK Windows.

API affectées

API Windows dans .NET 5 (et versions ultérieures) fournies par le package de ciblage du kit SDK Windows.

Partager via