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

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

중요 링크:

• 기존 앱을 이전 버전의 Windows 앱 SDK에서 최신 버전으로 업그레이드하려면 기존 프로젝트를 Windows 앱 SDK의 최신 릴리스로 업데이트를 참조하세요.

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

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

Windows App SDK 다운로드

버전 0.8

Windows App SDK의 안정적인 채널의 0.8.x 계통의 최신 릴리스는 버전 0.8.12입니다.

버전 0.8.12

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

버그 수정(0.8.12)

• Access 위반으로 인해 SwapChainPanel 또는 WebView2 가 있는 앱이 예측할 수 없을 정도로 충돌하는 문제를 해결했습니다.

버전 0.8.11

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

버그 수정(0.8.11)

• 마우스를 사용하여 텍스트를 선택할 때 포커스 손실 이벤트가 발생하는 회귀가 수정되었습니다.

버전 0.8.10

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

버그 수정(0.8.10)

• 끌어서 놓기 작업 중에 앱이 때때로 충돌하는 문제들을 해결했습니다.

버전 0.8.8

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

버그 수정(0.8.8)

• 소프트 키보드 및 일반적인 상호 작용과 관련된 TextBox의 터치 입력 문제를 해결했습니다. 이러한 문제는 바로 가기 키에도 영향을 줍니다. 자세한 내용은 Github의 문제 6291 을 참조하세요.
• 앱 창이 활성 상태일 때 비활성으로 표시되는 문제가 해결되었습니다.
• 외부 프로세스에서 실행되는 UIA(UI 자동화)로 인한 성능 문제가 해결되었습니다.
• 펜 입력과 관련된 앱 안정성 문제를 해결했습니다.
• UIA로 인해 메뉴의 png 아이콘 렌더링이 크게 지연되는 문제가 해결되었습니다.

버전 0.8.7

C#/.NET 애플리케이션에 대한 여러 성능 업데이트를 포함하는 Windows 앱 SDK의 서비스 릴리스입니다. 이 버전으로 업데이트하려면 최신 Windows SDK 패키지 버전을 참조해야 합니다. 그러기 위해서는 TargetFramework 속성에서 앱이 목표로 하는 SDK 버전과 함께 <WindowsSdkPackageVersion>10.0.<sdk_version>.24</WindowsSdkPackageVersion> 속성을 .csproj 파일에 추가합니다. 예시:

<Project Sdk="Microsoft.NET.Sdk">
   <PropertyGroup>
       <OutputType>WinExe</OutputType>
       <TargetFramework>net6.0-windows10.0.19041.0</TargetFramework>
       <TargetPlatformMinVersion>10.0.17763.0</TargetPlatformMinVersion>
       <WindowsSdkPackageVersion>10.0.19041.24</WindowsSdkPackageVersion>
   <PropertyGroup>
   ...

이 버전의 Windows SDK 프로젝션은 예정된 .NET 6 서비스 릴리스에서 사용할 수 있습니다. .NET SDK 업데이트를 사용할 수 있게 된 후에는 프로젝트 파일에서 속성을 제거 <WindowsSdkPackageVersion> 해야 합니다.

이 속성을 설정하지 않으면 다음과 같은 오류가 표시됩니다. "Error: This version of Project Reunion requires WinRT.Runtime.dll version 1.6 or greater."

버전 0.8.6

0.8.0 릴리스의 C#/.NET 응용 프로그램에 대한 몇 가지 성능 향상을 포함하는 Windows 앱 SDK의 서비스 릴리스입니다.

이 버전의 Windows App SDK를 업데이트하려면 최신 .NET SDK December 업데이트가 설치되어 있어야 합니다( .NET 다운로드 참조 그리고 .NET 5는 2022년 5월 10일에 지원 종료에 도달합니다). 필요한 최소 버전의 .NET SDK가 설치되어 있지 않으면 다음과 같은 오류가 표시됩니다. "Error: This version of Project Reunion requires WinRT.Runtime.dll version 1.4 or greater."

버그 수정(0.8.6)

