FrameworkReference가 Windows SDK에 대한 WindowsSdkPackageVersion으로 바뀌었음

아티클
02/16/2024

Windows를 대상으로 하는 개발자는 .NET 5.0.8(.NET SDK 5.0.302 및 .NET SDK 5.0.205 포함)부터 Windows SDK 대상 패키지 버전을 재정의하기 위해 FrameworkReference 항목을 사용할 수 없습니다. WindowsSdkPackageVersion 속성은 이 기능을 대체합니다.

참고 항목

Windows SDK 대상 패키지가 .NET 5+ SDK에 포함되어 있으므로 Windows SDK 버전을 재정의하지 않는 것이 좋습니다. 그 대신 최신 Windows SDK 패키지를 참조하려면 .NET SDK 버전을 업데이트하세요.

도입된 버전

.NET SDK 5.0.302, .NET SDK 5.0.205

이전 동작

개발자는 FrameworkReference 항목을 사용하여 .NET 5 애플리케이션에서 Windows SDK 패키지 버전을 재정의할 수 있습니다. 예시:

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

새 동작

WindowsSdkPackageVersion 속성은 FrameworkReference 재정의 동작을 대체합니다. 예시:

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

변경 범주

이 변경은 원본 호환성에 영향을 줄 수 있습니다.

변경 이유

이 변경 내용은 C#/WinRT로 생성된 Windows SDK 패키지를 대상으로 하는 패키지 재정의 동작을 간소화하기 위해 도입되었습니다.

권장 작업

Windows SDK를 대상으로 할 때 .NET 5+ 앱의 프로젝트 파일에서 FrameworkReference를 사용하지 않습니다.

영향을 받는 API

Windows SDK 대상 패키지에서 제공하는 .NET 5 이상 버전의 Windows API

다음을 통해 공유