Notas de versão mais recentes do canal experimental para o SDK de aplicações do Windows

Importante

O canal experimental não tem suporte para uso em ambientes de produção, e os aplicativos que usam as versões experimentais não podem ser publicados na Microsoft Store.

O canal experimental inclui lançamentos do SDK de Aplicativos Windows com funcionalidades do canal experimental em estágios iniciais de desenvolvimento. As APIs para recursos experimentais têm o atributo Experimental. Se você chamar uma API experimental em seu código, receberá um aviso em tempo de compilação. Todas as APIs no canal experimental estão sujeitas a extensas revisões e mudanças disruptivas. Recursos experimentais e APIs podem ser removidos de versões subsequentes a qualquer momento.

Ligações importantes:

• Se pretender atualizar uma aplicação existente de uma versão mais antiga do SDK de Aplicações Windows para uma versão mais recente, consulte Atualizar projetos existentes para a versão mais recente do SDK de Aplicações Windows.
• Para obter documentação sobre versões experimentais, consulte Ferramentas de instalação para visualização e canais experimentais do SDK de aplicativos Windows.

Arquivo de notas de lançamento do canal experimental:

• Notas de lançamento da versão experimental do Windows App SDK 1.6
• Notas sobre a versão do canal experimental para o Windows App SDK 1.5
• Notas de versão do canal experimental do Windows App SDK 1.4
• Notas de versão do canal experimental para o Windows App SDK 1.3
• Notas de lançamento do canal experimental para o Windows App SDK 1.2
• Notas de versão do canal experimental para o Windows App SDK 1.0
• Notas de versão do canal experimental para o Windows App SDK 0.8

Versão 1.7 Experimental (1.7.0-experimental2)

Registro de tarefas em segundo plano

Uma nova API BackgroundTaskBuilder permite registrar tarefas em segundo plano para aplicativos do SDK de aplicativos do Windows. Para obter mais informações, consulte GitHub #4831.

Novos recursos de notificações

O novo suporte de notificação de emblemas permite mostrar um número ou um ícone de glifo no seu aplicativo, na barra de tarefas. Para obter mais informações, consulte GitHub #4926.

Importante

Nesta versão, as projeções C# estão faltando para as novas APIs BadgeNotifications, o que impede o uso delas a partir do C#. As APIs estão disponíveis em C++.

As chamadas de vídeo ou áudio podem ter uma experiência de utilizador melhorada nas notificações. Para obter mais informações, consulte GitHub #4783.

Importante

Esta funcionalidade só está disponível nas versões mais recentes do Windows Insider do Windows.

Outras mudanças notáveis

• RichEditBox agora suporta o modo de matemática, via RichEditTextDocument.SetMathMode e RichEditTextDocument.SetMath.
• O novo suporte a CompatibilityOptions permitirá mais controlo sobre como as alterações de serviço afetam as apps. Para obter mais informações, consulte GitHub #4976.

Novas APIs

Esta versão inclui as seguintes APIs experimentais novas e modificadas:

Microsoft.Security.Authentication.OAuth

    AuthFailure
    AuthRequestParams
    AuthRequestResult
    AuthResponse
    ClientAuthentication
    CodeChallengeMethodKind
    OAuth2Manager
    OAuthContract
    TokenFailure
    TokenFailureKind
    TokenRequestParams
    TokenRequestResult
    TokenResponse

Microsoft.UI.Composition

    CompositionNotificationDeferral
    CompositionProjectedShadow
        MaxOpacity
        MinOpacity
        OpacityFalloff

    CompositionProjectedShadowCaster
        AncestorClip
        Mask

    CompositionProjectedShadowDrawOrder
    CompositionProjectedShadowReceiver
        DrawOrder
        Mask

Microsoft.UI.Composition.Experimental

    ExpCompositionVisualSurface
    ExpExpressionNotificationProperty
    IExpCompositionPropertyChanged
    IExpCompositionPropertyChangedListener
    IExpCompositor
    IExpVisual