성능 향상에 대한 자세한 목록은 C#/WinRT 1.4.1 릴리스 정보를 참조하세요.

버전 0.8.5

0.8.0 릴리스에 대한 더 중요한 버그 수정이 포함된 Windows 앱 SDK의 서비스 릴리스입니다.

버그 수정(0.8.5)

• 포인터 입력을 사용하여 WinUI 앱이 충돌하는 문제를 해결했습니다.
• 제목 표시줄 단추(최소, 최대, 닫기)의 모서리가 Windows 11에서 둥글지 않은 문제를 해결했습니다.
• Windows 11 최대화/복원 단추 위로 마우스를 가져가면 크기 조정 레이아웃 옵션이 표시되지 않는 문제를 해결했습니다.
• PointCollection 개체를 만드는 경우 충돌 예외가 발생하는 문제를 해결했습니다. 자세한 내용은 Github의 문제 971을 참조하세요.

버전 0.8에 대한 제한 사항 및 알려진 문제는 아래 섹션에서 달리 표시되지 않는 한 버전 0.8.5에도 적용됩니다.

버전 0.8.4

0.8.0 릴리스에 대한 더 중요한 버그 수정이 포함된 Windows 앱 SDK의 서비스 릴리스입니다.

버그 수정(0.8.4)

• ContentDialog가 이를 숨기지 않고 제목 표시줄 단추가 둥글도록 사용자 지정 제목 표시줄을 수정합니다.
• 디스플레이 크기 조정이 변경될 때 이미지 처리가 충돌하는 문제를 수정합니다.
• UI가 사라지거나 잘못 잘리는 클리핑 버그를 수정합니다.

버전 0.8에 대한 제한 사항 및 알려진 문제는 아래 섹션에서 달리 표시되지 않는 한 버전 0.8.4에도 적용됩니다.

버전 0.8.3

0.8.0 릴리스에 대한 더 중요한 버그 수정이 포함된 Windows 앱 SDK의 서비스 릴리스입니다.

버그 수정(0.8.3)

창을 최소화한 다음 복원할 때 키보드 포커스가 손실되어 포커스를 복원하려면 마우스 클릭이 필요했습니다.

버전 0.8에 대한 제한 사항 및 알려진 문제는 아래 섹션에서 달리 표시되지 않는 한 버전 0.8.3에도 적용됩니다.

버전 0.8.2

0.8.0 릴리스에 대한 더 중요한 버그 수정이 포함된 Windows 앱 SDK의 서비스 릴리스입니다.

버그 수정(0.8.2)

• Windows 앱 SDK 및 WinUI 3은 이제 Visual Studio 2022 미리 보기 2 이상에서 지원됩니다.
• .NET 앱의 경우 열거형 배열을 전달할 때 다음 오류가 발생할 수 있습니다. Object contains non-primitive or non-blittable data.
• 텍스트 상자 내에서 필기 패널을 사용하여 작성 시 충돌 발생
• 아이콘/이미지는 항상 모니터 배율 값을 기반으로 하는 것이 아니라 100% 배율 값으로 로드됨
• EventSource<T>의 가비지 수집으로 인해 후속 오류로 인한 처리기 구독 취소 발생(자세한 내용은 GitHub 문제 참조)
• 보안 수정 – 자세한 내용은 CVE-2021-34533을 참조하세요.
• 디스플레이 배율 변경 후 SwapChainPanel.CompositionScaleChanged에서 잘못된 CompositionScale 값을 반환하는 경우가 있습니다.

버전 0.8에 대한 제한 사항 및 알려진 문제는 아래 섹션에서 달리 표시되지 않는 한 버전 0.8.2에도 적용됩니다.

버전 0.8.1

0.8.0 릴리스에 대한 몇 가지 중요한 버그 수정이 포함된 Windows 앱 SDK의 서비스 릴리스입니다.

버그 수정(0.8.1)

