FrameworkReference substituído pelo WindowsSdkPackageVersion para o SDK do Windows

Artigo
05/10/2023

A partir do .NET 5.0.8 (que inclui o SDK do .NET 5.0.302 e o SDK do .NET 5.0.205), os desenvolvedores que fizerem direcionamento ao Windows não poderão usar o item FrameworkReference para substituir sua versão do pacote de direcionamento do SDK do Windows. A propriedade WindowsSdkPackageVersion substitui essa funcionalidade.

Observação

Não recomendamos substituir a versão do SDK do Windows, pois os pacotes de direcionamento do SDK do Windows estão incluídos no SDK do .NET 5+. Em vez disso, para fazer referência ao pacote mais recente do SDK do Windows, atualize sua versão do SDK do .NET.

Versão introduzida

SDK do .NET 5.0.302, SDK do .NET 5.0.205

Comportamento anterior

Os desenvolvedores podiam usar o item FrameworkReference para substituir a versão do pacote do SDK do Windows em aplicativos .NET 5. Por exemplo:

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

Novo comportamento

A propriedade WindowsSdkPackageVersion substitui o comportamento da substituição FrameworkReference. Por exemplo:

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

Categoria da alteração

Essa alteração pode afetar a compatibilidade com a origem.

Motivo da alteração

Essa alteração foi introduzida para simplificar o comportamento de substituição do pacote para direcionamento dos pacotes do SDK do Windows produzidos pelo C#/WinRT.

Ação recomendada

Remova qualquer uso do FrameworkReference em seu arquivo de projeto do aplicativo .NET 5+ ao fazer o direcionamento para o SDK do Windows.

APIs afetadas

APIs do Windows no .NET 5 e versões posteriores que são fornecidas pelo pacote de direcionamento do SDK do Windows.

Compartilhar via