Windows 앱 SDK 1.1에 대한 미리 보기 채널 릴리스 정보

미리 보기 채널에는 개발 후반 단계에서 미리 보기 채널 기능이 있는 Windows 앱 SDK 릴리스가 포함되어 있습니다. 미리 보기 릴리스에는 실험적 기능 및 API가 포함되지 않지만 다음 안정적인 릴리스 이전에도 호환성이 손상되는 변경이 발생할 수 있습니다.

중요 링크:

• 기존 앱을 이전 버전의 Windows 앱 SDK에서 최신 버전으로 업그레이드하려면 기존 프로젝트를 Windows 앱 SDK의 최신 릴리스로 업데이트를 참조하세요.
• 미리보기 릴리스에 대한 문서는 Windows App SDK의 미리보기 및 실험 채널에 대한 도구 설치를 참조하십시오.

최신 미리 보기 채널 릴리스:

• Windows 앱 SDK에 대한 최신 미리 보기 채널 릴리스 정보

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

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

버전 1.1 미리 보기 3(1.1.0-preview3)

버전 1.1용 미리보기 채널의 최신 릴리스입니다. 모든 미리보기 채널 기능을 지원합니다( 출시 채널별로 사용 가능한 기능참조).

Windows App SDK 1.0을 사용하는 기존 앱에서는 Nuget 패키지를 1.1.0-preview3으로 업데이트할 수 있습니다( 의 패키지 업데이트 섹션 참조). Nuget 패키지 매니저를 사용하여 Visual Studio에 패키지를 설치하고 관리합니다). 또한 업데이트된 런타임 및 MSIX에 대한 최신 Windows 앱 SDK 다운로드를 참조하세요.

모든 미리 보기 2 기능 외에도 다음 섹션에서는 이 릴리스의 새로운 기능 및 업데이트된 기능, 제한 사항 및 알려진 문제에 대해 설명합니다.

WinUI 3(1.1.0-preview3)

이제 WinUI 3 애플리케이션에서 Mica 및 Background Acrylic을 사용할 수 있습니다.

이러한 자료에 대한 자세한 내용은 Windows 11에서 자료를 검사. Windows 11용 데스크톱 앱의 Mica 또는 아크릴 자료 적용 및 WinUI 3 컨트롤 갤러리의 일부로 GitHub의 C# 애플리케이션에서 C++ 애플리케이션에서 Mica를 적용하기 위한 샘플 코드를 확인하세요.

알림(1.1.0-preview3)

수정된 문제:

• 1.1.0-preview1 및 1.1.0-preview2에서 일부 패키지되지 않은 앱은 AppData\LocalMicrosoftWindowsAppSDK에 잘못 복사된 앱 아이콘을 볼 수 있습니다. 이 릴리스에서는 대신 AppData\Local\Microsoft\WindowsAppSDK에 복사됩니다. 아이콘이 누출되지 않도록 하려면 1.1.0-preview3으로 업데이트한 후 잘못된 경로에서 앱 아이콘을 수동으로 삭제해야 합니다.
• 이제 바로 가기를 통해 앱 알림에 대한 앱 아이콘 및 앱 표시 이름 검색이 지원됩니다. 이 앱 아이콘은 리소스 파일에 지정된 아이콘보다 우선 순위가 지정됩니다.
• 패키지되지 않은 앱에 대한 푸시 알림 지원이 복원되었습니다(명시된 예외에 대한 제한 사항 참조). 앱이 푸시 알림을 지원하는 경우 검사 위해 PushNotificationManager::IsSupported API를 도입했습니다.

제한 사항:

• 개봉된 개봉 해제된 앱에 대한 알림은 지원되지 않습니다. PushNotificationManager::IsSupported는 상승 모드에 대한 검사를 수행하지 않습니다. 그러나 향후 릴리스에서는 이를 지원하기 위해 노력하고 있습니다.

MSIX 패키징

확장 범주를 통해 새로운 기능을 추가하고 기존 기능을 확장하는 MSIX가 향상되었습니다.

• windows.appExecutionAlias
• windows.customDesktopEventLog
• windows.dataShortcuts
• windows.fileTypeAssociation
• windows.fileTypeAssociation.iconHandler
• windows.folder
• windows.shortcut

이를 위해서는 Windows 앱 SDK 프레임워크 패키지를 설치해야 합니다. 런타임을 설치하려면 최신 Windows 앱 SDK 다운로드를 참조하세요.

환경 관리자(1.1.0-preview3)