• Windows 앱 SDK를 최신 Windows 참가자 빌드에서 실행할 수 없음
• 드롭다운에 표시되지 않는 값을 입력할 때 EditableComboBox에서 충돌 발생
• WebView2는 포커스가 수신되면 사용자가 탭아웃할 수 없음
• 네임스페이스 모호성을 피하기 위해 WinUI 생성 코드에서 Windows.Foundation.Metadata.DefaultOverload 네임스페이스를 정규화함
  • 이를 통해 버그 #5108이 수정되었습니다.
• 보안 수정 – 자세한 내용은 CVE-2021-34489를 참조하세요.

버전 0.8에 대한 제한 사항 및 알려진 문제는 아래 섹션에서 달리 표시되지 않는 한 버전 0.8.1에도 적용됩니다.

버전 0.8.0 안정적인 릴리스

새로운 기능 및 업데이트

이 릴리스는 모든 안정적인 채널 기능을 지원합니다.

WinUI 3:

이 릴리스에는 WinUI 3에서 많은 버그 수정 및 향상된 안정화가 포함되어 있습니다. WinUI 3 - 프로젝트 리유니언 0.5 릴리스 이후 WinUI 3의 모든 새로운 변경 내용입니다.

• 피벗 컨트롤이 다시 추가되었으며 이제 모든 WinUI 3 앱에서 사용할 수 있습니다.

• 프로젝트 리유니언 v0.5.5, v0.5.6 및 v0.5.7의 모든 버그 수정이 이 릴리스에 포함되어 있습니다.

• 새로운 버그 수정은 다음과 같습니다.

  • TextBox에서 마우스 오른쪽 단추로 클릭하면 애플리케이션이 충돌함
  • NavigationView로 인해 UWP, 리유니언 0.5 미리 보기에서 충돌이 발생함
  • ProgressBar가 일시 중지됨 옵션과 오류 옵션에서 차이가 없음
  • 텍스트 스타일을 복사/붙여넣기/변경 시 RichEditBox에서 충돌 발생
  • SetTitleBar가 설정되지 않았거나 null인 경우 창 캡션 단추의 위치가 잘못될 수 있음

  이 릴리스에서 해결된 버그의 전체 목록은 GitHub 리포지토리를 참조하세요.

• ColorHelper.ToDisplayName API는 더 이상 사용할 수 없습니다

• 다음 유형이 제거되었습니다.

  • Microsoft.Graphics.IGeometrySource2D
  • Microsoft.Graphics.IGeometrySource2DInterop

  대신 Windows.Graphics.IGeometrySource2D 및 Windows.Graphics.IGeometrySource2DInterop을 사용하세요.

• DispatcherQueue 클래스를 포함하여 Microsoft.System 네임스페이스의 모든 유형이 Microsoft.UI.Dispatching 네임스페이스로 이동되었습니다.

• HostBackdrop은(는) WinUI 3에서 BackgroundSource(으)로 지원되지 않기 때문에 AcrylicBrush.BackgroundSource 속성이 제거되었습니다.

WinUI에 대한 자세한 내용은 WinUI를 참조하세요.

WinUI 3 컨트롤 및 기능이 작동하는 것을 보려면 GitHub에서 WinUI 3 Gallery 앱 을 복제 및 빌드하거나 Microsoft Store에서앱을 다운로드할 수 있습니다.

WinUI를 사용하여 개발을 시작하려면 다음 문서를 확인하세요.

• Visual Studio의 WinUI 3 템플릿
• 첫 번째 WinUI 3(Windows 앱 SDK) 프로젝트 만들기
• WinUI 3 및 Win32 interop을 사용하여 C# .NET 앱 빌드
• WinUI 3 API 참조

DWriteCore:

이 DWriteCore 릴리스에는 다음과 같은 새로운 기능과 업데이트된 기능이 포함되어 있습니다. DWriteCore는 DWriteCore 개요에서 소개되고 설명됩니다.

