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:

  • O novo CupertinoSheetRoute exibe uma folha modal no estilo iOS que pode ser removida com o gesto de arrastar para fechar.

  • A nova função showCupertinoSheet exibe a folha com uma configuração comum para navegação aninhada já incluída.

Antes da melhoria: à esquerda, uma view nativa; à direita, uma view Flutter
Antes da melhoria: à esquerda, uma view nativa; à direita, uma view Flutter
Depois da melhoria: à esquerda, uma view nativa; à direita, uma view Flutter
Depois da melhoria: à esquerda, uma view nativa; à direita, uma view Flutter
  • 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 pelo ZoomPageTransitionsBuilder.
  • Esta versão atualiza o CircularProgressIndicator e o LinearProgressIndicator para alinhar com as especificações mais recentes do Material Design 3. Para usar o estilo atualizado, defina a propriedade year2023 como false, ou defina ProgressIndicatorThemeData.year2023 como false.
  • Esta versão também introduz o design mais recente do Slider do Material 3, com formatos de trilha e de handle atualizados. O Slider usa o estilo anterior do Material 3 por padrão. Para ativar o design mais recente, defina year2023 como false, ou defina SliderThemeData.year2023 como false.

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 RangeSlider com 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:

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:

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!

Mais do Flutter