개발자가 레지스트리 API를 직접 사용하지 않고도 환경 변수를 추가, 제거 및 수정할 수 있는 API 집합입니다.

1.1 미리 보기 1의 설명: 환경 관리자를 사용한 앱이 제거되면 환경 변수를 자동으로 제거하면 패키지된 앱에서만 사용할 수 있습니다. 또한 환경 변수 변경을 되돌리려면 Windows App SDK 프레임워크 패키지를 설치해야 합니다. 런타임은 최신 Windows App SDK 다운로드를 참조하십시오.

알려진 다른 제한 사항

1.1 미리 보기 2의 회귀:

• MRT Core API를 사용하는 .NET 앱과 가 단일 프로젝트 MSIX와 함께 배포하지 않는 WinUI 앱의 경우:
  • 프로젝트에 기존 항목으로 추가되고 이전에 PRIResource 및 Content ItemGroups에 자동으로 포함된 RESW 및 이미지 파일은 해당 ItemGroups에 포함되지 않습니다. 따라서 이러한 리소스는 PRI 생성 중에 인덱싱되지 않으므로 런타임 중에는 사용할 수 없습니다.
    • 해결 방법: 수동으로 프로젝트 파일에 리소스를 포함하고 None ItemGroup에서 제거합니다.
    • 대체 해결 방법: 사용 가능한 경우 앱의 .NET SDK를 6.0.300으로 업그레이드합니다. 자세한 내용은 NET SDK의 버전 요구 사항을 참조하십시오.
• 단일 프로젝트 MSIX를 사용하여 배포하지 않는 .NET 앱의 경우:
  • 파일이 Content ItemGroup에 두 번 이상 추가되면 빌드 오류가 발생합니다.
    • 해결 방법: 중복 포함/s를 삭제하거나 프로젝트 파일에서 EnableDefaultContentItems를 false로 설정합니다.

두 회귀는 다음 안정적인 릴리스에서 복원됩니다.

버전 1.1 미리 보기 2(1.1.0-preview2)

버전 1.1을 위한 미리보기 채널의 두 번째 릴리스입니다. 모든 미리보기 채널 기능을 지원합니다( 출시 채널별로 사용 가능한 기능참조).

Windows App SDK 1.0을 사용하는 기존 앱에서는 Nuget 패키지를 1.1.0-preview2으로 업데이트할 수 있습니다(의 패키지 업데이트 섹션 참조). Nuget 패키지 매니저를 사용하여 Visual Studio에 패키지를 설치하고 관리합니다). 또한 업데이트된 런타임 및 MSIX에 대한 최신 Windows 앱 SDK 다운로드를 참조하세요.

모든 미리 보기 1 기능 외에도 다음 섹션에서는 이 릴리스의 새로운 기능 및 업데이트된 기능, 제한 사항 및 알려진 문제에 대해 설명합니다.

알림(1.1.0-preview2)

수정된 문제:

• 이제 알림을 보내는 패키지 ID가 없는 앱은 아이콘이 앱 리소스의 일부인 경우 알림에 앱 아이콘을 표시합니다. 앱 리소스에 아이콘이 없으면 Windows 기본 앱 아이콘이 사용됩니다.
• 실행되지 않는 WinUI 3 앱은 이제 알림을 통해 백그라운드로 활성화될 수 있습니다.

1.1 미리 보기 1의 회귀: 패키지되지 않은 앱에 대한 푸시 알림 지원. 다음 릴리스에서 복원될 예정입니다.

알려진 제한 사항:

• 자체 포함 앱이 푸시 알림을 지원하는 경우 검사 위해 PushNotificationManager::IsSupported API를 도입했습니다. 그러나 이 API는 아직 의도한 대로 작동하지 않으므로 IsSupported API를 완전히 지원하기 위해 다음 미리 보기 릴리스에서 주의해야 합니다.
• 일부 패키지되지 않은 앱은 앱 아이콘이 AppData\LocalMicrosoftWindowsAppSDK에 잘못 복사된 것을 볼 수 있습니다. 다음 릴리스의 경우 AppData\Local\Microsoft\WindowsAppSDK로 복사됩니다. 아이콘이 누출되지 않도록 하려면 개발자는 다음 릴리스로 업그레이드한 후 잘못된 경로에서 앱 아이콘을 수동으로 삭제해야 합니다.
• 단축키를 통한 알림에 대한 앱 아이콘 및 앱 표시 이름 검색은 지원되지 않습니다. 하지만 향후 릴리스에서는 이를 지원하기 위해 노력하고 있습니다.