• DWriteCore에서 밑줄 지원 - IDWriteTextLayout::GetUnderline 및 IDWriteTextLayout::SetUnderline을 참조하세요.
• 취소선 지원 - IDWriteTextLayout::GetStrikethrough 및 IDWriteTextLayout::SetStrikethrough를 참조하세요.
• IDWriteTextLayout을 통한 세로 텍스트 지원 - 세로 텍스트를 참조하세요.
• IDWriteTextAnalyzer 및 IDWriteTextAnalyzer1 인터페이스의 모든 메서드가 구현됩니다.
• DWriteCoreCreateFactory free 함수는 개별 DWriteCore 개체의 후속 생성에 사용되는 센터 개체를 만듭니다.

DWriteCore 및 DirectWrite API 참조는 DWriteCore API 참조 및 DirectWrite API 참조를 참조하세요.

MRTCore:

• 리소스에 대한 빌드 작업은 프로젝트에 리소스를 추가할 때 자동으로 설정되어 수동 프로젝트 구성의 필요성을 줄입니다.

제한 사항

• 이 릴리스는 현재 Windows 참가자 프로그램 개발자 채널에서 지원되지 않습니다. 이는 버전 0.8.1에서 수정되었습니다.

• 데스크톱 응용 그로그램(C# 또는 C++ 데스크톱): 이 릴리스는 MSIX를 사용하여 패키지된 데스크톱 응용 그로그램(C++ 또는 C#)에서만 사용할 수 있습니다. 패키지되지 않은 데스크톱 응용 그로그램에서 Windows 앱 SDK를 사용하려면 실험적 릴리스 채널을 사용해야 합니다.

알려진 문제

• 라이브 시각적 트리, 라이브 속성 탐색기 및 버전 0.8 이상의 핫 다시 로드 같은 WinUI 3 도구에는 Visual Studio 2019 16.11 미리 보기 3 이상 버전이 필요합니다.

• 현재 WinUI 3 및 Windows 앱 SDK 0.8을 사용하는 앱은 프로젝트 리유니언 0.5를 사용하는 클래스 라이브러리를 사용할 수 없습니다. Windows 앱 SDK 0.8을 사용하도록 클래스 라이브러리를 업데이트합니다.

• .NET 앱은 빌드 18362 이상을 대상으로 해야 합니다. TFM은 net6.0-windows10.0.18362 이상으로 설정해야 하며, 패키지 프로젝트는 18362 이상으로 설정해야 합니다. 자세한 내용은 GitHub문제 #921을 참조하세요.

• 밝은 모드와 어둠 모드 간에 자주 전환할 때 충돌이 발생할 수 있습니다.

• .NET 앱의 경우 열거형 배열을 전달할 때 다음 오류가 발생할 수 있습니다. Object contains non-primitive or non-blittable data. 이는 버전 0.8.2에서 수정되었습니다.

• .NET 앱의 경우 현재 Visual Studio UI를 사용하여 앱 리소스로 인덱싱되는 이미지를 옵트아웃할 방법이 없습니다. 이를 해결하려면 다음과 같이 Directory.Build.targets(지침은 빌드 사용자 지정 - Visual Studio 참조)를 프로젝트에 추가하고 이미지를 제거합니다.

  • 특정 이미지를 제거하려면(상대 경로 필요) 다음을 수행합니다.

    <Project>
    <ItemGroup>
        <Content Remove="..\Bitmap1.bmp" />
    </ItemGroup>
    </Project>
    

    • 메타데이터에 따라 이미지를 제거하려면 다음을 수행합니다.

    <Project>
    <ItemGroup>
        <Content Remove="@(None->WithMetadataValue('Pack','true'))" />
    </ItemGroup>
    </Project>
    

    이 문제에 대한 수정은 향후 릴리스에 대해 계획되어 있습니다. 이 시점에서는 위의 해결 방법이 더 이상 필요하지 않습니다.

관련 항목

• Windows 앱 SDK에 대한 최신 미리 보기 채널 릴리스 정보
• Windows 앱 SDK에 대한 최신 실험적 채널 릴리스 정보
• Windows 앱 SDK용 도구 설치
• 첫 번째 WinUI 3(Windows 앱 SDK) 프로젝트 만들기
• 기존 프로젝트에서 Windows 앱 SDK 사용
• 배포 개요