Novidades do Flutter 3.29
Mais performance e fidelidade em todas as plataformas
Novidades do Flutter 3.29
Mais performance e fidelidade em todas as plataformas
Introdução
Mergulhe no Flutter 3.29! Esta versão aprimora o desenvolvimento e aumenta o desempenho, com atualizações no Impeller, Cupertino, DevTools e muito mais. Com 104 autores únicos contribuindo neste ciclo de lançamento, o Flutter 3.29 mostra a dedicação da comunidade. Vamos explorar as novidades!
Framework
Atualizações do Cupertino
CupertinoNavigationBar e CupertinoSliverNavigationBar agora aceitam um widget inferior, normalmente um campo de busca ou um segmented control.
Em um CupertinoSliverNavigationBar, esse widget inferior pode ser configurado com a propriedade bottomMode, para se redimensionar automaticamente até ficar oculto ou para ficar sempre visível quando a barra de navegação é rolada.
Outras mudanças nas barras de navegação incluem:
-
Quando parcialmente rolada,
CupertinoSliverNavigationBaralterna entre seus estados expandido e recolhido. -
Um novo construtor
CupertinoNavigationBar.largepermite que a barra de navegação estática exiba um título grande. -
Graças ao colaborador da comunidade davidhicks980, os popups do Cupertino agora têm desfoques de fundo mais vibrantes, o que melhora a fidelidade nativa.

-
O novo
CupertinoSheetRouteexibe uma folha modal no estilo iOS que pode ser removida com o gesto de arrastar para fechar. -
A nova função
showCupertinoSheetexibe a folha com uma configuração comum para navegação aninhada já incluída.

-
O membro da comunidade thejitenpatel melhorou a fidelidade nativa de
CupertinoAlertDialogno modo escuro, como mostram as capturas de tela a seguir:
- Quando invertidos, os handles de seleção de texto do Flutter trocam a ordem no iOS, e a cor da borda da lupa de seleção de texto agora corresponde ao tema atual.

Material
-
O
FadeForwardsPageTransitionsBuilderé o novo builder de transição de página do Material 3 (M3), projetado para corresponder ao comportamento mais recente de transição de página do Android. Durante a transição, a página que entra desliza da direita para a esquerda enquanto aparece gradualmente, e a página que sai desliza da direita para a esquerda enquanto desaparece ao mesmo tempo. Essa nova transição também resolve os problemas de desempenho que antes eram causados peloZoomPageTransitionsBuilder.

-
Esta versão atualiza o
CircularProgressIndicatore oLinearProgressIndicatorpara alinhar com as especificações mais recentes do Material Design 3. Para usar o estilo atualizado, defina a propriedadeyear2023comofalse, ou definaProgressIndicatorThemeData.year2023comofalse.


-
Esta versão também introduz o design mais recente do
Sliderdo Material 3, com formatos de trilha e de handle atualizados. OSliderusa o estilo anterior do Material 3 por padrão. Para ativar o design mais recente, definayear2023comofalse, ou definaSliderThemeData.year2023comofalse.

Esta versão inclui diversas correções de bugs e melhorias de recursos para a biblioteca Material. Correções notáveis incluem:
-
A navegação por teclado agora dispara corretamente o callback
DropdownMenu.onSelected. Animação elástica de abas aprimorada no
TabBar.-
Alinhamento do thumb no
RangeSlidercom as divisões, padding do thumb e cantos arredondados aprimorados.
Além das correções de bugs, esta versão aprimora a personalização de vários componentes Material. A propriedade mouseCursor foi adicionada a Chip, Tooltip e ReorderableListView, permitindo cursores de mouse personalizados ao passar o ponteiro.
Seleção de texto
Agora o Flutter oferece mais informações sobre a seleção sob um SelectionArea ou SelectableRegion
com SelectionListener
e SelectionListenerNotifier. O objeto SelectionDetails
, disponível por meio de SelectionListenerNotifier, fornece os offsets inicial e final da seleção (relativos à subárvore envolvida) e indica se existe uma seleção e se ela está colapsada. Para um widget ou subárvore selecionável que você queira observar, envolva-o com o widget SelectionListener.
O Flutter também informa o status de um SelectionArea ou SelectableRegion
por meio do inherited widget SelectableRegionSelectionStatusScope. Você pode verificar se um SelectionArea ou SelectableRegion
pai está alterando ativamente sua seleção ou já a finalizou, usando SelectableRegionSelectionStatusScope.maybeOf(context)
e verificando o SelectableRegionSelectionStatus.