배포

새 기능:

• 이제 패키지된 앱은 DeploymentManager.Initialize API를 사용하여 Windows 앱 SDK 런타임 패키지를 강제로 배포할 수 있습니다.
• 부트스트래퍼 API에는 이제 향상된 유용성 및 문제 해결을 위한 새로운 옵션이 포함되어 있습니다. 자세한 내용은 외부 위치로 패키지된 앱에 Windows 앱 SDK 런타임을 사용하거나 부트스트랩 초기화 실패에 대한 패키지 되지 않은 풍부한 정보를 참조하세요.

알려진 제한 사항:

• 자체 포함 배포는 Windows 10, 1903 이상에서만 지원됩니다.

Windowing

USER32.dll ( Windows 및 메시지참조)에서 구현된 기능에 대한 더 쉬운 프로그래밍 액세스를 위해, 이 릴리스는 AppWindows 자체에서 해당 기능을 더 많이 제공합니다.

새 기능:

• 기존 창이 있는 앱은 AppWindow.ShowOnceWithRequestedStartupState를 호출하여 창 표시 방법을 보다 제어할 수 있습니다. 이는 ShowWindow(SW_SHOWDEFAULT)에 해당합니다.
• 앱은 창을 표시, 최소화 또는 복원하고 호출할 때 창을 활성화할지 여부를 지정할 수 있습니다.
• 이제 앱은 Win32 좌표에서 창의 클라이언트 영역 크기를 설정할 수 있습니다.
• Windows의 z-order 관리를 지원하기 위해 API를 추가했습니다.
• AppWindowTitleBar.ExtendsContentIntoTitleBar로 사용자 지정 제목 표시줄을 그리는 앱은 PreferredTitleBarHeight 옵션을 설정할 수 있습니다. 표준 높이 제목 표시줄 또는 대화형 콘텐츠를 위한 더 많은 공간을 제공하는 높이 제목 표시줄을 선택할 수 있습니다. 키가 큰 타이틀바를 사용하는 시기에 대한 조언은 유창한 디자인 가이드라인의 타이틀바를 참조하십시오.

알려진 제한 사항:

• 긴 제목 표시줄 지원은 Windows 11에서만 사용할 수 있습니다. 다른 사용자 지정 제목 표시줄 API와 함께 이 수준을 낮추기 위해 노력하고 있습니다.

WinUI 3(1.1.0-preview2)

수정된 문제:

• WebView2 SDK를 1020.46에서 1185.39로 업그레이드하여 C/C++ 런타임(CRT)이 설치되지 않은 경우 WebView2가 있는 C# 앱이 시작 시 충돌하는 문제를 해결했습니다.
• 일부 둥근 모서리가 단색이어야 할 때 그라데이션을 표시하는 문제를 해결했습니다. 자세한 내용은 GitHub의 문제 6076 & 문제 6194를 참조하세요.
• generic.xaml에서 업데이트된 스타일이 누락된 문제를 해결했습니다.
• ListView의 끝으로 스크롤할 때 앱이 충돌하는 레이아웃 주기 문제가 해결되었습니다. 자세한 내용은 Github의 문제 6218을 참조하세요.

성능

C# 애플리케이션에는 몇 가지 성능이 향상되었습니다. 자세한 내용은 C#/WinRT 1.6.1 릴리스 정보를 참조 하세요.

버전 1.1 미리 보기 1 (1.1.0-preview1)

버전 1.1을 위한 미리보기 채널의 첫 번째 릴리스입니다. 모든 미리보기 채널 기능을 지원합니다( 출시 채널별로 사용 가능한 기능참조).

Windows App SDK 1.0을 사용하는 기존 앱에서는 Nuget 패키지를 1.1.0-preview1으로 업데이트할 수 있습니다(Nuget 패키지 매니저를 사용하여 Visual Studio에 패키지를 설치하고 관리의 패키지 업데이트 섹션 참조). 또한 업데이트된 런타임 및 MSIX에 대한 최신 Windows 앱 SDK 다운로드를 참조하세요.

다음 섹션에서는 이 릴리스의 새로운 기능과 업데이트된 기능, 제한 사항 및 알려진 문제에 대해 설명합니다.

WinUI 3(1.1.0-preview1)

알려진 문제: 끌어서 놓기를 사용하는 경우 사용자가 요소를 삭제할 수 없습니다.

관리자 권한(관리자) 지원

