Windows 앱 SDK에 대한 실험적 채널 릴리스 정보

아티클
04/01/2024

Important

실험적 채널은 프로덕션 환경에서 사용할 수 없으며 실험적 릴리스를 사용하는 앱은 Microsoft 스토어에 게시할 수 없습니다.

실험적 채널은 개발 초기 단계의 실험적 채널 기능을 포함하는 Windows 앱 SDK의 릴리스를 제공합니다. 실험적 기능에 대한 API에는 실험적 특성이 있습니다. 코드에서 실험적 API를 호출하는 경우 빌드 시간 경고가 표시됩니다. 실험적 채널의 모든 API는 이후 릴리스에서 호환성이 손상되는 변경이 있을 수 있지만 특히 실험적 API가 변경될 수 있습니다. 실험적 기능은 다음 릴리스에서 제거되거나 릴리스되지 않을 수 있습니다.

중요 링크:

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

실험적 채널 릴리스:

버전 1.5 실험적
버전 1.4 실험적
버전 1.3 실험적
버전 1.2 실험적
버전 1.0 실험적
버전 0.8 미리 보기

버전 1.5 실험적 (1.5.0-experimental2)

실험적 채널의 최신 릴리스입니다. 다운로드하려면 WinAppSDK NuGet 버전을 대상을 다시 지정합니다 1.5.240124002-experimental2.

버그 수정

이 릴리스에는 다음과 같은 버그 수정이 포함되어 있습니다:

사용자 지정 NavigationViewItem을 사용할 때 시작 시 앱이 충돌하는 문제를 해결했습니다. 자세한 내용은 GitHub문제 #8814을 참조하세요.
NavigationView 줄임표 단추가 오류를 잘못 생성하는 문제를 해결했습니다. 자세한 내용은 GitHub문제 #8380을 참조하세요.
다중 창 앱에서 제대로 렌더링되지 않는 문제를 해결 SystemBackdrop 했습니다. 자세한 내용은 GitHub문제 #8423을 참조하세요.
의 시작 부분에 삽입할 때 중복 문제가 해결되었습니다 ObservableCollection. 자세한 내용은 GitHub문제 #8370을 참조하세요.

새 API

1.5-experimental2에는 다음과 같은 새로운 API가 포함됩니다. 이러한 API는 실험적이지 않지만 WinAppSDK의 안정적인 릴리스 버전에는 아직 포함되지 않습니다.

Microsoft.Graphics.DirectX
 
    DirectXPixelFormat
        A4B4G4R4

Microsoft.UI.Xaml
 
    DebugSettings
        LayoutCycleDebugBreakLevel
        LayoutCycleTracingLevel
 
    LayoutCycleDebugBreakLevel
    LayoutCycleTracingLevel

Microsoft.UI.Xaml.Automation.Peers
 
    SelectorBarItemAutomationPeer

Microsoft.UI.Xaml.Controls
 
    MapControl
    MapControlMapServiceErrorOccurredEventArgs
    MapElement
    MapElementClickEventArgs
    MapElementsLayer
    MapIcon
    MapLayer
    SelectorBar
    SelectorBarItem
    SelectorBarSelectionChangedEventArgs
    WebView2
        EnsureCoreWebView2Async
        EnsureCoreWebView2Async

Microsoft.Windows.Management.Deployment
 
    EnsureReadyOptions
    PackageDeploymentManager
        AddPackageSetAsync
        DeprovisionPackageAsync
        DeprovisionPackageByUriAsync
        DeprovisionPackageSetAsync
        EnsurePackageReadyAsync
        EnsurePackageReadyByUriAsync
        EnsurePackageSetReadyAsync
        IsPackageReady
        IsPackageReadyByUri
        IsPackageRegistrationPending
        IsPackageRegistrationPendingForUser
        ProvisionPackageAsync
        ProvisionPackageByUriAsync
        ProvisionPackageSetAsync
        RegisterPackageAsync
        RegisterPackageByUriAsync
        RegisterPackageSetAsync
        RemovePackageByUriAsync
        RepairPackageAsync
        RepairPackageByUriAsync
        RepairPackageSetAsync
        ResetPackageAsync
        ResetPackageByUriAsync
        ResetPackageSetAsync
        StagePackageAsync
        StagePackageByUriAsync
        StagePackageSetAsync
 
    PackageDeploymentProgress
    PackageDeploymentResult
        Error
        ErrorText
 
    PackageSet
        Items
        PackageUri
 
    PackageVolume
        FindPackageVolumeByName
        FindPackageVolumeByPath
        FindPackageVolumes
        IsRepairNeeded
        Repair
 
    ProvisionPackageOptions
    RegisterPackageOptions
        DependencyPackageFamilyNames
 
    RemovePackageOptions
        FailIfNotFound

