Notas sobre a versão do canal estável para o SDK do Aplicativo Windows 1.3

  • Artigo

O canal estável fornece versões do SDK do Aplicativo Windows com suporte para uso por aplicativos em ambientes de produção. Os aplicativos que usam a versão estável do SDK do Aplicativo Windows também podem ser publicados no Microsoft Store.

Links importantes:

Versão de canal estável mais recente:

Downloads para o SDK do Aplicativo Windows

Observação

As extensões do Visual Studio do SDK de Aplicativo do Windows (VSIX) não são mais distribuídas como um download separado. Elas estão disponíveis no Visual Studio Marketplace dentro do Visual Studio.

Versão 1.3.3 (1.3.230724000)

Essa é uma versão de manutenção do SDK do Aplicativo Windows que inclui correções importantes de bugs para a versão 1.3.

  • Foi corrigido um problema no qual o mouse às vezes parava de funcionar quando uma caixa de diálogo era fechada.
  • Corrigido um problema de implantação que impedia a instalação de aplicativos devido a uma incompatibilidade de versões de pacotes no sistema. Para obter mais informações, confira o issue n.º 3740 do GitHub.
  • Foi corrigido o problema que afetava o posicionamento do menu de contexto no SDK do Aplicativo Windows 1.3.
  • Corrigido um problema que fazia com que alguns aplicativos WinUI3, em algumas situações, falhassem quando o aplicativo era fechado porque o XAML se desligava muito cedo.
  • Foi corrigido um problema no qual os ícones de fonte não estavam sendo espelhados corretamente em idiomas da direita para a esquerda. Para obter mais informações, confira o issue n.º 7661 do GitHub.
  • Foi corrigido um problema que causava a falha de um aplicativo ao ser desligado quando os recursos ficavam inoperantes na ordem incorreta. Para obter mais informações, confira o issue n.º 7924 do GitHub.

Versão 1.3.2 (1.3.230602002)

Essa é uma versão de manutenção do SDK do Aplicativo Windows que inclui correções importantes de bugs para a versão 1.3.

  • Correção de uma falha ao definir um Cursor Protegido.
  • Correção de um problema de desempenho no XamlMetadataProvider durante a inicialização do aplicativo. Para obter mais informações, confira o issue n.º 8281 do GitHub.
  • Correção de um problema com hiperlinks e toque em um RichTextBlock. Para obter mais informações, confira o issue n.º 6513 do GitHub.
  • Correção de um problema com rolagem e touchpads no WebView2. Para obter mais informações, confira o issue n.º 7772 do GitHub.
  • Correção de um problema em que uma atualização de SDK do Aplicativo Windows às vezes exigia uma reinicialização do Visual Studio. Para obter mais informações, confira o issue n.º 3554 do GitHub.
  • Correção de uma exceção ruidosa no desligamento ao realizar a execução em um depurador.

Versão 1.3.1 (1.3.230502000)

Essa é uma versão de manutenção do SDK do Aplicativo Windows que inclui correções importantes de bugs para a versão 1.3.

  • Corrigido o problema que fazia com que os aplicativos falhassem ao definir o SystemBackdrop se o Conteúdo fosse nulo. Para obter mais informações, confira o issue n.º 8416 do GitHub.
  • Corrigido o problema que fazia com que os aplicativos falhassem ao definir o Título da janela no XAML, uma nova funcionalidade adicionada à versão 1.3.0. Para obter mais informações, confira o issue n.º 3689 do GitHub.
  • Corrigido o problema em que uma janela se concentrava incorretamente quando seu conteúdo era alterado.
  • Corrigido o problema com a criação de projetos C++ com os modelos de projeto do WinAppSDK 1.3.
  • Modelos atualizados no Visual Studio Marketplace

Recursos novos e atualizados e problemas conhecidos da versão 1.3

As seções a seguir descrevem recursos novos e atualizados e problemas conhecidos para a versão 1.3.

Em um aplicativo existente do SDK do Aplicativo Windows 1.2, é possível atualizar o pacote Nuget para 1.3.230331000 (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 mais recentes do SDK do Aplicativo Windows.

APIs de pano de fundo do XAML

Com propriedades incorporadas à janela XAML, os planos de fundo Mica e Background Acrylic são mais fáceis de usar em seu aplicativo WinUI 3. Confira os documentos de API de Pano de Fundo do Sistema e do Mica para obter mais informações sobre as propriedades do Cenário do XAML.

public MainWindow()
{
    this.InitializeComponent();

    this.SystemBackdrop = new MicaBackdrop();
}

Window.AppWindow

Ao substituir várias linhas de código clichê, agora você pode usar as APIs do AppWindow diretamente de uma Janela por meio de Window.AppWindow.

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.
  • 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 a especificação de API Rastrear falhas de pesquisa de referência de recurso XAML no GitHub.

Outras atualizações

Problema conhecido

Devido a uma alteração recente no compilador do XAML, um projeto existente que é atualizado para 1.3 pode sofrer um erro de build como o seguinte no Visual Studio:

> C:\Users\user\\.nuget\packages\microsoft.windowsappsdk\\**1.3.230331000**\buildTransitive\Microsoft.UI.Xaml.Markup.Compiler.interop.targets(537,17): error MSB4064: The "PrecompiledHeaderFile" parameter is not supported by the "CompileXaml" task loaded from assembly: Microsoft.UI.Xaml.Markup.Compiler, Version=1.0.0.0, Culture=neutral, PublicKeyToken=de31ebe4ad15742b from the path: C:\Users\user\\.nuget\packages\microsoft.windowsappsdk\\**1.2.230118.102**\tools\net472\Microsoft.UI.Xaml.Markup.Compiler.dll. Verify that the parameter exists on the task, the <UsingTask> points to the correct assembly, and it is a settable public instance property.

Isso é causado pelo Visual Studio usando uma DLL de tarefa do compilador do XAML armazenada em cache a partir da 1.2, mas conduzindo-a com lógica incompatível do MSBuild de 1.3, conforme conferido no texto de erro acima. A solução alternativa é desligar o Visual Studio, reiniciá-lo e refazer upload da solução.