Novidades do Flutter 3.32

Hot reload na web, fidelidade nativa e integrações mais profundas

Novidades do Flutter 3.32

Hot reload na web, fidelidade nativa e integrações mais profundas

Introdução

Bem-vindo ao Flutter 3.32! Este release está cheio de recursos pensados para acelerar o seu desenvolvimento e melhorar os seus apps. Prepare-se para o hot reload na web, os squircles do Cupertino com fidelidade nativa e as novas e poderosas integrações de IA com o Firebase. Com 1024 commits de 156 colaboradores únicos, incluindo 39 colaboradores de primeira viagem, o Flutter 3.32 é a prova do incrível trabalho da nossa comunidade. Vamos explorar as novidades!

Web

Hot reload na web (Experimental)

Estamos animados para anunciar que agora você pode fazer hot reload na web! O suporte a hot reload na web é a issue mais votada #2 no tracker do Flutter. Estamos felizes em dar a você a chance de testá-lo nos seus próprios projetos! Queremos a sua ajuda para garantir que esse novo recurso tenha tudo o que os desenvolvedores querem.

Se você encontrar algum problema, registre um bug usando o template de issue Web Hot Reload do Dart. Você pode encontrar a lista de problemas conhecidos no projeto do GitHub Web Hot Reload Known Issues.

Agora, a parte divertida: como usar o recurso

Adicionamos uma flag simples de linha de comando, --web-experimental-hot-reload, que você pode passar ao Flutter sempre que invocar flutter run.

Executando pelo VS Code

Se você usa configurações de debug no VS Code, pode adicionar esta configuração extra ao seu arquivo launch.json:

json
"configurations": [
  …
  {
    "name": "Flutter for web (hot reloadable)",
    "type": "dart",
    "request": "launch",
    "program": "lib/main.dart",
    "args": [
      "-d",
      "chrome",
      "--web-experimental-hot-reload",
    ]
  }
]

Para melhores resultados, recomendamos habilitar a configuração “Dart: Flutter Hot Reload On Save” no VS Code. Um hot reload também pode ser acionado pelo ícone ⚡ no painel Run/Debug. Hot restarts ainda podem ser acionados usando o botão ⟳.

Executando pela linha de comando

Se você usa “flutter run” na linha de comando, agora pode executar o hot reload na web com o seguinte:

bash
flutter run -d chrome --web-experimental-hot-reload

Quando o hot reload estiver habilitado, você pode recarregar a aplicação pressionando “r” no terminal em execução, ou “R” para fazer um hot restart.

Recarregando no DartPad

O hot reload também está disponível no DartPad, com um novo botão Reload. O recurso só fica disponível se o Flutter for detectado na aplicação em execução. Você pode testá-lo usando um sample app fornecido pelo DartPad.

Obrigado por dedicar seu tempo para nos ajudar a tornar o hot reload na web incrível!

Framework

Continuamos nosso esforço para mover a lógica da biblioteca Material para a biblioteca de widgets.

Esta versão introduz um novo widget Expansible que facilita a criação de widgets que expandem e recolhem com diferentes temas visuais. Esse novo widget serve como o bloco de construção básico do ExpansionTile com estilo Material.

Outra adição valiosa nesta versão é o RawMenuAnchor, contribuído pelo membro da comunidade @davidhicks980. Esse widget agora serve como o bloco de construção básico do MenuAnchor com estilo Material, abrindo caminho para a criação de menus com diversos temas visuais. Além disso, RawMenuAnchor pode ser usado de forma independente como um menu sem estilo, dando a você controle total sobre a sua aparência.

Refatorações como essas trazem melhor suporte para widgets principais usados na implementação de linguagens de design como Cupertino e Material (e mais!), com superfícies mais consistentes e compartilhamento de código.

Cupertino

Squircles

Temos o prazer de apresentar uma adição importante às capacidades de formas do Flutter: a superelipse arredondada.

Muitas vezes chamada de “squircle da Apple”, essa forma é um pilar da linguagem de design do iOS, conhecida por curvas mais suaves e contínuas em comparação com retângulos arredondados tradicionais. O suporte a essa forma foi um pedido frequente da comunidade Flutter. Sua inclusão representa mais um passo no nosso esforço para oferecer UI de alta fidelidade, com aparência e sensação nativas nas plataformas Apple.