추가 실험적 API

이 릴리스에는 다음과 같은 새로운 실험적 API가 포함되어 있습니다.

Microsoft.UI.Xaml
 
    Application
        DispatcherShutdownMode
 
    DispatcherShutdownMode
    XamlIsland
        SystemBackdrop

Microsoft.UI.Xaml.Hosting
 
    WindowsXamlManager
        IsXamlRunningOnCurrentThread
        XamlShutdownCompletedOnThread
 
    XamlShutdownCompletedOnThreadEventArgs

Microsoft.Windows.System.Workloads
 
    IWorkloadHandler
    Workload
    WorkloadManager
    WorkloadProgress
    WorkloadProgressStatus
    WorkloadResult
    WorkloadsContract
    WorkloadStatus

버전 1.5 실험적(1.5.0-experimental1)

실험적 채널의 최신 릴리스입니다. 다운로드하려면 WinAppSDK NuGet 버전을 대상을 다시 지정합니다 1.5.231202003-experimental1.

새 API

1.5-experimental1에는 다음과 같은 새로운 API가 포함됩니다. 이러한 API는 실험적이지 않지만 WinAppSDK의 안정적인 릴리스 버전에는 아직 포함되지 않습니다.

Microsoft.Windows.Widgets.Feeds.Providers
    CustomQueryParametersRequestedArgs
    CustomQueryParametersUpdateOptions
    FeedDisabledArgs
    FeedEnabledArgs
    FeedManager
    FeedProviderDisabledArgs
    FeedProviderEnabledArgs
    FeedProviderInfo
    IFeedManager
    IFeedProvider

추가 실험적 API

이 릴리스에는 다음과 같은 새로운 실험적 API가 포함되어 있습니다.

Microsoft.UI.Content
 
    ContentIsland
        ConnectionInfo
        ConnectRemoteEndpoint
        IsRemoteEndpointConnected
 
    ContentIslandEnvironment
        CurrentOrientation
        DisplayScale
        NativeOrientation
        ThemeChanged
 
    ContentSiteEnvironment
        CurrentOrientation
        DisplayScale
        NativeOrientation
        NotifyThemeChanged
 
    DesktopChildSiteBridge
        AcceptRemoteEndpoint
        ConnectionInfo
        IsRemoteEndpointConnected
        RemoteEndpointConnecting
        RemoteEndpointDisconnected
        RemoteEndpointRequestedStateChanged
 
    EndpointConnectionEventArgs
    EndpointRequestedStateChangedEventArgs
    IContentIslandEndpointConnectionPrivate
    IContentSiteBridgeEndpointConnectionPrivate
    ProcessStarter
    SystemVisualSiteBridge
        IsClosed

Microsoft.UI.Input
 
    FocusNavigationReason
    FocusNavigationRequest
    FocusNavigationRequestEventArgs
    FocusNavigationResult
    InputFocusController
        DepartFocus
        NavigateFocusRequested
 
    InputFocusNavigationHost

Microsoft.UI.Xaml
 
    DebugSettings
        LayoutCycleDebugBreaks
        LayoutCycleTracing
 
    LayoutCycleDebugBreakLevel
    LayoutCycleTracingLevel
    XamlIsland

Microsoft.UI.Xaml.Controls
 
    SelectionModel
        SelectAllFlat

