Novidades do Flutter 3.41

Capacitando a comunidade

Novidades do Flutter 3.41

Capacitando a comunidade

Hoje, temos o prazer de anunciar o lançamento do Flutter 3.41, um marco transformador na nossa jornada juntos! Que momento empolgante para ser desenvolvedor: esta versão representa nosso compromisso de capacitar a comunidade a moldar a direção do Flutter. Com 868 commits de 145 colaboradores únicos, o Flutter 3.41 traz mais transparência e modularidade para melhorar ainda mais a experiência de contribuir com o Flutter.

Estamos introduzindo janelas públicas de lançamento para facilitar que você saiba quando as mudanças que você contribui chegarão a uma versão estável. Também continuamos desacoplando nossas bibliotecas de design, o que, no longo prazo, nos ajudará a evoluir os design systems mais rapidamente e, ao mesmo tempo, dará a você controle sobre quais mudanças de design adotar nos seus apps. Seja explorando os limites da GPU com as novas melhorias nos fragment shaders, seja incorporando o Flutter de forma integrada a apps nativos existentes com views de tamanho adaptável ao conteúdo, esta versão garante que você tenha as ferramentas para construir com confiança e velocidade.

Há muito para explorar, então vamos direto ao assunto…

Transparência estrutural e modularidade

Janelas públicas de lançamento

Previsibilidade é essencial para entregar funcionalidades complexas com segurança. Estamos introduzindo janelas públicas de lançamento para dar a toda a comunidade a visibilidade necessária para planejar com antecedência. Ao divulgar publicamente as datas de corte das branches e as metas de lançamento, permitimos que toda a comunidade tenha clareza sobre quando as suas mudanças chegarão às próximas versões estáveis.

Então, o que é uma data de corte de branch? Essa data é o prazo para que os pull requests sejam mesclados nas branches padrão (main para o Dart e master para o Flutter) e garantam a inclusão na próxima versão estável. Se o seu PR for mesclado antes do corte, ele será lançado na próxima versão estável. Se for mesclado depois, ele aguarda o ciclo seguinte.

Para 2026, planejamos lançar quatro versões estáveis (incluindo esta), com as seguintes datas:

  • Flutter 3.41 — fevereiro | Branch criada em 06 de janeiro

  • Flutter 3.44 — maio | Branch criada em 07 de abril

  • Flutter 3.47 — agosto | Branch criada em 07 de julho

  • Flutter 3.50 — novembro | Branch criada em 06 de outubro

Desacoplamento para um núcleo mais enxuto

Continuamos nosso projeto de migrar as bibliotecas Material e Cupertino para pacotes separados. Essa abordagem modular traz vários benefícios:

  • Ciclos de lançamento mais rápidos: não precisamos mais esperar por uma versão trimestral do SDK para entregar atualizações de design. Podemos lançar novos recursos e correções de bugs do Material ou do Cupertino assim que estiverem prontos.

  • Atualizações independentes: se você estiver usando uma versão mais antiga do SDK por alguma restrição do projeto, ainda poderá atualizar seus pacotes de design para obter o visual e a experiência mais recentes.

  • Design adaptativo: pacotes versionados nos permitem reagir muito mais rápido quando iOS ou Android introduzem mudanças drásticas de design, como “Liquid Glass” ou “Material 3 Expressive”, garantindo que o seu app nunca fique desatualizado.

Acompanhe a issue no GitHub para seguir o progresso.

Abraçando os padrões do ecossistema

Fazer parte do fortalecimento da comunidade significa garantir que o Flutter funcione bem com as ferramentas nas quais já confiamos.

Swift Package Manager e UIScene

A transição do CocoaPods para o Swift Package Manager continua. Incentivamos fortemente os autores de plugins a adotar o Swift Package Manager, já que ele agora é o padrão no ecossistema Apple. Além disso, para garantir a compatibilidade com as próximas versões do iOS, o Flutter agora oferece suporte completo ao ciclo de vida UIScene por padrão. Essa atualização é essencial para atender aos requisitos da Apple para as próximas versões do iOS. Para simplificar a migração a partir da lógica de ciclo de vida descontinuada do AppDelegate, confira nosso guia de migração.