Tanto CupertinoAlertDialog quanto CupertinoActionSheet foram atualizados para usar esta nova forma!

Você pode adicionar superelipses arredondadas aos seus apps usando estas novas APIs:

  1. RoundedSuperellipseBorder para pintura ou como forma de widget

  2. ClipRSuperellipse para recorte.

  3. Canvas.drawRSuperellipse, Canvas.clipRSuperellipse e Path.addRSuperellipse para APIs de baixo nível que oferecem controle mais direto.

Observe que a superelipse arredondada está em desenvolvimento ativo. Atualmente, ela é suportada apenas no iOS e no Android; nas demais plataformas, o comportamento volta a ser um retângulo arredondado padrão. As otimizações de desempenho também estão em andamento. Convidamos você a explorar este novo recurso com essas ressalvas em mente, e estamos ansiosos para ampliar suas capacidades em atualizações futuras!

Sheet

Também foram resolvidos vários problemas no Cupertino sheet, incluindo a correção de como o sheet define o tema da UI do sistema quando abre no Android.

O sheet foi ajustado para corrigir a altura da barra de navegação e garantir que o conteúdo não fique cortado na parte inferior. A captura de tela a seguir mostra o antes e o depois dessa mudança.

Outras correções nesta versão incluem um problema em que a transição do sheet era incompatível com PopupMenuButton. Além disso, a transição de cantos arredondados do sheet foi melhorada para ficar correta em mais dispositivos. Antes, ela ficava incorreta em algumas telas com raios de canto diferentes.

