Partilhar via

Notas de versão do canal de visualização para o SDK do Aplicativo Windows 1.5

  • Artigo

Importante

O canal de preview não é compatível com o uso em ambientes de produção e os aplicativos que usam as versões de preview não podem ser publicados na Microsoft Store.

O canal de pré-visualização do SDK de Aplicativo do Windows com recursos de canal de pré-visualização nos últimos estágios de desenvolvimento. As versões de pré-visualização não incluem recursos experimentais e APIs, mas ainda podem estar sujeitas a alterações significativas antes da próxima versão estável.

Links importantes:

Versão de canal de pré-visualização mais recente:

Versão de canal estável mais recente:

Versão 1.5 Preview 1 (1.5.0-preview1)

Esta é a versão mais recente do canal de preview para a versão 1.5.

Em um SDK do Aplicativo Windows 1.4 existente (do canal estável), você pode atualizar seu pacote Nuget para 1.5.0-preview1 (confira a seção Atualizar um pacote em Instalar e gerenciar pacotes no Visual Studio usando o Gerenciador de Pacotes NuGet).

Para visualizar o runtime atualizado e o MSIX, confira Downloads para o SDK do Aplicativo Windows.

Atualizações de tempo de execução e desligamento de Ilhas XAML

  • Há uma distinção comportamental entre o WinAppSDK 1.4 e o WinAppSDK 1.5 para aplicativos baseados em Ilhas XAML quando a última janela Xaml é fechada em qualquer thread.
    • No WinAppSDK 1.4, o tempo de execução de XAML sempre sai do loop de eventos do thread quando a última janela Xaml em um thread é fechada.
    • No WinAppSDK 1.5:
      • Se seu aplicativo for da área de trabalho WinUI, o comportamento padrão ainda será igual ao do WinAppSDK 1.4.
      • Se você estiver usando Xaml para a API DesktopWindowXamlSource ("Ilhas XAML"), o comportamento padrão será que o Xaml não sairá automaticamente do loop de eventos do thread.
      • Nos dois modos, é possível alterar esse comportamento definindo a propriedade Application.DispatcherShutdownMode.
    • Para saber mais, consulte a documentação da propriedade Application.DispatcherShutdownMode quando disponível.
  • Há uma distinção comportamental entre o WinAppSDK 1.4 e o WinAppSDK 1.5 para aplicativos baseados em Ilhas XAML na vida útil do tempo de execução de XAML:
    • No WinAppSDK 1.4, o tempo de execução do Xaml será desligado em um thread se todos os objetos WindowsXamlManager e DesktopWindowXamlSource em certo thread forem fechados ou desligados, ou a execução DispatcherQueue nesse thread for encerrada (o tempo de execução do Xaml será desligado durante o estágio DispatcherQueue.FrameworkShutdownStarting).
    • No WinAppSDK 1.5, o tempo de execução do Xaml é desligado em um thread somente quando o DispatcherQueue em execução nesse thread é desligado (o tempo de execução do Xaml é desligado durante o estágio DispatcherQueue.FrameworkShutdownStarting).
    • Para obter mais informações, confira a documentação da classe WindowsXamlManager quando disponível.

Controle de mapas WinUI

A versão inicial do controle WinUI Maps já está disponível! Esse controle é das plataformas WebView2 e Azure Mapas, fornecendo os seguintes recursos:

  • Movimento panorâmico e ampliação com os botões do mapa ou toque.
  • Alterar o estilo do mapa para exibição de satélite, terreno ou rua.
  • Adicionando programaticamente pinos interativos com ícones personalizáveis pelo desenvolvedor ao mapa.
  • Personalização do desenvolvedor para onde o mapa está centrado na carga inicial.
  • Controle para desenvolvedores sobre ocultar ou mostrar os botões para movimento panorâmico, ampliação e estilos de mapa.

Observação

Para usar o controle Maps, você precisará de uma chave do Azure Mapas. Para criar a chave, consulte a página de documentação do Azure Mapas para criar um aplicativo Web.

O controle Maps é totalmente novo e agradecemos seus comentários para avaliar a direção futura!

Outros recursos novos do WinAppSDK