Microsoft.UI.Xaml.Core.Direct
 
    XamlPropertyIndex
        FlyoutBase_SystemBackdrop
        Popup_SystemBackdrop

Microsoft.Windows.Management.Deployment
 
    AddPackageOptions
    AddPackageSetOptions
    DeploymentPriority
    DeploymentProcessingModel
    EnsureIsReadyOptions
    FindPackageSetOptions
    PackageDeploymentContract
    PackageDeploymentManager
    PackageDeploymentProgress
    PackageDeploymentProgressStatus
    PackageDeploymentResult
    PackageDeploymentStatus
    PackageRuntimeManager
    PackageSet
    PackageSetItem
    PackageSetItemRuntimeDisposition
    PackageSetManager
    PackageSetRuntimeDisposition
    PackageVolume
    PackageVolumeManager
    PackageVolumeStatus
    RegisterPackageOptions
    RemovePackageOptions
    StagePackageOptions
    StubPackageOption

버전 1.4 실험적(1.4.0-experimental1)

실험적 채널의 최신 릴리스입니다. 다운로드하려면 WinAppSDK NuGet 버전을 대상을 다시 지정합니다 1.4.230518007-experimental1.

버그 수정

이 릴리스에는 다음을 포함한 기타 수정 사항이 포함되어 있습니다.

새 WinUI 데스크톱 애플리케이션에서 디버그 설정 프레임 전송률 카운터를 사용하도록 설정하면 액세스 위반이 발생하는 문제를 해결했습니다. 자세한 내용은 Github의 문제 2835을 참조하세요.
WebView2 웹 페이지에서 터치 패드의 가로 스크롤이 작동하지 않는 문제를 해결했습니다. 자세한 내용은 Github의 문제 7772을 참조하세요.

추가 실험적 API

이 릴리스에는 다음과 같은 새로운 실험적 API가 포함되어 있습니다.

Microsoft.UI

   IClosableNotifier

Microsoft.UI.Composition.SystemBackdrops

   DesktopAcrylicController
       Closed
       FrameworkClosed
       Kind

   DesktopAcrylicKind
   MicaController
       Closed
       FrameworkClosed

Microsoft.UI.Content

   ContentAppWindowBridge
       SettingChanged

   ContentEnvironmentSettingChangedEventArgs
   ContentExternalBackdropLink
   ContentExternalOutputLink
       ExternalOutputBorderMode

   ContentIsland
       FrameworkClosed

   ContentIslandWindow
       SettingChanged

   ContentSite
       FrameworkClosed

   ContentSiteWindow
       NotifySettingChanged
       SettingChanged

   CoreWindowTopLevelWindowBridge
       SettingChanged

   DesktopSiteBridge
       Closed
       FrameworkClosed

   IContentWindow
       SettingChanged

   SystemVisualSiteBridge
       Closed
       FrameworkClosed

Microsoft.UI.Input

   InputLayoutPolicy
   InputNonClientPointerSource
       ConfigurationChanged
       GetForWindowId

   NonClientRegionConfigurationChangedEventArgs

Microsoft.UI.System

   ThemeSettings

Microsoft.UI.Windowing

   DisplayArea
       GetMetricsFromWindowId

Microsoft.UI.Xaml

   XamlRoot
       ContentWindow

Microsoft.UI.Xaml.Controls

   ItemContainer
       Child
       ChildProperty

   ItemContainerMultiSelectMode
       Extended

   ItemsView
       Animator
       AnimatorProperty

   MenuFlyoutPresenter
       SystemBackdrop
       SystemBackdropProperty

   RiverFlowLayout
       InvalidateItemsInfo
       RequestedRangeCount
       RequestedRangeStartIndex

   RiverFlowLayoutElementAnimator

Microsoft.UI.Xaml.Controls.Primitives

   CommandBarFlyoutCommandBar
       SystemBackdrop
       SystemBackdropProperty

Microsoft.UI.Xaml.Input

   AccessKeyManager
       EnterDisplayMode

