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

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:

• Caso queira atualizar um aplicativo existente de uma versão mais antiga do SDK do Aplicativo Windows para uma versão mais recente, confira Atualizar projetos existentes para a versão mais recente do SDK do Aplicativo Windows.

Versão de canal estável mais recente:

• Notas sobre a versão de canal estável mais recente para o SDK de Aplicativo do Windows

Downloads para o SDK do Aplicativo Windows

Versão 0.8

A versão mais recente disponível da linhagem 0.8.x do canal estável do SDK do Aplicativo Windows é a versão 0.8.12.

Versão 0.8.12

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

Correções de bugs (0.8.12)

• Corrigido o problema em que os aplicativos com SwapChainPanel ou WebView2 falhavam de forma imprevisível devido a uma violação de acesso.

Versão 0.8.11

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

Correções de bugs (0.8.11)

• Correção da regressão, fazendo com que o evento de foco perdido seja acionado ao selecionar texto usando o mouse.

Versão 0.8.10

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

Correções de bugs (0.8.10)

• Corrigido os problemas que faziam com que os aplicativos falhassem às vezes durante uma operação de arrastar e soltar.

Versão 0.8.8

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

Correções de bugs (0.8.8)

• Correção de problemas de entrada por toque no TextBox em relação ao teclado virtual e à interação geral. Esses problemas também afetaram os atalhos de teclado. Para obter mais informações, consulte o problema 6291 no GitHub.
• Corrigido o problema em que uma janela do aplicativo às vezes era mostrada como inativa quando ativa.
• Corrigido o problema de desempenho causado pelo UIA (Automação da Interface do Usuário) em execução em processos externos.
• Corrigido o problema de estabilidade do aplicativo com a entrada da caneta.
• Corrigido o problema em que a renderização de ícones png em um menu é drasticamente atrasada devido ao UIA.

Versão 0.8.7

Esta é uma versão de manutenção do SDK do Aplicativo Windows que inclui várias atualizações de desempenho para aplicativos C#/.NET. Para atualizar para esta versão, referencie a versão mais recente do pacote do SDK do Windows. Para fazer isso, adicione a propriedade <WindowsSdkPackageVersion>10.0.<sdk_version>.24</WindowsSdkPackageVersion> ao arquivo .csproj com a versão do SDK que seu aplicativo está direcionando da propriedade TargetFramework. Por exemplo:

<Project Sdk="Microsoft.NET.Sdk">
   <PropertyGroup>
       <OutputType>WinExe</OutputType>
       <TargetFramework>net6.0-windows10.0.19041.0</TargetFramework>
       <TargetPlatformMinVersion>10.0.17763.0</TargetPlatformMinVersion>
       <WindowsSdkPackageVersion>10.0.19041.24</WindowsSdkPackageVersion>
   <PropertyGroup>
   ...

Esta versão da projeção do SDK do Windows estará disponível em uma próxima versão de manutenção do .NET 6. Depois que a atualização do SDK do .NET estiver disponível, remova a propriedade <WindowsSdkPackageVersion> do arquivo de projeto.

Se você não definir essa propriedade, visualizará um erro como: "Error: This version of Project Reunion requires WinRT.Runtime.dll version 1.6 or greater."

Versão 0.8.6

Esta é uma versão de manutenção do SDK do Aplicativo Windows que inclui várias melhorias de desempenho para aplicativos C#/.NET para a versão 0.8.0.

Para atualizar para esta versão do SDK do Aplicativo Windows, você precisará ter a atualização de dezembro do SDK do .NET mais recente instalada (confira Fazer download do .NET e o .NET 5 atingirá o fim do suporte em 10 de maio de 2022). Se você não tiver a versão mínima necessária do SDK do .NET instalada, verá um erro como "Error: This version of Project Reunion requires WinRT.Runtime.dll version 1.4 or greater."

Correções de bugs (0.8.6)

Para obter uma lista detalhada das melhorias de desempenho, confira as notas de versão do C#/WinRT 1.4.1.

Versão 0.8.5

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

Correções de bugs (0.8.5)

• Corrigido o problema que estava causando falha nos aplicativos da WinUI usando a entrada de ponteiro .
• Corrigido o problema que fazia com que os botões da barra de título (mínimo, máximo, fechar) não tivessem cantos arredondados em Windows 11.
• Corrigido o problema que fazia com que as opções de layout de redimensionamento não aparecessem ao passar o mouse sobre o botão maximizar/restaurar no Windows 11.
• Corrigido o problema que causava uma exceção de falha ao criar um objeto PointCollection . Para obter mais informações, confira o issue n.º 971 no GitHub.

