다음을 통해 공유

Windows 앱 SDK 1.3에 대한 안정적인 채널 릴리스 정보

  • 아티클

안정적인 채널은 프로덕션 환경의 앱에서 사용할 수 있도록 지원되는 Windows 앱 SDK의 릴리스를 제공합니다. Windows 앱 SDK의 안정적인 릴리스를 사용하는 앱을 Microsoft Store에 게시할 수도 있습니다.

중요 링크:

최신 안정적인 채널 릴리스:

Windows App SDK 다운로드

참고 항목

Windows 앱 SDK Visual Studio 확장(VSIX)은 더 이상 별도의 다운로드로 배포되지 않습니다. Visual Studio 내의 Visual Studio Marketplace에서 사용할 수 있습니다.

Version 1.3.3 (1.3.230724000)

1.3 릴리스에 대한 중요한 버그 수정을 포함하는 Windows 앱 SDK의 서비스 릴리스입니다.

  • 대화 상자를 닫을 때 마우스가 작동을 중지하는 문제가 해결되었습니다.
  • 시스템에서 패키지 버전이 일치하지 않아 앱이 설치되지 않는 배포 문제가 해결되었습니다. 자세한 내용은 GitHub 이슈 #3740를 참조하십시오.
  • Windows 앱 SDK 1.3의 상황에 맞는 메뉴 위치에 영향을 주는 문제를 해결했습니다.
  • XAML이 너무 일찍 종료되어 앱이 닫혔을 때 일부 WinUI3 앱이 충돌하는 문제를 해결했습니다.
  • 글꼴 아이콘이 오른쪽에서 왼쪽 언어로 제대로 미러 않는 문제를 해결했습니다. 자세한 내용은 GitHub 이슈 #7661를 참조하십시오.
  • 리소스가 잘못된 순서로 중단될 때 앱이 종료 시 충돌하는 문제를 해결했습니다. 자세한 내용은 GitHub 이슈 #7924를 참조하십시오.

Version 1.3.2 (1.3.230602002)

1.3 릴리스에 대한 중요한 버그 수정을 포함하는 Windows 앱 SDK의 서비스 릴리스입니다.

  • 보호된 커서를 설정할 때 충돌이 해결되었습니다.
  • 앱을 시작하는 동안 XamlMetadataProvider의 성능 문제가 해결되었습니다. 자세한 내용은 GitHub 이슈 #8281를 참조하십시오.
  • RichTextBlock의 하이퍼링크 및 터치 문제를 해결했습니다. 자세한 내용은 GitHub 이슈 #6513를 참조하십시오.
  • WebView2에서 스크롤 및 터치 패드 문제를 해결했습니다. 자세한 내용은 GitHub 이슈 #7772를 참조하십시오.
  • Windows 앱 SDK 업데이트할 때 Visual Studio를 다시 시작해야 하는 문제가 해결되었습니다. 자세한 내용은 GitHub 이슈 #3554를 참조하십시오.
  • 디버거에서 실행할 때 종료 시 시끄러운 예외가 수정되었습니다.

Version 1.3.1 (1.3.230502000)

1.3 릴리스에 대한 중요한 버그 수정을 포함하는 Windows 앱 SDK의 서비스 릴리스입니다.

  • 콘텐츠가 null인 경우 SystemBackdrop을 설정할 때 앱이 충돌하는 문제를 해결했습니다. 자세한 내용은 GitHub 이슈 #8416를 참조하십시오.
  • 1.3.0에 추가된 새로운 기능인 XAML에서 창 제목을 설정할 때 앱이 충돌하는 문제를 해결했습니다. 자세한 내용은 GitHub 이슈 #3689를 참조하십시오.
  • 콘텐츠가 변경될 때 창이 잘못 포커스를 가져간 문제를 해결했습니다.
  • WinAppSDK 1.3 프로젝트 템플릿을 사용하여 C++ 프로젝트를 만드는 문제를 해결했습니다.
  • Visual Studio Marketplace에서 업데이트된 템플릿

버전 1.3에 대한 새로운 기능, 업데이트된 기능 및 알려진 문제