Correções de bugs

  • Corrigido um problema da versão 1.5-experimental2 em que a DLL de projeção não era gerada. Para obter mais informações, confira o issue n.º 4152 do GitHub.
  • Problema corrigido em que o botão de reticências no pop-up de formatação de texto do RichEditBox não exibia a lista de ações devidamente. Para obter mais informações, confira o issue n.º 9140 do GitHub.
  • Problema corrigido em que ListView não tratava adequadamente aceleradores de teclado. Para saber mais, confira o problema n.º 8063 do GitHub.
  • Problema corrigido de violação de acesso com o uso de AccessKey para fechar uma janela. Para obter mais informações, confira o issue n.º 8648 do GitHub.
  • Problema corrigido que afetava o alinhamento de texto em um MenuFlyoutItem em um MenuBar. Para obter mais informações, confira o issue n.º 8755 do GitHub.
  • Problema corrigido em que o texto destacado não permanecia destacado ao clicar com o botão direito do mouse. Para obter mais informações, confira o issue n.º 1801 do GitHub.
  • Problema corrigido que levava janelas inativas a travar o aplicativo quando fechado. Para obter mais informações, confira o issue n.º 8913 do GitHub.
  • Problema corrigido que podia travar aplicativos ao rolar com o botão do meio do mouse e, logo depois, clicar com o botão esquerdo do mouse. Para obter mais informações, confira o issue n.º 9233 do GitHub.

Novas APIs na versão 1.5.0-preview1

A versão 1.5-preview1 inclui as seguintes novas APIs em comparação com a versão estável 1.4:

Microsoft.Graphics.DirectX
 
    DirectXPixelFormat
        A4B4G4R4

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

Microsoft.UI.Xaml
 
    Application
        DispatcherShutdownMode

    DebugSettings
        LayoutCycleDebugBreakLevel
        LayoutCycleTracingLevel

    DispatcherShutdownMode
    LayoutCycleDebugBreakLevel
    LayoutCycleTracingLevel

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

Microsoft.UI.Xaml.Hosting
 
    WindowsXamlManager
        GetForCurrentThread
        XamlShutdownCompletedOnThread
 
    XamlShutdownCompletedOnThreadEventArgs

Microsoft.Web.WebView2.Core
 
    CoreWebView2
        FrameId

    CoreWebView2AcceleratorKeyPressedEventArgs
        IsBrowserAcceleratorKeyEnabled

    CoreWebView2BrowserExtension
    CoreWebView2BrowsingDataKinds
        ServiceWorkers

    CoreWebView2CustomSchemeRegistration
        CoreWebView2CustomSchemeRegistration (String)
        AllowedOrigins
        SchemeName

    CoreWebView2Environment
        GetProcessExtendedInfosAsync

    CoreWebView2EnvironmentOptions
        AreBrowserExtensionsEnabled
        CustomSchemeRegistrations

    CoreWebView2Frame
        FrameId

    CoreWebView2FrameInfo
        FrameId
        FrameKind
        ParentFrameInfo

    CoreWebView2FrameKind
    CoreWebView2MouseEventKind
        NonClientRightButtonDown
        NonClientRightButtonUp

    CoreWebView2NavigationKind
    CoreWebView2NavigationStartingEventArgs
        NavigationKind

    CoreWebView2NewWindowRequestedEventArgs
        OriginalSourceFrameInfo

    CoreWebView2ProcessExtendedInfo
    CoreWebView2Profile
        AddBrowserExtensionAsync
        Delete
        Deleted

Microsoft.Windows.Management.Deployment
 
    AddPackageOptions
    EnsureReadyOptions
    PackageDeploymentContract
    PackageDeploymentManager
    PackageDeploymentProgress
    PackageDeploymentProgressStatus
    PackageDeploymentResult
    PackageDeploymentStatus
    PackageRuntimeManager
    PackageSet
    PackageSetItem
    PackageSetItemRuntimeDisposition
    PackageSetRuntimeDisposition
    PackageVolume
    ProvisionPackageOptions
    RegisterPackageOptions
    RemovePackageOptions
    StagePackageOptions
    StubPackageOption

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