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

  • 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ões de canais experimentais:

Versão 1.5 Experimental (1.5.0-experimental2)

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

Correções de bug

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

  • Corrigido um problema que provocava falha na inicialização dos aplicativos ao usar um NavigationViewItem personalizado. Para obter mais informações, confira o issue n.º 8814 do GitHub.
  • Corrigido um problema do NavigationView em que o botão de reticências gerava um erro incorretamente. Para obter mais informações, confira o issue n.º 8380 do GitHub.
  • Corrigido um problema em que um SystemBackdrop não era renderizado corretamente em um aplicativo com várias janelas. Para obter mais informações, confira o issue n.º 8423 do GitHub.
  • Corrigido um problema de duplicação ao inserir no início de um ObservableCollection. Para obter mais informações, confira o issue n.º 8370 do GitHub.

Novas APIs

O 1.5-experimental2 inclui as seguintes novas APIs. Essas APIs não são experimentais, mas ainda não estão incluídas em uma versão de lançamento estável do 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

APIs experimentais adicionais

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

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

Versão 1.5 Experimental (1.5.0-experimental1)

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

Novas APIs

O 1.5-experimental1 inclui as APIs novas a seguir. Essas APIs não são experimentais, mas ainda não estão incluídas em uma versão de lançamento estável do WinAppSDK.

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

APIs experimentais adicionais

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

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

Versão 1.4 Experimental (1.4.0-experimental1)

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

Correções de bug

Esta versão contém correções diversas, incluindo o seguinte:

  • Corrigido um problema em que a habilitação do contador de framerate de configurações de depuração em um novo aplicativo da área de trabalho do WinUI causava uma violação de acesso. Para obter mais informações, confira o issue n.º 2835 no GitHub.
  • Corrigido um problema em que a rolagem horizontal em um touchpad não funcionava em uma página da Web WebView2. Para obter mais informações, confira o issue n.º 7772 no GitHub.

APIs experimentais adicionais

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

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

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 as APIs do AppWindow diretamente de uma Janela por meio de Window.AppWindow. 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 bug

  • 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

Versão 1.2 Experimental (1.2.0-experimental2)

Esta é a versão mais recente do canal experimental. É compatível com todos os recursos de canal experimental e recursos da 1.2.0-preview 1.

Para fazer o download, redirecione sua versão NuGet do WinAppSDK para 1.2.220909.2-experimental2.

Problema corrigido

Nas próximas compilações do Windows Insider Preview, os aplicativos que usam o SDK do Aplicativo Windows falhariam ao iniciar.

Versão 1.2 Experimental (1.2.0-experimental1)

Esta é a versão mais recente do canal experimental. É compatível com todos os recursos de canal experimental.

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

Entrada e Composição

Introduzido pela primeira vez no SDK do Aplicativo Windows 0.8, há várias classes experimentais nos namespaces Microsoft.UI.Input.Experimental e Microsoft.UI.Composition.Experimental.

Novidades nesta versão:

Sumário

Novidade nesta versão, as classes experimentais no namespace Microsoft.UI.Content fornecem os blocos de construção de conteúdo interativo. Essas são primitivas de baixo nível que podem ser montadas em conteúdo para fornecer a experiência interativa para um usuário final. O conteúdo define a estrutura para: renderização de saída com animações, processamento de entrada em destinos diferentes, fornecimento de representação de acessibilidade e manipulação de alterações de estado do host.

APIs importantes:

  • ContentIsland: reúne saída, entrada e acessibilidade e fornece a abstração para conteúdo interativo. Uma árvore visual personalizada pode ser criada e interativa com essas APIs.
  • DesktopChildSiteBridge: permite que um ContentIsland seja conectado a uma hierarquia baseada em HWND.

Para obter mais informações, confira a amostra completa no GitHub.

Expedição

DispatcherQueue agora é despachado como reentrante. Anteriormente, não mais do que um único retorno de chamada DispatcherQueueHandler podia estar ativo em um único thread de cada vez. Agora, se um manipulador iniciar uma bomba de mensagem aninhada, retornos de chamada adicionais serão despachados como reentrantes. Isso corresponde ao comportamento do Win32 em torno de mensagens de janela e bombas de mensagens aninhadas.

Notifications

O registro do nome de exibição e do ícone do aplicativo para notificação do aplicativo agora é compatível. Confira as especificações no GitHub para obter informações adicionais.