As limitações e os problemas conhecidos da versão 0.8 também se aplicam à versão 0.8.5, a menos que marcados de outra forma na seção abaixo.

Versão 0.8.4

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

Correções de bugs (0.8.4)

• Correções para barras de título personalizadas para que o ContentDialog não as cubra e os botões da barra de título sejam arredondados.
• Correção de uma falha no processamento de imagens quando a escala de exibição é alterada.
• Corrige bugs de recorte em que a interface do usuário desaparece ou é recortada incorretamente

As limitações e os problemas conhecidos da versão 0.8 também se aplicam à versão 0.8.4, a menos que marcados de outra forma na seção abaixo.

Versão 0.8.3

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

Correções de bugs (0.8.3)

O foco do teclado estava sendo perdido quando uma janela foi minimizada e restaurada, exigindo um clique do mouse para restaurar o foco.

As limitações e os problemas conhecidos da versão 0.8 também se aplicam à versão 0.8.3, a menos que marcados de outra forma na seção abaixo.

Versão 0.8.2

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

Correções de bugs (0.8.2)

• O SDK do Aplicativo Windows e a WinUI 3 agora têm suporte no Visual Studio 2022 Versão Prévia 2 e posterior.
• Para os aplicativos do .NET, é possível receber o seguinte erro ao passar uma matriz de enumerações: Object contains non-primitive or non-blittable data.
• Gravar usando o painel de manuscrito dentro de uma caixa de texto causa uma falha
• Ícones/imagens sempre são carregados no valor de escala de 100% em vez de com base no valor de escala do monitor
• A coleta de lixo do EventSource<T> causa falha subsequente em cancelar a assinatura de manipuladores (confira o issue no GitHub para obter mais detalhes)
• Correção de segurança – confira CVE-2021-34533 para obter mais detalhes.
• SwapChainPanel.CompositionScaleChanged às vezes retornava valores incorretos de CompositionScale depois de alterar a escala de exibição

As limitações e os problemas conhecidos da versão 0.8 também se aplicam à versão 0.8.2, a menos que marcados de outra forma na seção abaixo.

Versão 0.8.1

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

Correções de bugs (0.8.1)

• O SDK do Aplicativo Windows não pode ser executado no build mais recente do Windows Insider
• Falha em EditableComboBox ao inserir um valor que não aparece na lista suspensa
• O WebView2 não permite que o usuário faça a guia depois que o foco tiver sido recebido
• O namespace Windows.Foundation.Metadata.DefaultOverload totalmente qualificado no código gerado pela WinUI para evitar ambiguidade de namespace
  • Isso corrige o bug n.º 5108.
• Correção de segurança – confira CVE-2021-34489 para obter mais detalhes.

As limitações e os problemas conhecidos da versão 0.8 também se aplicam à versão 0.8.1, a menos que marcados de outra forma na seção abaixo.

Versão 0.8.0 Estável

Novos recursos e atualizações

Esta versão dá suporte a todos os recursos estáveis do canal.

WinUI 3:

Esta versão inclui muitas Correções de bugs e estabilização aprimorada na WinUI 3. Essas são todas as novas alterações na WinUI 3 desde o lançamento da WinUI 3 – Project Reunion 0.5:

• O controle Dinâmico foi adicionado novamente e agora pode ser usado em qualquer aplicativo WinUI 3.

• Todas as Correções de bugs do Project Reunion v0.5.5, v0.5.6 e v0.5.7 estão incluídas nesta versão.

• Novas Correções de bugs, incluindo:

  • O aplicativo tinha uma falha quando o usuário clicava com o botão direito do mouse em TextBox
  • NavigationView causava falha na UWP, no Reunion 0.5 Versão Prévia
  • ProgressBar não mostra a diferença entre as opções Pausa e Erro
  • Falha no RichEditBox ao copiar/colar/alterar o estilo de texto
  • Os botões de legenda do Windows estão no local errado quando SetTitleBar não está definido ou está definido como nulo

  Para obter a lista completa de bugs abordados nesta versão, confira nosso repositório do GitHub.

• A API ColorHelper.ToDisplayName não está mais disponível.

• As seguintes tipos foram removidos:

  • Microsoft.Graphics.IGeometrySource2D
  • Microsoft.Graphics.IGeometrySource2DInterop

  Em vez disso, use Windows.Graphics.IGeometrySource2D e Windows.Graphics.IGeometrySource2DInterop.

• Todos os tipos no namespace Microsoft.System foram movidos para o namespace Microsoft.UI.Dispatching, incluindo a classe DispatcherQueue.