Microsoft.UI.Content

    AutomationTreeOptions
    ChildSiteLink
    ContentAppWindowBridge
    ContentDisplayOrientations
    ContentEnvironmentStateChangedEventArgs
        DidDisplayScaleChange

    ContentExternalBackdropLink
    ContentExternalOutputLink
    ContentIsland
        AutomationTreeOption
        Children
        Connected
        ConnectionInfo
        ConnectRemoteEndpoint
        CreateForSystemVisual
        Disconnected
        FindAllForSystemCompositor
        FragmentRootAutomationProvider
        GetBySystemVisual
        InputCapabilities
        IsRemoteEndpointConnected
        LocalToClientTransformMatrix
        LocalToParentTransformMatrix
        NextSiblingAutomationProvider
        ParentAutomationProvider
        Popups
        PreviousSiblingAutomationProvider
        Root

    ContentIslandEnvironment
        CurrentOrientation
        DisplayScale
        NativeOrientation
        ThemeChanged

    ContentIslandStateChangedEventArgs
        DidLocalToClientTransformMatrixChange
        DidLocalToParentTransformMatrixChange

    ContentSite
        InputCapabilities
        LocalToClientTransformMatrix
        LocalToParentTransformMatrix
        SetContentNodeParent
        TryGetAutomationProvider

    ContentSiteAutomationProviderRequestedEventArgs
    ContentSiteEnvironment
        CurrentOrientation
        DisplayScale
        NativeOrientation
        NotifyThemeChanged

    ContentSiteEnvironmentView
        DisplayScale

    ContentSiteView
        AutomationTreeOption
        InputCapabilities
        LocalToClientTransformMatrix
        LocalToParentTransformMatrix

    CoreWindowSiteBridge
    CoreWindowTopLevelWindowBridge
    DesktopChildSiteBridge
        AcceptRemoteEndpoint
        ConnectionInfo
        CreateWithDispatcherQueue
        IsRemoteEndpointConnected
        RemoteEndpointConnecting
        RemoteEndpointDisconnected
        RemoteEndpointRequestedStateChanged

    DesktopPopupSiteBridge
    DesktopSiteBridge
        TryCreatePopupSiteBridge

    EndpointConnectionEventArgs
    EndpointRequestedStateChangedEventArgs
    IContentIslandEndpointConnectionPrivate
    IContentNodeOwner
    IContentSiteAutomation
    IContentSiteBridgeEndpointConnectionPrivate
    IContentSiteInput
    IContentSiteLink
    IContentSiteLink2
    InputCapabilities
    PopupWindowSiteBridge
    ProcessStarter
    ReadOnlyDesktopSiteBridge
    SystemVisualSiteBridge

Microsoft.UI.Input

    InputFocusNavigationHost
        GetForSiteLink

    InputKeyboardSource
        GetForWindowId

    InputLayoutPolicy
    InputLightDismissAction
        GetForIsland

    InputPointerActivationBehavior
    InputPointerSource
        ActivationBehavior
        DirectManipulationHitTest
        GetForVisual
        GetForWindowId
        RemoveForVisual
        TouchHitTesting
        TrySetDeviceKinds

    ProximityEvaluation
    TouchHitTestingEventArgs

Microsoft.UI.Input.Experimental

    ExpInputSite
    ExpPointerPoint

Microsoft.UI.Text

    RichEditTextDocument
        GetMath
        SetMath
        SetMathMode

Microsoft.UI.Windowing

    AppWindow
        DefaultTitleBarShouldMatchAppModeTheme

    DisplayArea
        GetMetricsFromWindowId

Microsoft.UI.Xaml

    XamlIsland
    XamlRoot
        TryGetContentIsland

Microsoft.UI.Xaml.Automation.Peers

    AutomationEvents
        Notification

    InkCanvasAutomationPeer
    PagerControlAutomationPeer

Microsoft.UI.Xaml.Controls

    ContentDialogPlacement
        UnconstrainedPopup

    DoInkPresenterWork
    ElementFactory
    FlowLayout
    FlowLayoutAnchorInfo
    FlowLayoutLineAlignment
    FlowLayoutState
    IApplicationViewSpanningRects
    IndexPath
    InkCanvas
    ISelfPlayingAnimatedVisual
    ItemContainer
        CanUserInvoke
        CanUserInvokeProperty
        CanUserSelect
        CanUserSelectProperty
        ItemInvoked
        MultiSelectMode
        MultiSelectModeProperty

    ItemContainerInteractionTrigger
    ItemContainerInvokedEventArgs
    ItemContainerMultiSelectMode
    ItemContainerUserInvokeMode
    ItemContainerUserSelectMode
    LayoutPanel
    NumberBox
        InputScope
        InputScopeProperty
        TextAlignment
        TextAlignmentProperty

    PagerControl
    PagerControlButtonVisibility
    PagerControlDisplayMode
    PagerControlSelectedIndexChangedEventArgs
    PagerControlTemplateSettings
    ProgressRing
        DeterminateSource
        DeterminateSourceProperty
        IndeterminateSource
        IndeterminateSourceProperty

    RecyclePool
    RecyclingElementFactory
    ScrollingScrollStartingEventArgs
    ScrollingZoomStartingEventArgs
    ScrollView
        ScrollStarting
        ZoomStarting

    SelectionModel
    SelectionModelChildrenRequestedEventArgs
    SelectionModelSelectionChangedEventArgs
    SelectTemplateEventArgs
    StackLayout
        IsVirtualizationEnabled
        IsVirtualizationEnabledProperty

    StackLayoutState
    TitleBar
    TitleBarAutomationPeer
    TitleBarTemplateSettings
    UniformGridLayoutState