버전 1.3 실험적(1.3.0-experimental1)

실험적 채널의 최신 릴리스입니다. 다운로드하려면 WinAppSDK NuGet 버전을 대상을 다시 지정합니다 1.3.230202101-experimental1.

XAML 배경 API

XAML 창에 기본 제공된 속성을 사용하면 이제 WinUI 3 앱에서 Mica & Background Acrylic 배경을 더 쉽게 사용할 수 있습니다. 이 Windows.SystemBackdrop 속성에 대한 자세한 내용은 GitHub의 Xaml Backdrop API 사양를 참조하십시오.

이 릴리스에서는 아래와 같이 코드 숨김에서만 배경을 설정할 수 있습니다. 태그에서 설정 <Window.SystemBackdrop> 하면 컴파일 오류가 발생합니다. 또한 Xaml 배경 API는 현재 활성 개발 중이므로 '실험적' 태그가 누락되었습니다.

public MainWindow()
{
    this.InitializeComponent();

    this.SystemBackdrop = new MicaBackdrop();
}

Window.AppWindow

보일러 플레이트 코드의 여러 줄을 교체하면 이제 윈도우에서Window.AppWindow까지 앱윈도우 API를 직접 사용할 수 있습니다. 추가 배경 및 사용 정보는 GitHub의 Window.AppWindow API 사양 을 참조하세요.

WinAppSDK 전체의 새로운 기능

ApplicationModel.DynamicDependency: PackageDependency.PackageGraphRevisionId 사용되지 않는 MddGetGenerationId를 대체합니다.
환경 관리자: EnvironmentManager.AreChangesTracked 애플리케이션에서 환경 관리자의 변경 내용을 추적할 수 있는지 여부를 알려 줍니다. 자세한 내용은 GitHub의 Environment Manager API 사양 을 참조하십시오.
MRT Core: 새 이벤트로, Application.ResourceManagerInitializing 앱에서 자체 인터페이스 구현 IResourceManager 을 제공할 수 있으며, WinUI에서 리소스 URI를 확인하는 데 사용하는 ResourceManager에 액세스할 수 있습니다.
최신 실험적 VSIX를 사용하면 이제 프로젝트 파일 대신 Visual Studio 메뉴를 통해 패키지되지 않은 상태로 앱을 변환할 수 있습니다.
이제 참조된 Static/ThemeResource 조회를 확인할 수 없는 경우 새 이벤트가 발생 DebugSettings.XamlResourceReferenceFailed 합니다. 이 이벤트는 정적 & ThemeResource 조회 실패를 디버깅할 수 있도록 프레임워크에서 해당 키를 검색한 위치를 자세히 설명하는 추적에 액세스할 수 있도록 합니다. 자세한 내용은 GitHub의 이슈 4972, 2350 및 6073을 참조하십시오.

버그 수정

터치 입력으로 인해 소프트 키보드가 텍스트 상자에 표시되지 않는 문제가 해결되었습니다. 자세한 내용은 Github의 문제 6291을 참조하세요.
IElementFactory를 ItemTemplate으로 사용하여 ItemsRepeater가 ArgumentException을 throw하는 문제를 해결했습니다. 자세한 내용은 Github의 문제 4705을 참조하세요.

추가 실험적 API

이 릴리스에는 초기 개발 중인 여러 API도 포함되어 있습니다.

아래 목록에서는 1.3.0 안정적인 릴리스에서 출시할 계획이 없는 이 실험적 릴리스에 도입된 API에 대해 자세히 설명합니다.

**Microsoft.UI.Content**

    DesktopSiteBridge
        GetInputEnabledToRoot
        GetVisibleToRoot
        InputEnabled

**Microsoft.UI.Dispatching**

    DispatcherQueue
        FrameworkShutdownStarting

**Microsoft.UI.Input**

    InputLightDismissAction
        GetForIsland

    InputNonClientPointerSource
    InputPointerActivationBehavior
    InputPointerSource
        ActivationBehavior

    NonClientRegionCaptionTappedEventArgs
    NonClientRegionHoverEventArgs
    NonClientRegionKind