Android Gradle Plugin (AGP) 9 e Kotlin DSL

Continuamos alinhados aos padrões modernos do Android. Com o lançamento do Android Gradle Plugin (AGP) 9, estamos trabalhando para oferecer suporte aos novos requisitos de rigor e fornecer orientações sobre como lidar com eles.

Atenção: não atualize seu app Flutter para Android para o AGP 9, pois a migração de plugins para o AGP 9 e de apps Flutter no AGP 9 que usam plugins ainda não é suportada (#181383). Esse suporte está pausado enquanto a equipe do Flutter audita a migração quanto à compatibilidade com versões anteriores do AGP. Este documento de migração será atualizado conforme as orientações mudarem.

Graças às contribuições do membro da comunidade Byoungchan Lee (bc-lee@), novos projetos de plugin agora usam a Kotlin DSL para o Gradle por padrão.

Assets específicos por plataforma

Otimizar ficou mais fácil graças ao trabalho de Alex Frei (hm21@). Agora você pode especificar para quais plataformas um asset deve ser empacotado no seu pubspec.yaml. Isso permite otimizações como excluir assets pesados de desktop dos seus builds mobile, reduzindo bastante o tamanho do app.

yaml
flutter:
  assets:
    - path: assets/logo.png
    - path: assets/web_worker.js
      platforms: [web]
    - path: assets/desktop_icon.png
      platforms: [windows, linux, macos]

Ouvindo a comunidade

A equipe do Flutter no Google continua priorizando o que mais importa para você.

A experiência de primeiros passos

Há anos a comunidade aponta que, embora o Flutter seja encantador e produtivo, pode ser difícil saber por onde começar a jornada de aprendizado.

Recentemente lançamos uma experiência de primeiros passos com Dart e Flutter totalmente reformulada.

É um novo caminho de aprendizado criado para guiar você pelos fundamentos de como criar apps com Flutter e Dart. Vamos dar uma olhada rápida nas mudanças:

  • Introduzimos um novo guia de “instalação rápida” que usa hot reload na web, permitindo que quem está aprendendo experimente todo o poder do Flutter rapidamente, sem configurar antes um ambiente específico de plataforma. Um caminho com tutoriais escritos, quizzes leves e oito vídeos novos com alguns rostos conhecidos da equipe do Flutter no Google.

  • Quem concluir o caminho de aprendizado terá construído 4 apps do zero.

Experimente a nova experiência de primeiros passos na seção Learn do nosso site, recém-redesenhada e desenvolvida com Jaspr.

Melhorias em fragment shaders

No quarto trimestre de 2025, pesquisamos desenvolvedores que usam a API FragmentShader e perguntamos simplesmente: O que está atrapalhando o seu trabalho? Você nos disse que precisava de uma ergonomia melhor ao usar a API, além de mais flexibilidade para definir seus shaders. Em resposta, fizemos estas mudanças:

  • No 3.41, adicionamos a decodificação síncrona de imagens. Antes, criar texturas para shaders podia introduzir um frame de atraso. Com decodeImageFromPixelsSync, agora você pode gerar texturas e usá-las como samplers no mesmo frame.

  • Também adicionamos suporte a texturas de alta taxa de bits (até 128 bits em ponto flutuante), o que desbloqueia o uso de tabelas de consulta (LUTs) de alta resolução para filtros de foto acelerados por GPU e SDFs.

dart
void attachTexture(ui.FragmentShader shader) {
  ui.PictureRecorder recorder = ui.PictureRecorder();
  Canvas canvas = Canvas(recorder);
  canvas.drawCircle(const Offset(64, 64), 64, Paint()..color = Colors.red);
  ui.Picture picture = recorder.endRecording();
  ui.Image image = picture.toImageSync(
    128,
    128,
    targetFormat: ui.TargetPixelFormat.rFloat32,
  );
  shader.setImageSampler(0, image);
}

Widget Previews (experimental)

Com base no seu feedback inicial, estamos iterando rapidamente nos Widget Previews. Nesta versão, os Widget Previews melhoraram da seguinte forma:

  • Suporte ao Flutter Inspector: o ambiente de Widget Previews agora tem acesso a uma instância embutida do Flutter Inspector, o que facilita inspecionar layouts e o estado dos widgets visualizados. Observação importante: pode ser necessário configurar diretórios de pacotes adicionais para ver os widgets do seu projeto por padrão. Para isso, abra as configurações do Flutter Inspector clicando no ícone de engrenagem e adicione um novo diretório de pacotes apontando para o seu projeto.
  • Suporte a aplicativos com dependências dart:ffi: antes, previews que incluíam widgets com dependências transitivas de bibliotecas que importavam dart:ffi causavam erros de compilação e impediam o ambiente de preview de atualizar. Isso acontecia porque dart:ffi não é suportado em plataformas web (flutter/flutter#166431). O widget previewer agora consegue lidar com previews que dependem de bibliotecas específicas de plataforma, incluindo dart:ffi e dart:io. Observação importante: invocar APIs dessas bibliotecas não é suportado no widget previewer e vai exibir um erro nos previews que chamam essas APIs específicas de plataforma. Veja a documentação do Dart sobre imports condicionais para exemplos de como escrever código compatível com plataformas nativas e web.

Fidelidade e acabamento do framework

Continuamos refinando a experiência atual com foco na fidelidade às plataformas e na eficiência do desenvolvedor.

Acabamento no iOS

No Flutter 3.41 fizemos melhorias visuais com o novo estilo de “desfoque delimitado”. Antes, widgets translúcidos que usavam o BackdropFilter podiam sofrer vazamento de cor nas bordas. Graças a melhorias no engine de renderização Impeller, eliminamos esse artefato.

Também adicionamos suporte nativo ao estilo de alça de arraste para CupertinoSheet, por meio da propriedade showDragHandle.

Add-to-App

Adicionar views do Flutter em apps Android e iOS existentes ficou mais fácil! Views do Flutter embutidas em apps nativos agora conseguem se redimensionar automaticamente de acordo com o próprio conteúdo. Antes, uma view do Flutter precisava de um tamanho fixo fornecido pelo pai nativo. Isso dificultava alguns cenários, como adicionar views do Flutter a uma view nativa rolável.

Para usar isso, seu widget raiz precisa suportar constraints ilimitadas. Evite usar no topo da árvore widgets que exigem um tamanho predefinido (como ListView ou LayoutBuilder), pois eles entram em conflito com a lógica de dimensionamento dinâmico.

Para habilitar esse comportamento no iOS, defina FlutterViewController.isAutoResizable como true. No Android, habilite o dimensionamento por conteúdo no seu AndroidManifest e defina a largura ou a altura da sua FlutterView como content_wrap.

Trabalhamos bastante para suavizar as arestas dos modelos de interação principais, com as seguintes mudanças:

  • Introduzimos Navigator.popUntilWithResult, que permite fechar várias telas e devolver um valor para a rota de destino em uma única chamada, simplificando bastante o gerenciamento de estado em fluxos de várias etapas.

  • Reimplementamos StretchingOverscrollIndicator usando uma abordagem baseada em simulação, portada do Android 12. Isso garante um efeito de overscroll mais natural e fluido, que responde corretamente a flings de alta velocidade.

  • Corrigimos um problema com cabeçalhos fixos em NestedScrollView e SliverMainAxisGroup, garantindo que os cabeçalhos se sobreponham corretamente aos slivers seguintes.

Acessibilidade

Ajudar você a criar experiências acessíveis que alcancem usuários em qualquer tela está no centro da nossa missão. Nesta atualização, adicionamos o seguinte:

  • Suporte nativo de acessibilidade para CircularProgressIndicator e LinearProgressIndicator, permitindo que tecnologias assistivas anunciem atualizações de progresso.

  • O Flutter agora respeita as sobrescritas de espaçamento de texto dos usuários da web, para melhorar a experiência de leitura.

  • Introduzimos novos matchers, como isSemantics e accessibilityAnnouncement no flutter_test, para facilitar a validação de acessibilidade.

Material e animação

Introduzimos novas primitivas e propriedades para ampliar o controle sobre animações e layout. Graças ao trabalho do membro da comunidade Bernardo Ferrari (bernaferrari@), RepeatingAnimationBuilder introduz uma forma declarativa de criar animações contínuas, como um indicador de carregamento, um botão pulsante ou um efeito de placeholder com brilho.

Por exemplo, veja como fazer um quadrado deslizar de um lado para o outro:

dart
RepeatingAnimationBuilder<Offset>(
  animatable: Tween<Offset>(
    begin: const Offset(-1.0, 0.0),
    end: const Offset(1.0, 0.0),
  ),
  duration: const Duration(seconds: 1),
  repeatMode: RepeatMode.reverse,
  curve: Curves.easeInOut,
  builder: (BuildContext context, Offset offset, Widget child) {
    return FractionalTranslation(
      translation: offset,
      child: child,
    );
  },
  child: const ColoredBox(
    color: Colors.green,
    child: SizedBox.square(dimension: 100),
  ),
),

Também atualizamos CarouselView com um construtor .builder, facilitando a criação de carrosséis com conteúdo dinâmico. DropdownMenuFormField agora aceita um errorBuilder personalizado, e RawAutoComplete agora inclui uma opção OptionsViewOpenDirection.mostSpace para posicionar as opções de forma inteligente, de acordo com o espaço disponível na tela.

Evolução liderada pela comunidade

Um dos exemplos mais fortes de parceria em código aberto do Flutter é nosso relacionamento de longa data com a Canonical. A equipe deles continua impulsionando o roadmap de desktop do Flutter, entregando recursos essenciais que beneficiam todo o ecossistema.

Graças à liderança de engenharia da Canonical, estamos fechando a lacuna em requisitos complexos de UI para desktop. Esta versão apresenta APIs experimentais para criar janelas pop-up e janelas de tooltip, junto com suporte multiplataforma a janelas de diálogo no Linux, macOS e Windows. Por fim, novas APIs foram adicionadas para permitir testar apps com múltiplas janelas. Se quiser uma prévia dessas próximas APIs de janelas, confira o app de exemplo multiple_windows do Flutter!

O Flutter Linux agora também habilita threads mescladas por padrão, simplificando o modelo de threads e melhorando o desempenho, além de trabalhar para melhorar a estabilidade no Windows. Pretendemos remover a opção de desativar as threads mescladas em uma versão futura. Se tiver algum problema com elas, por favor nos avise.

DevTools

O DevTools teve melhorias de desempenho e estabilidade:

  • Os DevTools do Flutter são compilados com dart2wasm, o que resulta em ganhos de desempenho. Você ainda pode desativar essa opção e voltar aos DevTools compilados com dart2js pela caixa de configurações.

  • Conexões perdidas com o Dart Tooling Daemon (DTD) agora são tentadas novamente automaticamente, para melhorar a experiência quando sua máquina volta a funcionar depois de entrar em suspensão.

Estes são apenas alguns destaques desta versão. Para conhecer todas as novidades incluídas no Flutter 3.41, confira as notas de versão dos DevTools 2.52.0, 2.53.0 e 2.54.0.

Próxima parada: flutter upgrade

O Flutter 3.41 é um passo rumo a uma experiência de contribuição open source mais aberta, ao mesmo tempo que aprimora um recurso fundamental do Flutter para melhorar sua experiência de desenvolvimento, seja migrando um plugin para o Swift Package Manager, otimizando assets para plataformas específicas ou criando efeitos visuais com as novas APIs de shaders. Somos gratos à comunidade incrível que construímos juntos.

Para uma lista completa de todas as mudanças, não deixe de conferir as breaking changes detalhadas e as notas de versão. Para experimentar os novos recursos do Flutter 3.41, basta um flutter upgrade!

Mais do Flutter