Microsoft.UI.Xaml.Controls.Primitives

    ScrollPresenter
        ScrollStarting
        ZoomStarting

Microsoft.Windows.ApplicationModel.Background

    BackgroundTaskBuilder
    BackgroundTaskContract

Microsoft.Windows.ApplicationModel.Background.UniversalBGTask

    Task

Microsoft.Windows.ApplicationModel.WindowsAppRuntime

    CompatibilityChange
    CompatibilityContract
    CompatibilityOptions
    DeploymentManager
        Repair

    DeploymentStatus
        PackageRepairFailed

    ReleaseInfo
    RuntimeInfo
    VersionInfoContract
    WindowsAppRuntimeVersion

Microsoft.Windows.AppNotifications

    AppNotification
        ConferencingConfig

    AppNotificationConferencingConfig

Microsoft.Windows.AppNotifications.Builder

    AppNotificationBuilder
        AddCameraPreview

    AppNotificationButton
        SetSettingStyle

    AppNotificationButtonSettingStyle

Microsoft.Windows.BadgeNotifications

    BadgeNotificationGlyph
    BadgeNotificationManager
    BadgeNotificationsContract

Microsoft.Windows.Media.Capture

    CameraCaptureUI
    CameraCaptureUIContract
    CameraCaptureUIMaxPhotoResolution
    CameraCaptureUIMaxVideoResolution
    CameraCaptureUIMode
    CameraCaptureUIPhotoCaptureSettings
    CameraCaptureUIPhotoFormat
    CameraCaptureUIVideoCaptureSettings
    CameraCaptureUIVideoFormat

Microsoft.Windows.Storage

    ApplicationData
        GetForUnpackaged

Versão 1.7 Experimental (1.7.0-experimental1)

Este é o último lançamento do canal experimental.

Para fazer o download, redirecione sua versão do WinAppSDK NuGet para 1.7.241114004-experimental1.

Nova API CameraCaptureUI

Uma nova API CameraCaptureUI facilita a captura de fotos e vídeos em seu aplicativo WinAppSDK. Para obter mais informações, consulte Problema do GitHub #4721.

Nova API de autenticação

Uma nova API OAuth2Manager fornece uma solução simplificada para autenticação da Web, oferecendo recursos OAuth 2.0 com paridade total de recursos em todas as plataformas Windows suportadas pelo WinAppSDK. Para obter mais informações, consulte Problema do GitHub #4772.

Suporte a novas tarefas em segundo plano

Uma nova API BackgroundTaskBuilder traz suporte integrado para registro de tarefas em segundo plano para seus aplicativos WinAppSDK. Para obter mais informações, consulte Problema do GitHub #4822.

Novas APIs para 1.7-experimental1

Esta versão inclui as seguintes APIs experimentais novas e modificadas:

Microsoft.Security.Authentication.OAuth

    AuthFailure
    AuthRequestParams
    AuthRequestResult
    AuthResponse
    ClientAuthentication
    CodeChallengeMethodKind
    OAuth2Manager
    OAuthContract
    TokenFailure
    TokenFailureKind
    TokenRequestParams
    TokenRequestResult
    TokenResponse

Microsoft.UI.Composition

    CompositionNotificationDeferral
    CompositionProjectedShadow
        MaxOpacity
        MinOpacity
        OpacityFalloff

    CompositionProjectedShadowCaster
        AncestorClip
        Mask

    CompositionProjectedShadowDrawOrder
    CompositionProjectedShadowReceiver
        DrawOrder
        Mask

Microsoft.UI.Composition.Experimental

    ExpCompositionVisualSurface
    ExpExpressionNotificationProperty
    IExpCompositionPropertyChanged
    IExpCompositionPropertyChangedListener
    IExpCompositor
    IExpVisual

