Partilhar via

Notas sobre a versão do canal experimental para o SDK do Aplicativo Windows 1.3

  • Artigo

Importante

O canal experimental não é compatível com o 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 fornece versões do SDK do Aplicativo Windows que incluem recursos experimentais do canal que estão em estágios iniciais de desenvolvimento. As APIs para recursos experimentais têm o atributo Experimental. Caso chame uma API experimental em seu código, você receberá um aviso no tempo de compilação. Todas as APIs no canal experimental podem ter alterações interruptivas em versões futuras, mas as APIs experimentais estão especialmente sujeitas a alterações. Os recursos experimentais podem ser removidos da próxima versão ou podem nunca ser lançados.

Links importantes:

Versão mais recente do canal experimental:

Versão de canal estável mais recente:

Versão 1.3 Experimental (1.3.0-experimental1)

Esta é a versão mais recente do canal experimental. Para fazer o download, redirecione sua versão NuGet do WinAppSDK para 1.3.230202101-experimental1.

APIs de pano de fundo do XAML

Com propriedades internas na janela do XAML, os cenários do Mica tela de fundo acrílico são mais fáceis de usar em seu aplicativo WinUI 3.

Consulte a especificação da API Xaml Backdrop no GitHub para obter mais informações sobre a propriedade Window.SystemBackdrop.

É importante notar que nesta versão você pode definir o pano de fundo apenas em code-behind, como abaixo. A configuração <Window.SystemBackdrop> na marcação resulta em um erro de compilação.

Além disso, as APIs de pano de fundo Xaml estão atualmente sem uma tag “experimental”, pois estão em desenvolvimento ativo.

public MainWindow()
{
    this.InitializeComponent();

    this.SystemBackdrop = new MicaBackdrop();
}

Window.AppWindow

Substituindo várias linhas de código clichê, agora você pode usar APIs do AppWindow diretamente de uma janela por meio Window.AppWindowdo . Consulte a especificação da API Window.AppWindow no GitHub para obter informações adicionais sobre a tela de fundo e o uso.

Novos recursos do WinAppSDK

  • ApplicationModel.DynamicDependency: PackageDependency.PackageGraphRevisionId que substitui o MddGetGenerationId preterido.
  • Gerenciador de ambientes: EnvironmentManager.AreChangesTracked para informar se as alterações no gerenciador de ambiente podem ser controladas em seu aplicativo. Consulte as especificações da API de Gerenciamento de Ambiente no GitHub para obter mais informações.
  • MRT Core: um novo evento, Application.ResourceManagerInitializing permite que seu aplicativo forneça sua própria implementação da interface IResourceManager e fornece acesso ao ResourceManager que o WinUI usa para resolver URIs de recursos.
  • Com o VSIX experimental mais recente, agora você pode converter seu aplicativo entre não empacotado e empacotado por meio do menu do Visual Studio em vez de no arquivo de projeto.
  • Um novo evento, DebugSettings.XamlResourceReferenceFailed agora é gerado quando uma pesquisa Estática/ThemeResource referenciada não pode ser resolvida. Esse evento fornece acesso a um rastreamento que detalha onde a estrutura pesquisou essa chave para permitir depurar melhor as falhas de pesquisa estáticas ThemeResource. Para obter mais informações, confira os issues 4972, 2350 e 6073 no GitHub.

Correções de bugs

  • Corrigidos os problemas com a entrada por toque que faziam com que o teclado virtual não aparecesse nas caixas de texto. Para obter mais informações, confira o issue n.º 6291 no GitHub.
  • Corrigido o problema que fazia com que um ItemsRepeater com um IElementFactory como seu ItemTemplate lançasse um ArgumentException. Consulte o issue n.º 4705 no GitHub para obter mais informações.

APIs experimentais adicionais

Esta versão também inclui várias APIs que estão em desenvolvimento inicial.

A lista abaixo detalha as APIs introduzidas nesta versão experimental que não planejamos enviar na versão estável 1.3.0.

**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