다음 섹션에서는 버전 1.3의 새로운 기능과 업데이트된 기능 및 알려진 문제에 대해 설명합니다.

기존 Windows App SDK 1.2 앱에서는 Nuget 패키지를 1.3.230331000으로 업데이트할 수 있습니다(NuGet 패키지 매니저를 사용하여 Visual Studio에 패키지 설치 및 관리의 패키지 업데이트 섹션 참조).

업데이트된 런타임 및 MSIX는 최신 Windows 앱 SDK 다운로드를 참조하세요.

XAML 배경 API

XAML 창에 기본 제공된 속성을 사용하면 이제 WinUI 3 앱에서 Mica & Background Acrylic 배경을 더 쉽게 사용할 수 있습니다. Xaml 배경 속성에 대한 자세한 내용은 시스템 배경 및 Mica 배경 API 문서를 참조하세요.

public MainWindow()
{
    this.InitializeComponent();

    this.SystemBackdrop = new MicaBackdrop();
}

Window.AppWindow

보일러 플레이트 코드의 여러 줄을 교체하면 이제 창에서 Window.AppWindow까지 AppWindow API를 직접 사용할 수 있습니다.

WinAppSDK 전체의 새로운 기능

  • ApplicationModel.DynamicDependency: PackageDependency.PackageGraphRevisionId 사용되지 않는 MddGetGenerationId를 대체합니다.
  • 환경 관리자: EnvironmentManager.AreChangesTracked 애플리케이션에서 환경 관리자의 변경 내용을 추적할 수 있는지 여부를 알려 줍니다.
  • 이제 참조된 정적/테마리소스 조회를 확인할 수 없는 경우 새 이벤트인 DebugSettings.XamlResourceReferenceFailed가 발생합니다. 이 이벤트는 정적 & ThemeResource 조회 실패를 디버깅할 수 있도록 프레임워크에서 해당 키를 검색한 위치를 자세히 설명하는 추적에 액세스할 수 있도록 합니다. 자세한 내용은 GitHub의 추적 XAML 리소스 참조 조회 실패 API 사양을 참조하세요.

기타 업데이트

  • 이 릴리스에서 해결된 추가 문제에 대해서는 WinAppSDK GitHub의 WinAppSDK 1.3 마일스톤을 참조하십시오.
  • 이 릴리스에서 해결된 추가 문제는 마이크로소프트-ui-xaml GitHub의 WinAppSDK 1.3 마일스톤에서 당사의 WinUI3를 참조하십시오.
  • 최신 실험적 VSIX를 사용하면 이제 프로젝트 파일 대신 Visual Studio 메뉴를 통해 패키지되지 않은 상태로 앱을 변환할 수 있습니다.

알려진 문제

xaml 컴파일러의 최근 변경으로 인해 1.3으로 업그레이드하는 기존 프로젝트에서 Visual Studio 내에서 다음과 같은 빌드 오류가 발생할 수 있습니다.

> C:\Users\user\\.nuget\packages\microsoft.windowsappsdk\\**1.3.230331000**\buildTransitive\Microsoft.UI.Xaml.Markup.Compiler.interop.targets(537,17): error MSB4064: The "PrecompiledHeaderFile" parameter is not supported by the "CompileXaml" task loaded from assembly: Microsoft.UI.Xaml.Markup.Compiler, Version=1.0.0.0, Culture=neutral, PublicKeyToken=de31ebe4ad15742b from the path: C:\Users\user\\.nuget\packages\microsoft.windowsappsdk\\**1.2.230118.102**\tools\net472\Microsoft.UI.Xaml.Markup.Compiler.dll. Verify that the parameter exists on the task, the <UsingTask> points to the correct assembly, and it is a settable public instance property.

이는 Visual Studio가 1.2에서 캐시된 xaml 컴파일러 작업 dll을 사용하지만 위의 오류 텍스트에 표시된 것처럼 1.3의 호환되지 않는 MSBuild 논리로 인해 발생합니다. 해결 방법은 Visual Studio를 종료하고, 다시 시작하고, 솔루션을 다시 로드하는 것입니다.