Acessibilidade
Esta versão melhora a acessibilidade de vários widgets Material:
-
Quando um leitor de tela está ativado, o widget Form anuncia apenas o primeiro erro que encontra.
Um leitor de tela agora anuncia o rótulo correto para menus dropdown.
Web
Quando foi lançado inicialmente, em maio de 2024, o suporte ao WebAssembly (wasm) do Flutter na web exigia que você hospedasse suas aplicações Flutter com cabeçalhos especiais de resposta HTTP. Esse requisito foi flexibilizado. Embora atualizar os cabeçalhos permita que os apps Flutter web compilados com wasm rodem com múltiplas threads, usar os cabeçalhos padrão agora permite que o app rode com wasm, mas limitado a uma única thread.
Corrigimos vários problemas com imagens nos backends WebGL, mas os mais importantes são:
-
Decodificação de imagens de forma assíncrona, fora da thread da UI, para evitar jank
-
Fazer o Image.network funcionar com imagens CORS sem configuração extra
Engine
Estabilidade do Impeller Vulkan
Graças ao feedback e aos relatos de bugs das versões beta e stable do 3.27, foram feitas diversas melhorias de correção e desempenho no backend Vulkan, incluindo:
-
Corrigimos um flickering e um jitter visual reproduzíveis, que muitas pessoas relataram em dispositivos mais antigos com suporte a Vulkan.
-
Desativamos os swapchains de Android Hardware Buffer. Esse recurso foi colocado atrás de uma feature flag até que se determine que ele funciona corretamente em todos os dispositivos Android.
-
Um grande número de relatórios de tela preta e de falhas foi causado pelo uso do Vulkan em SoCs MediaTek/PowerVR, por isso ele foi desativado nesses dispositivos. Eles agora usam apenas o Impeller OpenGLES (veja abaixo).
Os emuladores Android foram atualizados para usar o backend Impeller GLES.
Impeller OpenGLES
No 3.29, dispositivos Android que não têm um driver Vulkan funcional passam a usar o Impeller rodando em OpenGLES, em vez do Skia. Esse comportamento vem habilitado por padrão e não precisa ser configurado. Com isso, o suporte ao Impeller no Android chega a 100% dos dispositivos Android suportados pelo Flutter.
Impeller no iOS
O suporte ao Skia foi removido do backend do iOS, e a flag FLTEnableImpeller de opt-out não funciona mais. Espera-se mais redução do tamanho do binário em versões futuras, à medida que começamos a remover componentes do Skia das builds para iOS.
Novos recursos
Este release traz vários novos recursos que aproveitam o backend Impeller.
Otimizações de backdrop filter
Aplicativos que exibem vários backdrop filters agora podem usar o novo widget BackdropGroup
e um novo construtor BackdropFilter.grouped. Eles podem melhorar o desempenho de múltiplos blurs além do que era possível no backend Skia. Para ver um exemplo, visite o código-fonte de
basic.dart
.
ImageFilter.shader
Um novo construtor ImageFilter permite aplicar um shader personalizado a qualquer widget filho. Isso oferece funcionalidade semelhante ao widget
AnimatedSampler do package:flutter_shaders, com a diferença de que também funciona com backdrop filters. Para ver um exemplo, visite o código-fonte de
painting.dart
.
Mudanças no threading do Dart no Android/iOS
Anteriormente, o Flutter executava o código Dart em uma thread diferente (a thread de UI) da thread principal da plataforma. Isso permitia maior throughput teórico quando ambas as threads estavam ocupadas, mas tinha o custo de tornar a maior parte da interoperação com a plataforma dependente de troca de mensagens serializada e assíncrona. Essa arquitetura também afetava a entrada de texto, a acessibilidade, os plugins e assim por diante.
A partir do 3.29, o Flutter no Android e no iOS executa o código Dart na thread principal da aplicação, e não existe mais uma thread de UI separada. Esta é a primeira parte de uma série de mudanças para melhorar a interoperação com a plataforma em dispositivos móveis, pois permite fazer chamadas síncronas de e para a plataforma sem o custo da serialização e da troca de mensagens.
DevTools e IDEs
Novo inspector do DevTools
O novo inspector do DevTools está habilitado por padrão para todos os usuários. Ele tem uma árvore de widgets condensada, uma nova visualização de propriedades de widgets e a opção de atualizar automaticamente em resposta a eventos de hot reload e de navegação. Para mais detalhes, visite a página do novo inspector em docs.flutter.dev.