WinUI 3

  • Controles e estilos estão atualizados com a versão WinUI 2.8.
  • A UWP não é mais compatível com as versões experimentais.

Outras limitações e problemas conhecidos

  • Os aplicativos precisam ser recriados após a atualização para o SDK do Aplicativo Windows 1.2-experimental1 devido a uma alteração interruptiva introduzida na ABI.
  • Os aplicativos que fazem referência a um pacote que depende do WebView2 (como Microsoft.Identity.Client) não são compilados. Isso é causado por binários conflitantes no momento da compilação. Para obter mais informações, confira o issue n.º 2492 no GitHub.
  • Usar dotnet build com um projeto de biblioteca de classes C# do WinAppSDK pode visualizar um erro de build "A tarefa Microsoft.Build.Packaging.Pri.Tasks.ExpandPriContent não pôde ser carregada". Para resolver esse problema definido <EnableMsixTooling>true</EnableMsixTooling> no arquivo de projeto.
  • Os modelos padrão do WinAppSDK observam que o MaxVersionTested="10.0.19041.0" quando deveria ser "10.0.22000.0". Para obter suporte completo de alguns recursos, notadamente UnlockedDEHs, atualize o MaxVersionTested para "10.0.22000.0" no arquivo de projeto.

Versão 1.0 Experimental (1.0.0-experimental1)

Esta versão é compatível com todos os recursos do canal experimental.

Download

As seções a seguir descrevem os recursos novos e atualizados, as limitações e os problemas conhecidos para essa versão.

WinUI 3

Essa versão do WinUI 3 é focada na construção de novos recursos para 1.0 estável e correção de bugs.

  • Novos recursos: suporte para mostrar um ContentDialog por janela em vez de por thread.
  • Para obter a lista completa dos bugs abordados nessa versão, confira nosso repositório GitHub.
  • Amostras: para visualizar os controles e recursos do WinUI 3 em ação, clone e crie a Galeria de aplicativo do WinUI 3 do GitHub ou baixe o aplicativo na Microsoft Store.

Para obter mais informações ou para começar a desenvolver com o WinUI, confira:

Notificações por push (recurso experimental)

Esta versão apresenta uma API de notificações por push que pode ser usada por aplicativos para desktop empacotados com identidades baseadas no registro de aplicativo do Azure. Para usar esse recurso, crie uma conta em nossa versão prévia privada.

Limitações importantes:

  • As notificações por push só têm suporte em aplicativos empacotados do MSIX em execução no Windows 10 versão 2004 (build 19041) ou posteriores.
  • A Microsoft se reserva o direito de desabilitar ou revogar aplicativos de notificações por push durante a versão prévia privada.
  • A Microsoft não garante a confiabilidade ou a latência de notificações por push.
  • Durante a versão prévia privada, o volume de notificações por push é limitado a 1 milhão por mês.

Para obter mais informações, confira Notificações por push.

Janelas

Essa versão inclui atualizações para as APIs de janelas. Trata-se de um conjunto de APIs de janelas de alto nível, centradas na classe AppWindow, que permite cenários de janelas fáceis de usar que se integram bem à experiência do usuário do Windows e de outros aplicativos. Isso é semelhante, mas não igual, ao UWP AppWindow.

Limitações importantes:

  • Essa versão do AppWindow está atualmente disponível apenas para aplicativos Win32 (empacotados e não empacotados).
  • No momento, o SDK do Aplicativo Windows não fornece métodos para anexar conteúdo da estrutura da IU a um AppWindow; você está limitado a usar os métodos de acesso interop do HWND.
  • No momento, as APIs de janelas não funcionarão no Windows versão 1809 e 1903 para AMD64.

Para obter mais informações, confira Gerenciar janelas de aplicativos.

Implantação para aplicativos não empacotados

Essa versão introduz atualizações para o recurso de dependências dinâmicas, incluindo a API do bootstrapper.

Limitações importantes:

  • O recurso de dependências dinâmicas só é compatível com aplicativos não empacotados.
  • Não há suporte para chamadores elevados.

Para obter mais informações, confira os seguintes artigos:

Outras limitações e problemas conhecidos

  • Não há suporte para qualquer configuração da compilação de CPU: o SDK do Aplicativo Windows é escrito em código nativo e, portanto, não oferece suporte para qualquer configuração da compilação de CPU. Os modelos do WinUI 3 no Visual Studio só permitem compilações específicas da arquitetura. Ao adicionar o SDK do Aplicativo Windows a um aplicativo ou componente do .NET existente que seja compatível com qualquer CPU, especifique a arquitetura desejada: x86, x64 ou arm64.
  • Os aplicativos do .NET devem ter como destino o build 18362 ou posterior: o TFM deve ser definido como net6.0-windows10.0.18362 ou posterior e o projeto de empacotamento <TargetPlatformVersion> deve ser definido como 18362 ou posterior. Para obter mais informações, confira o issue conhecido no GitHub.
  • Os aplicativos C# que usam o 1.0 Experimental devem usar um dos seguintes SDKs do .NET:

Versão 0.8 Preview (0.8.0-preview)

Esta versão é compatível com todos os recursos do canal experimental.

Download

As seções a seguir descrevem os recursos novos e atualizados, as limitações e os problemas conhecidos para essa versão.

WinUI 3

Essa versão introduz correções de bugs críticos (incluindo aqueles corrigidos em versões de manutenção 0.5) e outras alterações para WinUI. Para obter uma lista completa, confira as notas sobre a versão do WinUI 3: SDK do Aplicativo Windows 0.8.

Ciclo de vida do aplicativo (recurso experimental)

Essa versão introduz recursos experimentais novos relacionados ao gerenciamento do ciclo de vida do aplicativo do seu aplicativo.

  • Todos os aplicativos (empacotados e não empacotados) podem usar GetActivatedEventArgs (embora os aplicativos empacotados já possam usar a implementação disso na plataforma).
  • Somente aplicativos não empacotados podem usar as funções RegisterForXXXActivation.
  • Os aplicativos para desktop empacotados podem usar a instância do ciclo de vida do aplicativo.

Para obter mais informações, confira instância de aplicativo e Ativação avançada.

Implantação para aplicativos não empacotados (recurso experimental)

Essa versão introduz recursos de implantação experimental novos para aplicativos não empacotados. Os aplicativos não empacotados agora podem assumir dinamicamente uma dependência dos pacotes de runtime do SDK do Aplicativo Windows para que você possa continuar usando seu programa MSI ou programa de instalação existente para implantação de aplicativos. Isso está disponível por meio dos seguintes recursos:

  • Instalador autônomo para SDK do Aplicativo Windows.
  • Agrupamento de pacotes MSIX que inclui funcionalidade de dependências dinâmicas.

Para obter mais informações, confira a Guia de implantação do SDK do Aplicativo Windows para aplicativos dependentes de estrutura empacotados com localização externa ou não empacotados.

DWriteCore

Essa versão adiciona os seguintes recursos:

  • Decorações de texto (sublinhado e tachado na API de layout de texto)
  • Layout de texto vertical
  • API de kerning de face de fonte
  • Suporte experimental para aplicativos não empacotados

Para mais informações, confira Renderizar texto com DWriteCore.

MRT Core

Essa versão adiciona os seguintes recursos:

  • A ação de criação de recursos agora é definida automaticamente, reduzindo a necessidade de configuração manual do projeto.
  • Suporte experimental para aplicativos não empacotados.

Para obter mais informações, confira Gerenciar recursos com o MRT Core.

Limitações e problemas conhecidos

  • Não há suporte para qualquer configuração da compilação de CPU: o SDK do Aplicativo Windows é escrito em código nativo e, portanto, não oferece suporte para qualquer configuração da compilação de CPU. Os modelos do WinUI 3 no Visual Studio só permitem compilações específicas da arquitetura. Ao adicionar o SDK do Aplicativo Windows a um aplicativo ou componente do .NET existente que seja compatível com qualquer CPU, especifique a arquitetura desejada: x86, x64 ou arm64.
  • Os aplicativos do .NET devem ter como destino o build 18362 ou posterior: o TFM deve ser definido como net6.0-windows10.0.18362 ou posterior e o projeto de empacotamento <TargetPlatformVersion> deve ser definido como 18362 ou posterior. Para obter mais informações, confira o issue conhecido no GitHub.

Exemplos

As amostras do SDK do Aplicativo Windows ainda não funcionam nessa versão. Amostras novas e atualizadas, incluindo exemplos que demonstram recursos novos, como a implantação de aplicativos não empacotados, estarão disponíveis em breve.