Microsoft.UI.Content

    AutomationOptions
    ChildContentLink
    ContentAppWindowBridge
    ContentDisplayOrientations
    ContentEnvironmentStateChangedEventArgs
        DidDisplayScaleChange

    ContentExternalBackdropLink
    ContentExternalOutputLink
    ContentIsland
        Children
        Compositor
        Connected
        ConnectionInfo
        ConnectRemoteEndpoint
        Create
        Disconnected
        FindAllForCompositor
        FragmentRootAutomationProvider
        GetByVisual
        IsRemoteEndpointConnected
        NextSiblingAutomationProvider
        ParentAutomationProvider
        PreviousSiblingAutomationProvider
        Root
        TransformMatrix

    ContentIslandEnvironment
        AutomationOption
        CurrentOrientation
        DisplayScale
        NativeOrientation
        ThemeChanged

    ContentSite
        Compositor
        SetContentNodeParent
        SetIsInputPassThrough
        SiteVisual
        TransformMatrix
        TryGetAutomationProvider

    ContentSiteAutomationProviderRequestedEventArgs
    ContentSiteEnvironment
        CurrentOrientation
        DisplayScale
        NativeOrientation
        NotifyThemeChanged

    ContentSiteView
        TransformMatrix

    CoreWindowSiteBridge
    CoreWindowTopLevelWindowBridge
    DesktopChildSiteBridge
        AcceptRemoteEndpoint
        ConnectionInfo
        IsRemoteEndpointConnected
        RemoteEndpointConnecting
        RemoteEndpointDisconnected
        RemoteEndpointRequestedStateChanged

    DesktopSiteBridge
        TryCreatePopupSiteBridge

    EndpointConnectionEventArgs
    EndpointRequestedStateChangedEventArgs
    IContentIslandEndpointConnectionPrivate
    IContentLink
    IContentNodeOwner
    IContentSiteBridge2
    IContentSiteBridgeAutomation
    IContentSiteBridgeEndpointConnectionPrivate
    PopupWindowSiteBridge
    ProcessStarter
    ReadOnlyDesktopSiteBridge
    SystemVisualSiteBridge

Microsoft.UI.Input

    InputKeyboardSource
        GetForWindowId

    InputLayoutPolicy
    InputLightDismissAction
        GetForIsland

    InputPointerActivationBehavior
    InputPointerSource
        ActivationBehavior
        DirectManipulationHitTest
        GetForVisual
        GetForWindowId
        RemoveForVisual
        TouchHitTesting
        TrySetDeviceKinds

    ProximityEvaluation
    TouchHitTestingEventArgs

Microsoft.UI.Input.Experimental

    ExpInputSite
    ExpPointerPoint

Microsoft.UI.Windowing

    AppWindow
        DefaultTitleBarShouldMatchAppModeTheme

    DisplayArea
        GetMetricsFromWindowId

Microsoft.UI.Xaml

    XamlIsland
    XamlRoot
        TryGetContentIsland

Microsoft.UI.Xaml.Automation.Peers

    AutomationEvents
        Notification

    InkCanvasAutomationPeer
    PagerControlAutomationPeer

Microsoft.UI.Xaml.Controls

    ContentDialogPlacement
        UnconstrainedPopup

    DoInkPresenterWork
    ElementFactory
    FlowLayout
    FlowLayoutAnchorInfo
    FlowLayoutLineAlignment
    FlowLayoutState
    IApplicationViewSpanningRects
    IndexPath
    InkCanvas
    ISelfPlayingAnimatedVisual
    ItemContainer
        CanUserInvoke
        CanUserInvokeProperty
        CanUserSelect
        CanUserSelectProperty
        ItemInvoked
        MultiSelectMode
        MultiSelectModeProperty

    ItemContainerInteractionTrigger
    ItemContainerInvokedEventArgs
    ItemContainerMultiSelectMode
    ItemContainerUserInvokeMode
    ItemContainerUserSelectMode
    LayoutPanel
    NumberBox
        InputScope
        InputScopeProperty
        TextAlignment
        TextAlignmentProperty

    PagerControl
    PagerControlButtonVisibility
    PagerControlDisplayMode
    PagerControlSelectedIndexChangedEventArgs
    PagerControlTemplateSettings
    ProgressRing
        DeterminateSource
        DeterminateSourceProperty
        IndeterminateSource
        IndeterminateSourceProperty

    RecyclePool
    RecyclingElementFactory
    ScrollingScrollStartingEventArgs
    ScrollingZoomStartingEventArgs
    ScrollView
        ScrollStarting
        ZoomStarting

    SelectionModel
    SelectionModelChildrenRequestedEventArgs
    SelectionModelSelectionChangedEventArgs
    SelectTemplateEventArgs
    StackLayout
        IsVirtualizationEnabled
        IsVirtualizationEnabledProperty

    StackLayoutState
    TitleBar
    TitleBarAutomationPeer
    TitleBarTemplateSettings
    UniformGridLayoutState