**Microsoft.UI.Input.DragDrop**

    DragDropManager
    DragDropModifiers
    DragInfo
    DragOperation
    DragUIContentMode
    DragUIOverride
    DropOperationTargetRequestedEventArgs
    IDropOperationTarget

**Microsoft.UI.Xaml.Automation.Peers**

    ItemContainerAutomationPeer
    ItemsViewAutomationPeer

**Microsoft.UI.Xaml.Controls**

    AnnotatedScrollBar
    AnnotatedScrollBarLabel
    AnnotatedScrollBarScrollEventArgs
    AnnotatedScrollBarScrollEventType
    AnnotatedScrollBarScrollOffsetRequestedEventArgs
    AnnotatedScrollBarSubLabelRequestedEventArgs
    AnnotatedScrollBarValueRequestedEventArgs
    ElementFactory
        GetElement
        GetElementCore
        RecycleElement
        RecycleElementCore

    IndexBasedLayoutOrientation
    ItemContainer
    ItemContainerInteractionTrigger
    ItemContainerInvokedEventArgs
    ItemContainerMultiSelectMode
    ItemContainerUserInvokeMode
    ItemContainerUserSelectMode
    ItemsView
    ItemsViewItemInvokedEventArgs
    ItemsViewItemInvokeMode
    ItemsViewSelectionMode
    Layout
        IndexBasedLayoutOrientation

    NonVirtualizingLayout
        IndexBasedLayoutOrientationCore

    RiverFlowLayout
    RiverFlowLayoutItemsInfoRequestedEventArgs
    RiverFlowLayoutItemsJustification
    RiverFlowLayoutItemsStretch
    VirtualizingLayout
        IndexBasedLayoutOrientationCore

    VirtualizingLayoutContext
        VisibleRect
        VisibleRectCore

**Microsoft.Graphics.Display**

    DisplayInformation
        AngularOffsetFromNativeOrientation
        DpiChanged
        OrientationChanged
        RawDpi
        RawPixelsPerViewPixel

    DisplayOrientation

**Microsoft.UI.Xaml.Hosting**

    DesktopWindowXamlSource
        CreateSiteBridge
        SiteBridge
        SystemBackdrop

버전 1.2 실험적 (1.2.0-experimental2)

실험적 채널의 최신 릴리스입니다. 1.2.0-preview 1의 모든 실험적 채널 기능 및 기능을 지원합니다.

다운로드하려면 WinAppSDK NuGet 버전을 대상을 다시 지정합니다 1.2.220909.2-experimental2.

해결된 문제

예정된 Windows Insider Preview 빌드에서는 Windows 앱 SDK 사용하는 애플리케이션이 시작되지 않습니다.

버전 1.2 실험적(1.2.0-experimental1)

실험적 채널의 최신 릴리스입니다. 이는 모든 실험적 채널 기능을 지원합니다.

다운로드하려면 WinAppSDK NuGet 버전을 대상을 다시 지정합니다 1.2.220727.1-experimental1.

입력 & 컴퍼지션

Windows 앱 SDK 0.8에서 처음 도입된 Microsoft.UI.Input.Experimental & Microsoft.UI.Composition.Experimental 네임스페이스에는 여러 실험 클래스가 있습니다.

이 릴리스의 새로운 기능:

InputPointerSource 에는 새 정적 팩터리 GetforWindowId가 있습니다.

콘텐츠

이 릴리스의 새로운 기능인 Microsoft.UI.Content 네임스페이스의 실험적 클래스는 대화형 콘텐츠의 구성 요소를 제공합니다. 이러한 기본 형식은 최종 사용자에게 대화형 환경을 제공하기 위해 콘텐츠로 어셈블할 수 있는 하위 수준 기본 형식입니다. 콘텐츠는 애니메이션으로 출력 렌더링, 다른 대상에 대한 입력 처리, 접근성 표현 제공, 호스트 상태 변경 처리 등의 구조를 정의합니다.

주목할 만한 API:

ContentIsland - 출력, 입력 및 접근성을 결합하고 대화형 콘텐츠에 대한 추상화 기능을 제공합니다. 이러한 API를 사용하여 사용자 지정 시각적 트리를 구성하고 대화형으로 만들 수 있습니다.
DesktopChildSiteBridge - HWND 기반 계층 구조에 연결할 수 있습니다 ContentIsland .

자세한 내용은 GitHub 의 샘플을 확인하세요.

디스패치

이제 DispatcherQueue 가 재진입자로 디스패치됩니다. 이전에는 단일 스레드에서 한 번에 하나의 DispatcherQueueHandler 콜백을 활성화할 수 없었습니다. 이제 처리기가 중첩된 메시지 펌프를 시작하면 추가 콜백이 재진입으로 디스패치됩니다. 이는 창 메시지 및 중첩된 메시지 펌프에 대한 Win32 동작과 일치합니다.

알림

이제 앱 알림에 대한 앱 표시 이름 및 아이콘 등록이 지원됩니다. 추가 정보는 GitHub의 사양을 확인하세요.

WinUI 3

컨트롤과 스타일은 WinUI 2.8 릴리스를 통해 최신 상태입니다.
UWP는 실험적 릴리스에서 더 이상 지원되지 않습니다.

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

ABI에 도입된 호환성이 손상되는 변경으로 인해 Windows 앱 SDK 1.2-experimental1로 업데이트한 후 앱을 다시 빌드해야 합니다.
WebView2(예: Microsoft.Identity.Client)에 의존하는 패키지를 참조하는 앱은 빌드에 실패합니다. 이는 빌드 시 충돌하는 이진 파일로 인해 발생합니다. 자세한 내용은 Github의 문제 2492 을 참조하세요.
WinAppSDK C# 클래스 라이브러리 프로젝트와 함께 dotnet build 사용하면 "Microsoft.Build.Packaging.Pri.Tasks.ExpandPriContent 작업을 로드할 수 없습니다."라는 빌드 오류가 표시될 수 있습니다. 프로젝트 파일에 설정된 <EnableMsixTooling>true</EnableMsixTooling> 이 문제를 해결하려면
기본 WinAppSDK 템플릿은 MaxVersionTested="10.0.19041.0"이면 "10.0.22000.0"이어야 합니다. 일부 기능( 특히 UnlockedDEHs)을 완전히 지원하려면 프로젝트 파일에서 MaxVersionTested를 "10.0.22000.0"으로 업데이트합니다.

버전 1.0 실험적(1.0.0-experimental1)

이 릴리스는 모든 실험적 채널 기능을 지원합니다.

다운로드

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

WinUI 3

이 WinUI 3 릴리스는 1.0 안정적 버전을 위한 새로운 기능을 구축하고 버그를 수정하는 데 중점을 두고 있습니다.

새 기능: ContentDialog를 스레드가 아닌 창별로 표시할 수 있습니다.
버그: 이 릴리스에서 해결된 버그의 전체 목록은 GitHub 리포지토리를 참조하세요.
샘플: WinUI 3 컨트롤 및 기능이 작동하는 것을 보려면 GitHub에서 WinUI 3 Gallery 앱을 복제 및 빌드하거나 Microsoft Store에서 앱을 다운로드할 수 있습니다.

자세한 내용을 보거나 WinUI를 사용하여 개발을 시작하려면 다음을 참조하세요.

푸시 알림(실험적 기능)

이번 릴리스에서는 애저 앱 등록 기반 ID로 패키지된 데스크톱 앱에서 사용할 수 있는 푸시 알림 API를 소개합니다. 이 기능을 사용하려면 프라이빗 미리 보기에 등록해야 합니다.

중요한 제한 사항:

푸시 알림은 Windows 10 버전 2004(빌드 19041) 이상 릴리스에서 실행되는 MSIX 패키지 앱에서만 지원됩니다.
Microsoft는 프라이빗 미리 보기 중에 푸시 알림에서 앱을 사용하지 않거나 취소할 수 있는 권한을 보유합니다.
Microsoft는 푸시 알림의 안정성이나 대기 시간을 보장하지 않습니다.
프라이빗 미리 보기 동안 푸시 알림 볼륨은 월 1백만 개로 제한됩니다.

