O Windows Community Toolkit 8.2 é a versão estável atual do conjunto de controles, extensões e utilitários para desenvolvimento de aplicativos Windows. A edição mais recente dessa linha é a 8.2.251219, publicada em dezembro de 2025 com uma série de correções sobre a versão 8.2 original.
Entre as principais novidades da geração 8.2 estão o suporte a Native AOT, compatibilidade do UWP com .NET 9, o novo SwitchConverter, melhorias no SwitchPresenter e diversas correções para controles usados com WinUI 2, WinUI 3, Windows App SDK e Uno Platform.
O que é o Windows Community Toolkit?
O Windows Community Toolkit nasceu em 2016 como UWP Community Toolkit, com o objetivo de oferecer componentes reutilizáveis e exemplos que facilitassem o desenvolvimento de aplicativos para Windows.
Com a evolução da plataforma, o projeto deixou de ser limitado ao UWP e passou a atender outras tecnologias. Hoje, ele reúne controles, helpers e extensões destinados principalmente a desenvolvedores que trabalham com WinUI 2, WinUI 3 e Uno Platform.
O código é aberto, mantido no GitHub com participação da comunidade e faz parte do ecossistema da .NET Foundation.
A partir da versão 8, o desenvolvimento também migrou para um novo repositório, reunindo em uma única base componentes compatíveis com diferentes tecnologias Windows. O antigo repositório das versões 7.x foi posteriormente arquivado.
O que mudou no Windows Community Toolkit 8.2?
A primeira versão 8.2, identificada como 8.2.250402, trouxe mudanças mais significativas do que a atualização posterior de dezembro.
Os destaques são:
- suporte a Native AOT;
- suporte a UWP com .NET 9;
- novo
SwitchConverter; - melhorias no
SwitchPresenter; - melhorias para
AcrylicBrushno WinUI 3; - ajustes no
DispatcherQueueTimer.Debounce; - atualização das dependências;
- diversas correções de bugs e compatibilidade.
A Microsoft descreveu a versão 8.2 como uma atualização incremental, mas algumas das mudanças são especialmente relevantes para desenvolvedores que estão modernizando aplicativos Windows existentes.
Suporte a Native AOT
Uma das principais novidades é o suporte do Windows Community Toolkit ao Native AOT, ou compilação antecipada nativa, que permite que aplicações .NET sejam compiladas diretamente para código nativo antes da execução.
Dependendo do aplicativo, isso pode proporcionar benefícios como:
- inicialização mais rápida;
- redução do uso de memória;
- ausência da necessidade de compilação JIT durante a execução;
- melhores possibilidades de otimização para determinados cenários de distribuição.
Segundo a equipe responsável pelo Toolkit, a geração 8.2 passou a oferecer suporte a Native AOT nas plataformas atendidas pelo projeto.
É uma mudança particularmente importante para desenvolvedores que utilizam Windows App SDK e WinUI 3 ou estão modernizando projetos Windows baseados em .NET.
UWP agora pode ser usado com .NET 9
Outra mudança importante é o suporte do Windows Community Toolkit ao UWP utilizando .NET 9.
Historicamente, aplicativos UWP em C# dependiam fortemente da cadeia de ferramentas baseada no .NET Native. O suporte ao .NET moderno cria novas possibilidades para projetos existentes que ainda dependem da plataforma.
Na versão 8.2, o Toolkit passou oficialmente a acompanhar esse processo de modernização.
Desde então, o suporte do UWP ao .NET moderno também avançou. A documentação da Microsoft informa que o suporte deixou a fase experimental, com ferramentas atuais do Visual Studio oferecendo integração para UWP com versões modernas do .NET.
Isso pode facilitar a manutenção de aplicativos UWP existentes enquanto equipes avaliam uma eventual migração para Windows App SDK e WinUI 3.
Novo SwitchConverter
A versão 8.2 também introduziu o SwitchConverter.
Ele permite mapear diferentes valores para recursos ou objetos diretamente no XAML, reduzindo a necessidade de criar conversores personalizados para determinados cenários.
Um exemplo conceitual seria converter diferentes estados de uma aplicação:
Success→ cor de sucesso;Warning→ cor de alerta;Error→ cor de erro.
O SwitchConverter trabalha juntamente com objetos Case, tornando esse tipo de lógica declarativa mais simples dentro do XAML.
SwitchPresenter ficou mais flexível
O SwitchPresenter também recebeu uma mudança importante.
Anteriormente, seu conteúdo estava mais restrito a elementos de interface. A versão 8.2 passou a permitir objetos como conteúdo, de forma semelhante ao comportamento do ContentPresenter.
Na prática, isso permite cenários mais flexíveis envolvendo:
DataTemplate;- troca de dados conforme um valor;
- conteúdo baseado em estados;
- integração com
SwitchConverter.
A mudança amplia as possibilidades de criação de interfaces declarativas sem adicionar tanta lógica ao code-behind.
Dependências também foram atualizadas
A versão 8.2 atualizou componentes importantes utilizados internamente pelo Toolkit. Na versão original 8.2.250402, as dependências foram alinhadas, entre outras, com:
- Windows App SDK 1.6;
- Uno Platform 5.5;
- WinUI 2.8.7;
- versões atualizadas de XAML Behaviors e outras ferramentas.
Essas mudanças foram necessárias principalmente para corrigir problemas encontrados durante o desenvolvimento e ampliar a compatibilidade com .NET moderno e Native AOT.
O que mudou na atualização 8.2.251219?
A versão 8.2.251219 não representa uma nova geração do Toolkit. Ela é uma atualização incremental construída sobre a 8.2.250402. O foco está principalmente em correções:
Correções no controle Segmented
O controle Segmented recebeu várias correções, incluindo ajustes relacionados a:
- visibilidade de
SegmentedItem; - navegação usando a tecla de seta para a esquerda;
- raio dos cantos e elementos flutuantes;
- uma solução alternativa utilizada pelo próprio controle.
Esses ajustes corrigem comportamentos encontrados depois da chegada da primeira versão estável 8.2.
Melhorias de acessibilidade
A atualização também resolveu um problema de acessibilidade registrado no projeto.
Para aplicações Windows distribuídas a públicos amplos, correções dessa categoria são importantes porque afetam a experiência de usuários que dependem de tecnologias assistivas.
Correções no ColorPicker
O ColorPicker recebeu mais de uma correção.
Entre elas estão:
- uma solução alternativa relacionada ao AOT;
- correção de um problema envolvendo seu valor inicial.
Esses ajustes são particularmente relevantes para aplicativos compilados utilizando Native AOT.
BitmapIcon em cartões desativados
A atualização também alterou a aparência de BitmapIcon quando determinado cartão está desativado.
A opacidade do ícone agora é reduzida nesse estado, deixando visualmente mais clara a indisponibilidade da opção correspondente.
Correções no WrapPanel
O WrapPanel recebeu correções relacionadas à organização dos itens.
Entre os problemas tratados estão o comportamento de quebra para uma nova linha e o alongamento do último item.
Isso evita resultados inesperados ao criar layouts dinâmicos cujo conteúdo precisa se adaptar ao espaço disponível.
LayoutTransformControl e Native AOT
Também foi corrigido um problema que poderia provocar falhas envolvendo o LayoutTransformControl durante a publicação utilizando AOT.
A correção complementa o esforço iniciado na versão 8.2 para melhorar a compatibilidade do Toolkit com aplicativos compilados usando Native AOT.
Melhorias no Sizer
Os controles Sizer receberam nomes de recursos/chaves adicionais para facilitar a substituição e personalização de estilos.
A mudança é útil principalmente para desenvolvedores que precisam adaptar os componentes à identidade visual de seus aplicativos.
Mudanças de infraestrutura
A versão 8.2.251219 também recebeu alterações internas utilizadas no desenvolvimento e nos testes do próprio Windows Community Toolkit.
Entre elas estão:
- refatoração da geração de referências de projetos para incluir projetos de teste;
- atualização do Uno Behaviors para 3.0.3;
- mudanças na configuração utilizada pelo XAML Styler;
- adoção de executores Windows Server 2022 nos processos de integração contínua;
- atualização do
uno-check; - melhorias nos testes do
RichSuggestBox.
Essas alterações não necessariamente introduzem novos recursos visíveis aos usuários, mas ajudam a melhorar a qualidade e a confiabilidade das futuras versões do projeto.
E o Windows Community Toolkit 8.3?
A próxima geração já está sendo desenvolvida. No momento desta atualização, a versão mais recente disponibilizada para testes é a 8.3.260402-preview2.
Entre as mudanças dessa prévia está o suporte à nova estrutura de pacotes do Windows App SDK 1.8. Para projetos WinUI 3, o Windows Community Toolkit 8.3 passa a depender de Microsoft.WindowsAppSDK.WinUI em vez do pacote completo do Windows App SDK.
A equipe também alerta que aplicativos que pretendem utilizar essa versão do Toolkit precisam migrar para Windows App SDK 1.8. Quem ainda utiliza versões anteriores do Windows App SDK deve permanecer na linha 8.2.
Onde baixar o Windows Community Toolkit?
O Windows Community Toolkit pode ser adicionado a projetos através de seus respectivos pacotes NuGet.
A documentação oficial também disponibiliza instruções de instalação e uma Windows Community Toolkit Gallery, que permite visualizar controles e recursos disponíveis antes de incorporá-los ao aplicativo.
O desenvolvimento atual está disponível no repositório CommunityToolkit/Windows no GitHub. Desenvolvedores também podem abrir problemas, participar de discussões e contribuir diretamente com código para o projeto.