Mudanças na seleção de widgets no dispositivo
Depois de ativar o modo de seleção de widgets pelo inspector do DevTools, qualquer seleção feita no dispositivo é considerada uma seleção de widget até você sair do modo de seleção. Antes, depois da primeira seleção, era preciso clicar no botão Select widget no dispositivo para selecionar outro widget. Agora há um botão no próprio dispositivo que permite sair rapidamente do modo de seleção de widgets.

Melhorias na ferramenta de logging
A ferramenta de Logging do DevTools foi melhorada nos seguintes aspectos:
Os logs incluem e exibem mais metadados, como severidade, categoria, zone e isolate.
Adicionado suporte a filtros por nível de severidade.
Melhoria significativa de desempenho e no tempo de carregamento inicial.

Estes são apenas alguns destaques deste release. Para conhecer todas as atualizações incluídas no Flutter 3.29, confira as notas de release do DevTools 2.41.0 e 2.42.2.
Breaking changes e descontinuações
Descontinuação de pacotes
Planejamos descontinuar o suporte aos seguintes pacotes em 30 de abril de 2025:
-
ios_platform_images; veja ios_platform_images com descontinuação planejada #162961
-
css_colors; veja css_colors com descontinuação planejada #162962
-
palette_generator; veja palette_generator com descontinuação planejada #162963
-
flutter_image; veja flutter_image discontinued #162964
-
flutter_adaptive_scaffold; veja flutter_adaptive_scaffold com descontinuação planejada #162965
-
flutter_markdown; veja flutter_markdown com descontinuação planejada #162966
Incentivamos os membros interessados da comunidade a se coordenarem para criar e manter forks. Os links para as issues estão indicados acima, para discussão e coordenação.
Remoção da aplicação baseada em script do plugin Gradle do Flutter
Remoção da aplicação baseada em script do plugin Gradle do Flutter, que está descontinuada desde o 3.19. Isso viabiliza a conversão do plugin Gradle do Flutter de Groovy para Kotlin e a migração para a API pública do AGP. Espera-se que esse trabalho reduza a frequência de quebras quando uma nova versão do AGP for publicada e diminua regressões de build.
Projetos criados antes do 3.16 que ainda não migraram provavelmente serão afetados. Se a ferramenta flutter exibir o aviso “You are applying Flutter’s main Gradle plugin imperatively” ao fazer o build do projeto, você é afetado e precisa migrar seguindo Deprecated imperative apply of Flutter’s Gradle plugins em docs.flutter.dev.
Remoção do renderer HTML da web
Esta é a primeira versão em que o renderer HTML foi removido do Flutter web. Para mais informações, visite The intent to deprecate and remove the HTML renderer in Flutter web e Issue 145584: Intent to deprecate and remove the HTML renderer in Flutter web.
Tratamento de imagens na web
Esta versão também oferece mais controle sobre como as imagens são exibidas na web. No beta anterior (3.28), os widgets Image usavam automaticamente elementos <img> para exibir imagens de URLs quando ocorriam erros de CORS. Isso podia levar a um comportamento inconsistente. Agora, a flag webHtmlElementStrategy permite escolher quando os elementos <img> são usados. Embora esse fallback venha desabilitado por padrão, você ainda pode habilitá-lo ou até priorizar os elementos <img>, se a sua aplicação precisar.
Normalização do Material
Como parte do projeto contínuo de normalização de temas no Material, esta versão descontinua ThemeData.dialogBackgroundColor em favor de DialogThemeData.backgroundColor. Você pode usar o comando dart fix para migrar o código afetado.
Também no Material, a propriedade ButtonStyleButton iconAlignment foi descontinuada depois de ser adicionada a ButtonStyle e aos métodos styleFrom associados.
Para todas as breaking changes desta versão, consulte a lista completa de orientações de migração na página de breaking changes do site.
Como sempre, muito obrigado à comunidade por contribuir com testes — eles nos ajudam a identificar breaking changes. Para saber mais, confira a política de breaking changes do Flutter.
Conclusão

Obrigado à comunidade do Flutter por tornar este release possível! Estamos animados com o futuro e mal podemos esperar para ver os seus apps. Confira as notas de release e o changelog, depois execute flutter upgrade e comece a construir!