자세한 내용은 푸시 알림을 참조하세요.

Windowing

이 릴리스에는 기간 이동 API에 대한 업데이트가 포함되어 있습니다. 이러한 API는 AppWindow 클래스를 중심으로 하는 상위 수준 기간 이동 API 집합으로, Windows 사용자 환경 및 기타 앱과 잘 통합되는, 사용하기 쉬운 기간 이동 시나리오를 허용합니다. 이는 UWP AppWindow와 비슷하지만 동일하지는 않습니다.

중요한 제한 사항:

이 AppWindow 릴리스는 현재 Win32 앱(패키징된 앱 및 패키징되지 않은 앱 모두)에서만 사용할 수 있습니다.
Windows 앱 SDK는 현재 UI 프레임워크 콘텐츠를 AppWindow에 연결하는 메서드를 제공하지 않습니다. HWND interop 액세스 메서드만 사용할 수 있습니다.
Windowing API는 현재 AMD64용 Windows 버전 1809 및 1903에서 작동하지 않습니다.

자세한 내용은 앱 창 관리를 참조하세요.

패키지되지 않은 앱 배포

이 릴리스에서는 부트스트래퍼 API를 포함하는 동적 종속성 기능에 대한 업데이트를 소개합니다.

중요한 제한 사항:

동적 종속성 기능은 패키지되지 않은 앱에 대해서만 지원됩니다.
관리자 권한 호출자는 지원되지 않습니다.

자세한 내용은 다음 문서를 참조하세요.

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

모든 CPU 빌드 구성 지원 안 됨: Windows 앱 SDK는 네이티브 코드로 작성되었으므로 모든 CPU 빌드 구성을 지원하지 않습니다. 이 Visual Studio 의 WinUI 3 템플릿은 아키텍처별 빌드만 허용합니다. 모든 CPU를 지원하는 기존 .NET 애플리케이션 또는 구성 요소에 Windows 앱 SDK를 추가할 때 원하는 아키텍처를 지정해야 합니다(x86, x64 또는 arm64).
.NET 앱은 빌드 18362 이상을 대상으로 해야 함: TFM을 18362 이상으로 설정해야 net6.0-windows10.0.18362 하며 패키징 프로젝트를 <TargetPlatformVersion> 18362 이상으로 설정해야 합니다. 자세한 내용은 GitHub의 알려진 문제를 참조하세요.
1.0 실험적 버전을 사용하는 C# 앱은 다음 .NET SDK 중 하나를 사용해야 합니다.
- .NET 6 SDK 이상( .NET 다운로드 및 .NET 5는 2022년 5월 10일에 지원 종료에 도달합니다참조).

버전 0.8 미리 보기(0.8.0-preview)

이 릴리스는 모든 실험적 채널 기능을 지원합니다.

다운로드

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

WinUI 3

이 릴리스에는 중요한 버그 수정(0.5 서비스 릴리스에서 수정된 버그 수정 포함) 및 WinUI에 대한 기타 변경 내용이 도입되었습니다. 전체 목록은 WinUI 3 - Windows 앱 SDK 0.8 릴리스 정보를 참조하세요.

앱 수명 주기(실험적 기능)

이 릴리스에서는 앱의 수명 주기 관리와 관련된 새로운 실험적 기능을 소개합니다.

모든 앱(패키징된 앱 및 패키징되지 않은 앱)은 GetActivatedEventArgs를 사용할 수 있습니다(패키징된 앱은 이미 플랫폼에서 이에 대한 구현을 사용할 수 있음).
패키징되지 않은 앱만 RegisterForXXXActivation 함수를 사용할 수 있습니다.
패키징된 데스크톱 앱은 앱 수명 주기 인스턴싱을 사용할 수 있습니다.

자세한 내용은 앱 인스턴싱 및 리치 활성화를 참조하세요.