Você também pode usar agora o novo argumento enableDrag em CupertinoSheetRoute e showCupertinoSheet para desativar o comportamento de arrastar para baixo para fechar do bottom sheet do Cupertino. (#163923)

Barras de navegação

CupertinoSliverNavigationBar.search recebeu melhorias de fidelidade na animação ao abrir ou fechar a visualização de pesquisa, além do alinhamento correto dos ícones de prefixo e sufixo do campo de pesquisa.

Por fim, a transição entre rotas com CupertinoNavigationBars ou CupertinoSliverNavigationBars foi atualizada para acompanhar as transições mais recentes do iOS (#164956).

Material

Esta versão traz um conjunto de melhorias de recursos e correções de bugs para a biblioteca Material, aprimorando tanto a funcionalidade quanto a experiência do desenvolvedor.

As melhorias de recursos incluem:

  • O CarouselController oferece um método animateToIndex mais conveniente, permitindo uma navegação suave baseada em índice para carrosséis, seja com itens de tamanho fixo ou dinâmico, usando flexWeights.
  • TabBar agora tem os callbacks onHover e onFocusChange, dando mais controle sobre a aparência do widget em diferentes estados.
  • SearchAnchor e SearchAnchor.bar agora incluem os callbacks viewOnOpen e onOpen, respectivamente, permitindo observar e tratar melhor os eventos de abertura e fechamento.
  • CalendarDatePicker agora aceita um calendarDelegate para habilitar a integração de lógica de calendário personalizada, além do sistema de calendário gregoriano. O exemplo demonstra um sistema de calendário hipotético em que os meses de número par têm 21 dias, os meses de número ímpar têm 28 dias e todo mês começa numa segunda-feira, mostrando a flexibilidade que esse delegate oferece.

Outras melhorias menores incluem a adição de animationStyle a showDialog, showAdaptiveDialog e DialogRoute para personalizar a animação ao abrir e fechar o diálogo; Divider agora aceita um borderRadius para permitir personalizar a borda do divisor, especialmente quando ele é espesso.

Além das novidades, esta versão também corrige vários bugs relacionados a DropdownMenu e Sliders na biblioteca Material:

  • O widget DropdownMenu agora permite que a largura do menu seja menor que a do campo de texto. O exemplo foi atualizado para resolver um erro de overflow de RenderFlex anterior. A largura padrão de DropdownMenu agora respeita a largura do rótulo de texto no campo.

  • Ao passar o mouse sobre o thumb de um RangeSlider, apenas o overlay do thumb em foco aparece. Antes, os dois overlays apareciam incorretamente. O thumb de Slider agora pode alcançar as duas extremidades da trilha quando a cor da trilha é transparente, superando uma limitação anterior em que isso não era possível.

Acessibilidade

Compilação otimizada da árvore de semantics

Este recurso reduziu o tempo de compilação da semantics em cerca de 80%. No Flutter para web, isso se traduz em uma redução de 30% no tempo de frame quando a semantics está habilitada.

Introduzindo roles de semantics com granularidade fina

Uma nova API SemanticsRole foi integrada ao widget Semantics e aos seus componentes associados, oferecendo aos desenvolvedores controle mais preciso sobre como os elementos da UI são interpretados por tecnologias assistivas. Isso permite atribuir roles específicos a uma subárvore inteira de widgets, bastando envolvê-la com um widget Semantics configurado com o role desejado.

A lista de roles disponíveis está detalhada na documentação oficial da API. Atualmente, essa funcionalidade avançada de roles de semantics está disponível para aplicações web, com suporte a outras plataformas previsto para versões futuras.

Para mais informações, veja Melhorando a acessibilidade com roles semânticos.

Outras melhorias de acessibilidade

  • Experiência de usuário aprimorada para widgets e leitores de tela: Melhor suporte à acessibilidade e à experiência de uso em vários widgets, incluindo campos de texto, controle de foco, menus, sliders e dropdowns. Os leitores de tela agora fornecem feedback mais descritivo quando os usuários interagem com esses elementos.

  • Navegação por foco mais fluida na web com semantics: Comportamento de foco refinado na web quando a semantics está habilitada, reduzindo significativamente saltos bruscos de foco entre widgets para uma navegação mais intuitiva.

  • Reconhecimento de links aprimorado para o TalkBack do Android: O TalkBack do Android agora identifica e anuncia corretamente links definidos com Semantics.linkUrl ou com o widget Link do pacote url_launcher.

  • Suporte ao modo de alto contraste do Windows no Flutter para web: Foi introduzido o suporte ao modo “forced colors” do Windows (frequentemente usado em cenários de alto contraste). Os desenvolvedores agora podem definir o booleano useSystemColors em ThemeData para aplicar automaticamente as cores do sistema aos temas do Flutter, aumentando a visibilidade para usuários que dependem dessas configurações.

  • Experiência do Controle por Voz no iOS refinada: Melhoramos a experiência do Controle por Voz do iOS ao garantir que widgets não acionáveis deixem de exibir rótulos desnecessários, resultando em uma interação mais limpa e focada para os usuários.

Entrada de texto

A entrada de texto teve várias melhorias nesta versão:

  1. O menu de contexto de seleção de texto do sistema foi lançado no iOS, o que está descrito na seção de iOS abaixo.

  2. As opções do widget Autocomplete foram portadas para OverlayPortal, melhorando o desempenho e corrigindo bugs de layout.

  3. Agora é possível personalizar o comportamento de onTapUpOutside nos campos de texto (#162575).

  4. Os desenvolvedores agora podem gerar qualquer widget como mensagem de erro para FormField, em vez de apenas texto de erro (#162255).

  5. A seleção de texto no Flutter ficou com menos bugs (#162228) e mais performática na web (#161682).

Progresso no suporte a múltiplas janelas

Colaboradores da Canonical fizeram um excelente progresso para permitir que aplicações desktop tenham várias janelas!

A Canonical corrigiu vários recursos que estavam quebrados quando um app tinha várias janelas:

  1. Acessibilidade: #164577

  2. Notificações do ciclo de vida do app: #164872

  3. Foco: #164296

  4. Eventos de teclado: #162131, #163962

  5. Entrada de texto: #163847, #164014

  6. Eventos de mouse: #163855

A Canonical também adicionou um recurso que permite que código Dart via FFI se comunique diretamente com a engine do Flutter (#163430). Isso estabelece a base para as futuras APIs de janelas do Flutter.

Por fim, a Canonical introduziu uma thread de raster no Linux (#161879). Isso melhora a vazão de frames, garantindo que o Flutter Linux continue extremamente fluido mesmo com várias janelas.

Fusão de threads no desktop

A Canonical também atualizou Windows e macOS para permitir que os apps unifiquem as threads de UI e de plataforma (#162883, #162935).

Threads unificadas permitem usar Dart FFI para interoperar com APIs nativas que precisam ser chamadas na thread de plataforma. Por exemplo, se você habilitar threads unificadas no Windows, pode usar Dart FFI para redimensionar a janela do seu app com APIs do win32!

No Windows, você pode ativar threads unificadas adicionando o seguinte ao seu arquivo windows/runner/main.cpp, dentro do método wWinMain:

cpp
project.set_ui_thread_policy(flutter::UIThreadPolicy::RunOnPlatformThread)

No macOS, você pode ativar threads unificadas adicionando o seguinte ao seu arquivo macos/Runner/Info.plist, dentro do elemento <dict>:

xml
<key>FLTEnableMergedPlatformUIThread</key>
<true />

Em uma versão futura, vamos ativar threads unificadas por padrão no Windows e macOS. Por favor, teste isso e abra issues se encontrar algum bug!

iOS

Melhoramos a experiência de colar conteúdo em apps Flutter no iOS! Para campos de texto básicos sem ações personalizadas, os usuários não verão mais uma caixa de confirmação ao colar conteúdo de outros apps. Isso já está habilitado por padrão em todos os apps Flutter para iOS. Observe que, se o seu app usa ações personalizadas (por exemplo, “Enviar e-mail” em menus de contexto), este recurso ainda não é suportado.

Android

Reescrita em Kotlin das ferramentas Gradle

O plugin Gradle do Flutter foi convertido de Groovy para Kotlin. Essa transição facilita a contribuição com a base de código e também permite a criação de testes unitários para o plugin. Os testes adicionados, assim como a conversão de uma linguagem de tipagem dinâmica e execução dinâmica para uma de tipagem estática, devem resultar em um processo de build mais estável e confiável para os desenvolvedores Flutter. Não esperamos nenhuma mudança de comportamento como resultado da reescrita, então, por favor, abra uma issue se você notar builds Android se comportando de forma diferente do esperado.

Suporte a Scribe / Stylus

Agora você pode usar sua caneta stylus para escrever em campos de texto no Android, da mesma forma que a escrita à mão com o Apple Pencil já funciona em apps Flutter para iOS. Os usuários podem começar a escrever diretamente sobre qualquer campo de entrada de texto do Flutter, e a escrita à mão aparecerá como texto no campo. Nem todos os gestos são suportados ainda, mas estamos trabalhando para fechar essas lacunas. Esse recurso é compatível com Android 14 e versões superiores e pode ser desativado, se necessário, com os parâmetros TextField.stylusHandwritingEnabled ou CupertinoTextField.stylusHandwritingEnabled.

Engine

Impeller no Android

A partir da versão 3.29.3, em dispositivos com Android API nível 28 (Android 9) ou anterior, os apps Flutter usarão o renderer Skia legado. Essa mudança melhora a estabilidade do Flutter em dispositivos Android mais antigos. O Impeller continua sendo o renderer padrão em dispositivos com API nível 29 (Android 10) ou superior.

Conforme recebemos mais feedback de usuários em diferentes dispositivos, ajustamos quais dispositivos usam o backend Vulkan ou OpenGLES do Impeller. Em especial, nesta versão os seguintes dispositivos passarão a usar OpenGLES em vez de Vulkan: o emulador Android, dispositivos MediaTek com API inferior a 31, dispositivos PowerVR anteriores a CXT e versões antigas das GPUs XClipse da Samsung que não suportam Vulkan 1.3.

Como nas versões anteriores, você pode desativar o Impeller seguindo estas instruções. Devido à nossa crescente confiança na estabilidade e no desempenho do Impeller, a possibilidade de desativá-lo em dispositivos Android mais novos será removida em uma versão estável futura.

Por fim, o Flutter 3.27 tem uma série de bugs de renderização e travamentos relacionados à renderização com Impeller em dispositivos com suporte a Vulkan, que foram corrigidos na 3.29 e versões posteriores. Não planejamos aplicar hotfix dessas mudanças na 3.27 e recomendamos fortemente atualizar para a 3.29 ou posterior. Se o seu aplicativo não puder fazer isso, recomendamos desativar o Impeller em dispositivos Android.

Outras atualizações do Impeller

Esta versão melhora a renderização de texto do Impeller. Em especial, as animações de texto ficaram mais suaves, com menos trepidação, graças a glifos de maior resolução no atlas de glifos do Impeller e à correção de erros de arredondamento em cálculos de ponto flutuante. Mais detalhes podem ser encontrados em flutter#149652.

Antes
Antes
Depois
Depois

Esta versão também inclui uma série de outras melhorias de fidelidade e desempenho, incluindo:

DevTools e IDEs

[Novo] Editor de Propriedades do Flutter

Edite facilmente as propriedades dos widgets e leia a documentação na nova ferramenta Editor de Propriedades, acessível pelo painel lateral Flutter Property Editor (VS Code) ou pela janela de ferramentas (Android Studio / IntelliJ).

VSCode
VSCode
Android Studio e IntelliJ
Android Studio e IntelliJ

Melhorias no DevTools

Foram feitas melhorias adicionais no DevTools, incluindo novo suporte offline para a tela Network, correções de bugs relacionados ao histórico de revisão, erros do inspector, à ferramenta Deep Links e melhorias de dados para o CPU Profiler e as telas de Memory. Esta versão também inclui várias melhorias de desempenho e memória para o DevTools, que resultarão em tempos de carregamento de dados mais rápidos e menos travamentos relacionados à memória.

Estes são apenas alguns destaques desta versão. Para saber mais sobre todas as atualizações incluídas no Flutter 3.32, confira as notas de versão do DevTools 2.44.0 e 2.45.0.

Melhorias no analyzer

Continuamos melhorando o Dart Analyzer e, consequentemente, a experiência do desenvolvedor. Isso inclui a adição de “doc imports”, uma nova sintaxe baseada em comentários que permite referenciar elementos externos em comentários de documentação sem importá-los de fato. Confira os detalhes em dart.dev. Também fizemos várias melhorias em quick fixes, assists e renomeações.

O Gemini no Android Studio agora fala Flutter e Dart fluentemente

O Gemini no Android Studio agora oferece suporte de primeira classe para desenvolvimento com Dart e Flutter! Isso significa que você pode aproveitar o poder do Gemini diretamente na sua IDE favorita para criar apps Flutter bonitos e de alto desempenho, de forma mais rápida e fácil do que nunca.

Leia este post do blog para saber mais.

Suporte a Dart e Flutter para o Model Context Protocol (MCP) está a caminho

O suporte ao Model Context Protocol (MCP) e ao recém-publicado Dart MCP SDK está em andamento. Um novo Dart Tooling MCP Server, também em desenvolvimento, vai expor ferramentas de análise estática, de runtime e do ecossistema do Dart e do Flutter para clientes MCP, como IDEs.

Isso trará os seguintes benefícios para desenvolvedores Dart e Flutter:

  • Geração de código mais precisa e relevante.

  • Tarefas complexas, como corrigir problemas de layout, gerenciar dependências ou até resolver erros de runtime, tornam-se viáveis, já que o protocolo MCP expõe informações semânticas das ferramentas reais do Dart e do Flutter.

Fique de olho!

Crie com IA

Apresentando o Firebase AI Logic

Talvez você já tenha ouvido falar do Vertex AI in Firebase, nosso SDK cliente para integrar diretamente funcionalidades da API Gemini ao seu app Flutter, ou até mesmo já o tenha usado.

Muitos de vocês pediram para usar a Gemini Developer API, em vez da Vertex AI, para aproveitar o generoso nível gratuito e começar a adicionar IA generativa sem custo. Nós ouvimos vocês! A partir de hoje, estamos evoluindo o Vertex AI in Firebase para o Firebase AI Logic, que oferece acesso aos dois provedores da API Gemini com um único SDK para Flutter. Ele permite usar os modelos Gemini e Imagen diretamente do seu app Flutter, sem precisar de um SDK do lado do servidor.

Confira o pacote firebase_ai para as novas funcionalidades. Se você já usa o pacote firebase_vertexai, ele continuará funcionando como está por enquanto, mas recomendamos migrar para o novo pacote.

Obtenha insights acionáveis com o painel AI Monitoring

O novo painel AI Monitoring no console do Firebase oferece insights detalhados e acionáveis sobre o uso da sua API Gemini. Isso inclui visibilidade completa sobre padrões de consumo, métricas de desempenho e possíveis problemas. Isso permite decisões baseadas em dados e garante que você esteja usando as APIs Gemini da forma mais eficiente. O AI Monitoring também ajuda a depurar o uso da API Gemini e a identificar e resolver comportamentos inesperados.

Breaking changes e descontinuações

Anúncios de acessibilidade no Android

No Android, os eventos de anúncio semântico agora estão descontinuados a partir da API 36. Em vez disso, use anúncios implícitos “polite” configurando um SemanticProperties.liveRegion. Atualmente, há uma limitação conhecida ao anunciar textos que não deveriam ser focáveis. Veja a issue #165857 para detalhes sobre essa limitação e os planos para resolvê-la. Para ver alternativas, consulte a documentação sobre SemanticService.announce.

Suporte descontinuado para 6 pacotes

Conforme planejado e anunciado no nosso post do blog do Flutter 3.29, descontinuamos o suporte aos seguintes pacotes:

Convidamos os membros da comunidade a consultar a discussão em cada uma dessas issues para encontrar alternativas.

Versões mínimas de iOS e macOS

O Flutter vai descontinuar o suporte ao iOS 12 e ao macOS 10.14 (Mojave) na próxima versão estável, e passará a ter como mínimo o iOS 13 e o macOS 10.15 (Catalina). Isso significa que apps criados com futuras versões do Flutter não vão rodar no iOS 12 ou no macOS 10.14.

Outras breaking changes

Outras breaking changes e descontinuações nesta versão incluem:

  • Descontinuado o ExpansionTileController no Material, em favor do novo ExpansibleController reutilizável na camada de Widgets.

  • Renomeado SelectionChangedCause.scribble (que está descontinuado) para SelectionChangedCause.stylusHandwriting, já que o recurso Scribble da Apple agora está unificado com o Scribe do Android.

  • Como parte do nosso trabalho contínuo para normalizar o tema Material, ThemeData.indicatorColor está descontinuado em favor de TabBarThemeData.indicatorColor, enquanto os tipos de tema de componente para cardTheme, dialogTheme e tabBarTheme precisarão ser migrados para CardThemeData, DialogThemeData e TabBarThemeData, respectivamente.

  • A fórmula de SpringDescription em alguns comportamentos foi corrigida. Essa mudança resolve o problema em que o comportamento de algumas combinações de parâmetros não correspondia à física esperada no mundo real e apresentava descontinuidade próximo ao ponto de amortecimento crítico. A quebra afeta molas subamortecidas (razão de amortecimento menor que 1) com valores de massa diferentes de 1. Molas criadas antes dessa mudança podem apresentar comportamentos de quique diferentes após a atualização. Para restaurar o comportamento anterior da animação, atualize os parâmetros das suas molas de acordo com o guia Spring Description Underdamped breaking change, onde você também encontra uma ferramenta que calcula os ajustes dos parâmetros.

Para ver os guias de migração de todas as descontinuações ou breaking changes desta versão, consulte a página de breaking changes. Executar dart fix após a atualização migrará automaticamente algumas dessas mudanças para você.

Conclusão

O Flutter 3.32 marca mais um passo à frente, graças à dedicação incrível da nossa comunidade. Estamos muito felizes em trazer recursos como o hot reload na web e melhorias contínuas nas plataformas. Suas contribuições são inestimáveis, e mal podemos esperar para ver o que você vai criar. Para uma visão completa, confira as notas de versão detalhadas e o changelog. Para começar, basta executar flutter upgrade e explorar a versão mais recente!

Mais do Flutter