Windows 앱 SDK 1.1 미리 보기 1을 사용하면 앱(WinUI 3 포함)을 관리자 권한으로 실행할 수 있습니다.

중요한 제한 사항:

• 현재 Windows 11에서만 사용할 수 있습니다. 하지만 이후 릴리스에서는 이 지원을 하향 조정하는 방안을 평가하고 있습니다.

알려진 문제:

• 끌어서 놓기 상호 작용 중에 요소를 끌 때 WinUI 3 앱이 충돌합니다.

자체 포함 배포

Windows 앱 SDK 1.1은 자체 포함 배포에 대한 지원을 도입합니다. Windows 앱 SDK 배포 개요에서는 프레임워크 종속 배포와 자체 포함 배포 간의 차이점과 시작하는 방법을 자세히 설명합니다.

알려진 문제:

• 패키지된 C++ 앱은 VCLibs에 대한 프레임워크 참조를 제거하는 자체 포함 .targets 파일의 버그를 해결하기 위해 아래를 프로젝트 파일의 맨 아래에 추가해야 합니다.

  <PropertyGroup>
      <IncludeGetResolvedSDKReferences>true</IncludeGetResolvedSDKReferences>
  </PropertyGroup>
  
  <Target Name="_RemoveFrameworkReferences"
      BeforeTargets="_ConvertItems;_CalculateInputsForGenerateCurrentProjectAppxManifest">
      <ItemGroup>
          <FrameworkSdkReference Remove="@(FrameworkSdkReference)" Condition="'%(FrameworkSdkReference.SDKName)' == 'Microsoft.WindowsAppRuntime.1.1-preview1'" />
      </ItemGroup>
  </Target>
  

• Windows 10, 1903 이상에서만 지원됩니다.

알림(1.1.0-preview1)

패키지된(외부 위치로 패키지된 앱 포함) 및 패키지되지 않은 앱의 개발자는 이제 Windows 알림을 보낼 수 있습니다.

새 기능:

• 패키지된 앱 및 패키지되지 않은 앱에 대한 앱 알림 지원 GitHub에 대한 전체 세부 정보
  • 개발자는 로컬 또는 자체 클라우드 서비스에서 알림 메시지라고도 하는 앱 알림을 보낼 수 있습니다.
• 패키지 및 포장 해제된 앱에 대한 푸시 알림을 지원합니다. GitHub에 대한 전체 세부 정보
  • 개발자는 자체 클라우드 서비스에서 원시 알림 또는 앱 알림을 보낼 수 있습니다.

제한 사항:

• 자체 포함으로 게시된 앱에는 푸시 알림 지원이 없을 수 있습니다. 푸시 알림 지원을 위해 검사 IsSupported API에 대한 다음 미리 보기 릴리스에서 주의해야 합니다.
• 패키지되지 않은 앱 보내기 앱 알림은 콘솔 애플리케이션이 아닌 한 앱 알림에 앱 아이콘이 표시되지 않습니다. 패키지되지 않은 콘솔 앱은 ToastNotificationsDemoApp 샘플에 표시된 패턴을 따라야 합니다.
• 푸시 알림을 지원하려면 Windows 앱 SDK 런타임을 설치해야 합니다. 설치 관리자에 대한 최신 Windows 앱 SDK 다운로드를 참조하세요.
• 실행되지 않는 WinUI 3 앱은 알림을 통해 백그라운드로 활성화할 수 없습니다. 하지만 향후 릴리스에서는 이를 지원하기 위해 노력하고 있습니다.

환경 관리자(1.1.0-preview1)

개발자가 레지스트리 API를 직접 사용하지 않고도 환경 변수를 추가, 제거 및 수정할 수 있는 API 집합입니다.

새 기능:

• 환경 관리자를 사용한 앱을 제거할 때 변경되는 환경 변수를 자동으로 제거합니다.

제한 사항:

• 현재 C# 앱에서 사용할 수 없습니다. 하지만 이후 릴리스에서는 이 기능을 C# 앱으로 가져오는 방법을 평가하고 있습니다.

기타 제한 사항 및 알려진 문제

• 1.1.0 미리 보기 1에서 C#을 사용하는 경우 최소한 .NET SDK 6.0.201, 6.0.103, 5.0.212 또는 5.0.406 중 하나를 사용해야 합니다. .NET SDK를 업그레이드하려면 최신 버전의 Visual Studio로 업데이트하거나 .NET 다운로드를 방문하세요.

관련 항목

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