Microsoft.UI.Xaml.Controls.Primitives

    ScrollPresenter
        ScrollStarting
        ZoomStarting

Microsoft.Windows.ApplicationModel.Background

    BackgroundTaskBuilder
    BackgroundTaskContract

Microsoft.Windows.ApplicationModel.Background.UniversalBGTask

    Task

Microsoft.Windows.ApplicationModel.WindowsAppRuntime

    DeploymentManager
        Repair

    DeploymentStatus
        PackageRepairFailed

    ReleaseInfo
    RuntimeInfo
    VersionInfoContract

Microsoft.Windows.Media.Capture

    CameraCaptureUI
    CameraCaptureUIContract
    CameraCaptureUIMaxPhotoResolution
    CameraCaptureUIMaxVideoResolution
    CameraCaptureUIMode
    CameraCaptureUIPhotoCaptureSettings
    CameraCaptureUIPhotoFormat
    CameraCaptureUIVideoCaptureSettings
    CameraCaptureUIVideoFormat

Microsoft.Windows.Storage

    ApplicationData
        GetForUnpackaged

Correções de bugs

Esta versão inclui as seguintes correções de bugs:

• Alterado SplitButton para que a entrada por toque agora corresponda ao comportamento da entrada do mouse. Para obter mais informações, consulte Problema do GitHub #178.
• Menus em cascata alterados para que os submenus abram imediatamente quando clicados. Para obter mais informações, consulte Problema do GitHub #939.
• Corrigido um problema em que abrir um ComboBox que está num submenu fecha todos os submenus. Para obter mais informações, consulte Problema do GitHub #1467.
• Corrigido um problema em que SwipeControl falhava aleatoriamente num ListView. Para obter mais informações, consulte Problema do GitHub #2527.
• Corrigido um problema em que arrastar e soltar apenas um item ListViewItem o deixaria no estado visual errado. Para obter mais informações, consulte Problema do GitHub #3458.
• Corrigiu-se um problema no StackLayout para que respeite as propriedades ItemsRepeater.HorizontalAlignment e ItemsRepeater.VerticalAlignment (quando StackLayout.Orientation é respetivamente Vertical e Horizontal). O layout antigo se comportava como se o alinhamento ItemsRepeater fosse Stretch. Com a correção, o layout resulta em itens alinhados à direita quando o alinhamento à direita é usado, por exemplo. Para obter mais informações, consulte Problema do GitHub #3842.
• Corrigido um problema em que a exclusão de itens na origem do ItemsRepeaternão gerava itens que subiam para exibição. Para obter mais informações, consulte Problema do GitHub #6661.
• Corrigido um problema em que a tecla Alt direita não mostrava sugestões de teclas para Teclas de Acesso. Para obter mais informações, consulte Problema do GitHub #8447. Nota: Isso pode resultar em eventos-chave para a tecla Alt direita não sendo mais entregues para identificadores no aplicativo ou controles.
• Corrigida uma falha em que UniformGridLayout às vezes selecionava uma âncora de layout incorreta e causava passagens infinitas de layout ao recuar durante a rolagem. Para obter mais informações, consulte Problema do GitHub #9199.
• Corrigido um problema em que, ao configurar NavigationFailedEventArgs.Handled como True, mesmo assim lançava uma exceção. Para obter mais informações, consulte Problema do GitHub #9632.
• Corrigido um problema em que TabView não aplicava nenhum CornerRadiusespecificado. Para obter mais informações, consulte Problema do GitHub #9846.
• Corrigida uma possível falha de ciclo de layout no StackLayout. Para obter mais informações, consulte Problema do GitHub #9852.
• Corrigida uma possível falha no ItemsView ao remover itens. Para obter mais informações, consulte Problema do GitHub #9868.

Tópicos relacionados

• Canal estável
• Canal de visualização
• Instalar ferramentas para o SDK de aplicativos Windows
• Crie seu primeiro projeto WinUI 3
• Usar o SDK do Aplicativo Windows em um projeto existente
• Implantar aplicativos que usam o SDK de aplicativos do Windows