• A propriedade AcrylicBrush.BackgroundSource foi removida, pois HostBackdrop não há suporte como um BackgroundSource na WinUI 3.

Para obter mais informações sobre WinUI, consulte WinUI.

Para visualizar os controles e recursos da WinUI 3 em ação, clone e crie a Galeria de aplicativo WinUI 3 do GitHub ou fazer download do aplicativo no Microsoft Store.

Para começar a desenvolver com o WinUI, confira os seguintes artigos:

• Modelos da WinUI 3 no Visual Studio
• Criar seu primeiro projeto WinUI 3 (SDK do Aplicativo Windows)
• Compilar um aplicativo em C# do .NET com interoperabilidade do WinUI 3 e do Win32
• Referência de API da WinUI 3

DWriteCore:

Esta versão do DWriteCore inclui os seguintes recursos novos e atualizados. O DWriteCore é introduzido e descrito na visão geral de DWriteCore.

• DWriteCore agora tem suporte para sublinhado – confira IDWriteTextLayout::GetUnderline e IDWriteTextLayout::SetUnderline.
• Suporte para tachado — confira IDWriteTextLayout::GetStrikethrough e IDWriteTextLayout::SetStrikethrough.
• Suporte para texto vertical por meio de IDWriteTextLayout – confira Texto vertical.
• Todos os métodos das interfaces IDWriteTextAnalyzer e IDWriteTextAnalyzer1 são implementados.
• A função livre DWriteCoreCreateFactory cria um objeto de fábrica usado para a criação subsequente de objetos DWriteCore individuais.

Para referência de API DWriteCore e DirectWrite, confira a Referência de API do DWriteCore e Referência de API do DirectWrite.

MRTCore:

• A Ação de Build para recursos é definida automaticamente ao adicionar o recurso ao projeto, reduzindo a necessidade de configuração manual do projeto.

Limitações

• No momento, não há suporte para esta versão no Canal de Desenvolvimento do Programa Windows Insider. Isso foi corrigido na versão 0.8.1.

• Aplicativos da área de trabalho (área de trabalho C# ou C++): esta versão tem suporte apenas para uso em aplicativos da área de trabalho (C++ ou C#) empacotados usando o MSIX. Para usar o SDK do Aplicativo Windows em aplicativos de área de trabalho não empacotados, use o canal de versão experimental.

Problemas conhecidos

• As ferramentas da WinUI 3, como Árvore Visual Dinâmica, Live Explorador de Propriedades Dinâmicas e Recarga Dinâmica na versão 0.8 e posterior, exigem o Visual Studio 2019 16.11 Versão prévia 3 e posterior.

• Atualmente, os aplicativos que usam a WinUI 3 e o SDK do Aplicativo Windows 0.8 não podem usar bibliotecas de classes que usam o Project Reunion 0.5. Atualize as bibliotecas de classes para usar o SDK do Aplicativo Windows 0.8.

• 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 deve ser definido como 18362 ou posterior. Para obter mais informações, confira o issue n.º 921 do GitHub.

• Encontrar uma falha ao alternar com frequência entre o modo claro e escuro.

• Para aplicativos .NET, você pode receber o seguinte erro ao passar uma matriz de enumerações: Object contains non-primitive or non-blittable data. Isso foi corrigido na versão 0.8.2.

• Para aplicativos do .NET, atualmente não há como recusar a indexação de uma imagem como um recurso de aplicativo usando a interface do usuário do Visual Studio. Para contornar isso, adicione um Directory.Build.targets (confira Personalizar seu build – Visual Studio para obter instruções) ao projeto e remova as imagens da seguinte maneira:

  • Para remover imagens específicas (observe que o caminho relativo é necessário):

    <Project>
    <ItemGroup>
        <Content Remove="..\Bitmap1.bmp" />
    </ItemGroup>
    </Project>
    

    • Para remover imagens com base em metadados:

    <Project>
    <ItemGroup>
        <Content Remove="@(None->WithMetadataValue('Pack','true'))" />
    </ItemGroup>
    </Project>
    

    Uma correção para esse problema está planejada para uma versão futura – nesse ponto, as soluções alternativas acima não serão mais necessárias.

Tópicos relacionados

• Notas sobre a versão mais recente do canal de pré-visualização para o SDK de Aplicativo do Windows
• Notas sobre a versão do canal experimental mais recente para o SDK de Aplicativo do Windows
• Instalar ferramentas para o SDK do Aplicativo Windows
• Criar seu primeiro projeto WinUI 3 (SDK do Aplicativo Windows)
• Usar o SDK do Aplicativo do Windows em um projeto existente
• Visão geral da implantação