패키징되지 않은 앱에 대한 배포(실험적 기능)

이 릴리스에서는 패키지되지 않은 앱에 대한 새로운 실험적 배포 기능을 소개합니다. 이제 패키징되지 않은 앱이 Windows 앱 SDK 런타임 패키지에 동적으로 종속되므로 기존 MSI 또는 설치 프로그램을 앱 배포에 계속 사용할 수 있습니다. 이는 다음 기능을 통해 사용할 수 있습니다.

Windows 앱 SDK용 독립 실행형 설치 관리자.
동적 종속성 기능을 포함하는 MSIX 패키지 번들.

자세한 내용은 외부 위치로 패키지화되거나 패키지화되지 않은 프레임워크 종속 앱에 대한 Windows App SDK 배포 가이드를 참조하십시오.

DWriteCore

이 릴리스에는 다음 기능이 추가되었습니다.

텍스트 장식(텍스트 레이아웃 API의 밑줄 및 취소선)
세로 텍스트 레이아웃
글꼴 커닝 API
패키징되지 않은 앱에 대한 실험적 지원

자세한 내용은 DWriteCore로 텍스트 렌더링을 참조하십시오.

MRT Core

이 릴리스에는 다음 기능이 추가되었습니다.

이제 리소스에 대한 빌드 작업이 자동으로 설정되므로 수동 프로젝트 구성의 필요성이 줄어듭니다.
패키징되지 않은 앱에 대한 실험적 지원.

자세한 내용은 MRT Core로 리소스 관리를 참조하세요.

제한 사항 및 알려진 문제

모든 CPU 빌드 구성 지원 안 됨: Windows 앱 SDK는 네이티브 코드로 작성되었으므로 모든 CPU 빌드 구성을 지원하지 않습니다. 이 Visual Studio 의 WinUI 3 템플릿은 아키텍처별 빌드만 허용합니다. 모든 CPU를 지원하는 기존 .NET 애플리케이션 또는 구성 요소에 Windows 앱 SDK를 추가할 때 원하는 아키텍처를 지정해야 합니다(x86, x64 또는 arm64).
.NET 앱은 빌드 18362 이상을 대상으로 해야 함: TFM을 18362 이상으로 설정해야 net6.0-windows10.0.18362 하며 패키징 프로젝트를 <TargetPlatformVersion> 18362 이상으로 설정해야 합니다. 자세한 내용은 GitHub의 알려진 문제를 참조하세요.

샘플

Windows 앱 SDK 샘플은 아직 이 릴리스에서 작동하지 않습니다. 패키징되지 않은 앱 배포와 같은 새로운 기능을 보여 주는 샘플을 포함한 새 샘플 및 업데이트된 샘플이 곧 제공될 예정입니다.

Windows 앱 SDK에 대한 실험적 채널 릴리스 정보

버전 1.5 실험적 (1.5.0-experimental2)

버그 수정

새 API

추가 실험적 API

버전 1.5 실험적(1.5.0-experimental1)

새 API

추가 실험적 API

버전 1.4 실험적(1.4.0-experimental1)

버그 수정

추가 실험적 API

버전 1.3 실험적(1.3.0-experimental1)

XAML 배경 API

Window.AppWindow

WinAppSDK 전체의 새로운 기능

버그 수정

추가 실험적 API

버전 1.2 실험적 (1.2.0-experimental2)

해결된 문제

버전 1.2 실험적(1.2.0-experimental1)

입력 & 컴퍼지션

콘텐츠

디스패치

알림

WinUI 3

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

버전 1.0 실험적(1.0.0-experimental1)

WinUI 3

푸시 알림(실험적 기능)

Windowing

패키지되지 않은 앱 배포

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

버전 0.8 미리 보기(0.8.0-preview)

WinUI 3

앱 수명 주기(실험적 기능)

패키징되지 않은 앱에 대한 배포(실험적 기능)

DWriteCore

MRT Core

제한 사항 및 알려진 문제

샘플

관련 항목

피드백

추가 리소스