Novidades do Flutter 3.38

Escreva menos, veja mais, construa mais rápido

Novidades do Flutter 3.38

Escreva menos, veja mais, construa mais rápido

Introdução

Bem-vindo de volta ao nosso lançamento trimestral regular, o Flutter 3.38. Esta atualização é toda sobre aumentar sua produtividade e refinar a experiência de desenvolvimento com dot shorthands e atualizações nos Widget Previews. Graças à nossa comunidade, esta versão inclui 825 commits no total de 145 colaboradores únicos, sendo 37 deles colaboradores de primeira viagem. Vamos ver o que há nesta versão.

Dot shorthands

Escreva código Dart mais conciso! Estamos animados em anunciar um novo recurso do Dart: dot shorthands! Os shorthands reduzem o boilerplate ao permitir que você omita tipos que o Dart consegue inferir.

Por exemplo, você pode usar shorthands para escrever .start em vez de MainAxisAlignment.start .

dart
// With shorthands:
Column(
  mainAxisAlignment: .start,
  crossAxisAlignment: .center,
  children: [ /* ... */ ],
),
​
// Without shorthands:
Column(
  mainAxisAlignment: MainAxisAlignment.start,
  crossAxisAlignment: CrossAxisAlignment.center,
  children: [ /* … */ ],
),

Isso também funciona para construtores nomeados! Você pode escrever .all em vez de EdgeInsets.all:

dart
Padding(
  padding: .all(8.0),
  child: Text('Hello world'),
),

Este recurso está ativado por padrão no Dart 3.10 e no Flutter 3.38. Para mais informações, confira a página de dot shorthands no dart.dev. Você também pode ler sobre isso e mais (como os hooks do Dart!) no post do blog do Dart 3.10.

Web

Arquivos de configuração de desenvolvimento web

O comando flutter run agora oferece suporte a um arquivo de configuração para configurações da web. Isso permite especificar informações de host, porta, certificado e cabeçalhos em um arquivo web_dev_config.yaml na raiz do seu projeto. Versione o arquivo para que toda a equipe depure com as mesmas configurações. Para mais informações, visite como configurar um arquivo de configuração de desenvolvimento web.

Configurações de proxy de desenvolvimento web

Além das flags de linha de comando já existentes, o arquivo de configuração de desenvolvimento web também oferece suporte a novas configurações de proxy. As configurações de proxy permitem encaminhar requisições de caminhos configurados para outro servidor. Isso facilita o desenvolvimento de um cliente web que se conecta a endpoints dinâmicos no mesmo host.

Os detalhes sobre as configurações de proxy também estão em como configurar um arquivo de configuração de desenvolvimento web.

Hot reload na web expandido

O hot reload com estado agora vem ativado por padrão ao executar com -d web-server e abrir o link do seu app Flutter em um navegador. Isso funciona até mesmo com vários navegadores conectados ao mesmo tempo.

Assim como com -d chrome, esse recurso pode ser desativado temporariamente usando a flag --no-web-experimental-hot-reload . A capacidade de desativar o recurso será removida em uma versão futura; por isso, se você encontrar problemas no seu fluxo de desenvolvimento, por favor registre um bug usando o template de issue de hot reload na web do Dart. Para mais informações, consulte a documentação de hot reload na web.

Framework

Esta versão inclui vários recursos novos e refinamentos poderosos no framework, dando às pessoas desenvolvedoras mais controle granular sobre UI avançada, navegação e interações com a plataforma.

Agora as pessoas desenvolvedoras têm mais poder ao criar pop-ups, diálogos e outros elementos de UI flutuantes com OverlayPortal. Agora é possível renderizar um filho em qualquer Overlay acima na árvore de widgets usando OverlayPortal.overlayChildLayoutBuilder (#174239), o que facilita mostrar uma notificação em todo o app ou outra UI que precisa escapar das restrições de layout do widget pai. O método Overlay.of também foi tornado mais robusto e eficiente (#174315).

Para uma experiência de navegação mais moderna no Android, as transições de rota de back preditivo agora vêm ativadas por padrão no MaterialApp (#173860). Quando o usuário faz o gesto de voltar, ele agora vê uma prévia da tela inicial enquanto a rota atual se afasta com animação. Além disso, a transição de página padrão foi atualizada para FadeForwardsPageTransitionsBuilder a partir de ZoomPageTransitionsBuilder para refletir o comportamento nativo.

Esta versão também aprofunda a integração com desktop. No Windows, os desenvolvedores agora podem acessar a lista de displays conectados e consultar propriedades detalhadas de cada um, como resolução, taxa de atualização e tamanho físico (#164460). Isso possibilita a criação de apps com recursos sofisticados de gerenciamento de janelas.

Por fim, o próprio framework ficou mais resiliente. Erros que ocorrem em callbacks do ciclo de vida de widgets (como didUpdateWidget) agora são tratados de forma mais elegante, evitando que causem falhas em cascata na árvore de elementos (#173148). ResizeImage agora implementa corretamente a igualdade, o que torna o cache e a comparação de imagens mais previsíveis ao garantir que os providers ResizeImage idênticos sejam tratados da mesma forma (#172643).

Na web, o acabamento da UI continua com uma correção em RSuperellipse que impede erros de renderização quando os raios dos cantos são maiores que o próprio widget (#172254). Agora, esses casos são tratados para produzir o formato de pílula, como esperado.

Para usuários internacionais, a detecção do idioma preferido do navegador agora é mais robusta. A engine passa a usar a API web padrão Intl.Locale para interpretar os idiomas do navegador, substituindo a implementação manual anterior, mais frágil (#172964). Essa mudança torna a detecção de locale mais confiável e proporciona uma experiência melhor para um público global.

Um bug específico do Android (#171973) foi corrigido, afetando principalmente dispositivos Samsung com teclados de hardware. Antes, depois que o usuário interagia com um TextField, o Editor de Método de Entrada (IME) do Android podia ficar preso em um estado desatualizado. Isso fazia com que o IME interceptasse por engano as teclas “Enter” ou “Space”, impedindo que widgets que não são de texto, como um Checkbox ou um botão Radio, recebessem o evento. A correção garante que o InputMethodManager seja corretamente reinicializado quando a conexão de texto é fechada, limpando o estado desatualizado do IME e restaurando a interação previsível com o teclado de hardware para os usuários.

Atualizações de Material e Cupertino

As bibliotecas Material e Cupertino continuam evoluindo com foco em consistência de API e experiências de usuário mais refinadas. Esta versão traz uma grande migração de API, novos recursos para widgets e vários refinamentos que tornam a criação de UIs bonitas e funcionais mais simples.

Com base na descontinuação de MaterialState, esta versão continua a migração interna para a WidgetState mais unificada. Ela oferece uma forma consistente e expressiva de definir a aparência de um widget nos diferentes estados de interação, como pressionado, com hover ou desabilitado, e não exige nenhuma alteração em apps existentes. Essa migração foi aplicada a uma ampla gama de widgets e seus temas, incluindo IconButton, ElevatedButton, Checkbox e Switch (#173893). A nova API também traz mais poder e flexibilidade; por exemplo, IconButton agora inclui uma propriedade statesController (#169821) que permite o controle programático de seus estados visuais, abrindo espaço para designs mais personalizados e interativos.

Esta versão também introduz vários recursos novos e APIs de conveniência. O construtor Badge.count agora inclui um parâmetro maxCount (#171054) para limitar facilmente a contagem exibida (por exemplo, mostrando “99+” em vez de “100”).

Para um controle de gestos mais refinado, o widget InkWell agora traz um callback onLongPressUp (#173221), útil para disparar ações que só devem ser concluídas quando o usuário levanta o dedo.

A biblioteca Cupertino também segue em direção a uma fidelidade maior ao iOS. O CupertinoSlidingSegmentedControl ganha uma propriedade isMomentary (#164262) para permitir que o controle dispare ações sem manter uma seleção. Para se alinhar melhor ao comportamento nativo do iOS, o CupertinoSheet agora apresenta um sutil efeito de “stretch” quando arrastado para cima enquanto está totalmente expandido (#168547).

Por fim, esta versão traz vários refinamentos que aprimoram o comportamento de componentes centrais. Os destaques incluem uma correção no DropdownMenuFormField para limpar corretamente o campo de texto quando um formulário é resetado (#174937) e atualizações no SegmentedButton para melhorar o tratamento de foco (#173953) e garantir que sua borda reflita corretamente o estado do widget (#172754).

Desacoplamento de Material e Cupertino

Temos feito muito planejamento para desacoplar as bibliotecas Material e Cupertino do framework. A lista a seguir inclui várias discussões sobre alguns documentos de design publicados recentemente.

Melhorando o processo de lançamento de flutter/packages, que vai incluir Material e Cupertino após o desacoplamento.

Cores e dot shorthands

Desacoplamento dos testes

Texto

Rolagem: slivers mais robustos e previsíveis

Esta versão traz uma série de correções que tornam mais robusta e previsível a criação de layouts de rolagem complexos, especialmente os que usam SliverMainAxisGroup e SliverCrossAxisGroup.

Desenvolvedores que usam esses widgets para agrupar vários slivers vão notar que o tratamento de gestos agora é mais confiável. O hit-testing de toques e de outros eventos de ponteiro em slivers dentro desses grupos agora é calculado corretamente, garantindo que as interações do usuário se comportem como esperado (#174265).

Várias outras correções contribuem para um comportamento de rolagem mais preciso dentro de um SliverMainAxisGroup. Problemas de overscroll ao usar um cabeçalho fixado foram resolvidos (#173349), chamar showOnScreen para revelar um sliver agora funciona corretamente (#171339) e o cálculo do offset de rolagem interno está mais preciso (#174369).

Para desenvolvedores que criam views de rolagem personalizadas, o novo construtor SliverGrid.list (#173925) oferece uma forma mais limpa de criar uma grade a partir de uma lista simples de filhos.

Esta versão também melhora a navegação de foco para usuários de teclado e D-pad em layouts complexos. Em scroll views aninhadas com eixos de rolagem diferentes (como uma lista vertical de carrosséis horizontais), a navegação direcional de foco agora é mais previsível, evitando que o foco pule de forma inesperada entre as seções (#172875).

Acessibilidade: uma experiência mais inclusiva para todos os usuários

Tornar apps acessíveis a todos os usuários é um pilar do framework Flutter. Esta versão mantém esse compromisso ao oferecer aos desenvolvedores mais controle programático, melhorar a experiência de usuários internacionais e refinar a acessibilidade dos widgets centrais.

Para desenvolvedores que criam apps complexos, esta versão introduz a possibilidade de ativar a acessibilidade por padrão no iOS usando WidgetsFlutterBinding.instance.ensureSemantics (#174163). Diagnosticar problemas de acessibilidade ficou mais fácil, pois debugDumpSemanticsTree inclui informações adicionais sobre os resultados da validação de entrada de texto, para ajudar a identificar os problemas com mais rapidez (#174677).

Para acessibilidade avançada em views de rolagem baseadas em slivers, o novo widget SliverSemantics (#167300) já está disponível. Assim como o widget Semantics existente, os desenvolvedores podem usar SliverSemantics dentro de um CustomScrollView para anotar partes da árvore de slivers com informações semânticas específicas. Isso é especialmente útil para anotar cabeçalhos, atribuir papéis semânticos e adicionar rótulos descritivos aos slivers para leitores de tela, proporcionando uma experiência mais compreensível e acessível para os usuários.

Por fim, a acessibilidade dos widgets centrais continua sendo refinada. O CupertinoExpansionTile agora é acessível por padrão (#174480), e o widget AutoComplete agora anuncia ao usuário o status dos resultados de busca (#173480). Outras melhorias, como áreas de toque maiores no TimePicker (#170060), contribuem para uma experiência mais acessível desde o primeiro uso.

iOS

Temos o prazer de confirmar que o Flutter oferece suporte completo às versões mais recentes das plataformas: iOS 26, Xcode 26 e macOS 26, todas lançadas em setembro. Isso garante que você possa começar a desenvolver e testar seus apps imediatamente nas plataformas e ferramentas mais recentes da Apple.

Você talvez já tenha notado uma melhoria significativa de qualidade de vida para desenvolvedores iOS, lançada na versão anterior do Flutter, que resolve uma irritação antiga dos usuários: a exigência de que o app Xcode fosse aberto automaticamente ao executar apps Flutter em dispositivos físicos usando flutter run. Introduzimos um novo método de deploy que usa a ferramenta de linha de comando do Xcode 26, devicectl, para instalação, inicialização e depuração do app. Essa transição elimina a necessidade de abrir o app Xcode durante o deploy e, na maioria dos casos, depende apenas das ferramentas de build do Xcode via linha de comando. Se você encontrar problemas, pode desativar esse método de deploy com flutter config --no-enable-lldb-debugging, e, por favor, abra uma issue para nos avisar!

Antes, esse recurso dependia de automação do Xcode, que ficou instável e pouco confiável no Xcode 26, especialmente ao executar comandos consecutivos. Se você está desenvolvendo para as versões mais recentes da Apple, recomendamos fortemente atualizar sua versão do Flutter para a 3.38 ou superior.

Migração para o ciclo de vida UIScene

O Flutter 3.38 inclui suporte essencial ao ciclo de vida UIScene, exigido pela Apple. Esta é uma atualização crítica e proativa, seguindo o anúncio da Apple na WWDC25: “Na versão seguinte ao iOS 26, qualquer app UIKit criado com o SDK mais recente será obrigado a usar o ciclo de vida UIScene; caso contrário, ele não será iniciado.”

Para que seus apps Flutter para iOS continuem compatíveis e sejam iniciados com sucesso nas próximas versões do iOS, é necessária uma migração.

Migrando apps Flutter

Todos os apps Flutter para iOS existentes precisam migrar para o novo ciclo de vida. Você tem dois caminhos para concluir essa migração:

  1. Migração manual: siga as instruções de migração manual disponíveis no site do Flutter.

  2. Migração automática (experimental): ative um recurso experimental para tratar a migração automaticamente. Ele será ativado por padrão em uma versão futura. Execute o seguinte comando:

bash
flutter config --enable-uiscene-migration

Migrando plugins Flutter

Plugins Flutter que dependem de eventos do ciclo de vida do aplicativo precisam ser atualizados para usar os eventos do ciclo de vida UIScene. Autores de plugins devem consultar o guia de migração. Plugins que não migraram exibirão avisos em uma versão futura.

Migrando Flutter embarcado (opcional)

Para projetos que embutem o Flutter em um app nativo hospedeiro, a migração é opcional, mas altamente recomendada. Adotar as novas APIs de cena do Flutter usando o guia de migração add to app, habilita eventos de ciclo de vida de cena para seus plugins, garantindo compatibilidade com o ecossistema Flutter

Android

Compatibilidade com páginas de 16 KB

Atualizar para o Flutter 3.38 é uma preparação essencial para o requisito de compatibilidade com páginas de 16 KB do Google Play. A partir de 1º de novembro de 2025, apps que têm como alvo o Android 15 ou superior precisam oferecer suporte a páginas de 16 KB. Essa mudança garante que seu app funcione corretamente em dispositivos com muita RAM, oferecendo benefícios de desempenho como inicializações até 30% mais rápidas. O Flutter 3.38 atualiza o ndkVersion padrão do Android para o NDK r28, a versão mínima necessária para que o código nativo alcance o alinhamento correto para o suporte a 16 KB.

Correções de memória

O Flutter 3.38 corrige um vazamento de memória significativo que afetava todos os apps Flutter no Android. O problema (introduzido na 3.29.0) ocorria quando Activities eram destruídas ao sair, conforme configurado nas opções do desenvolvedor, ou quando Activities eram encerradas pelo sistema por falta de memória.

Atualizações de dependências do Android

Muitas vezes é difícil descobrir a combinação certa de versões das dependências do Android que funcionem para o seu app, incluindo Gradle, Android Gradle Plugin (AGP), Kotlin Gradle Plugin (KGP), Java e outras. Para o Flutter 3.38, testamos e confirmamos a compatibilidade no nosso ambiente de integração contínua (CI) com o seguinte conjunto de versões de dependências do Android:

  • Java 17: versão mínima obrigatória para o desenvolvimento Android no Flutter 3.38.

  • KGP 2.2.20: versão máxima conhecida e suportada do Kotlin Gradle Plugin para as ferramentas.

  • AGP 8.11.1: a versão mais recente do Android Gradle Plugin compatível com o KGP 2.2.20.

  • Gradle 8.14: esta versão funciona com as versões escolhidas de Java, KGP e AGP. Observe que o Gradle 8.13 é a versão mínima exigida pelo AGP 8.11.1.

Para garantir que seu aplicativo funcione perfeitamente entre as versões do Flutter, recomendamos fortemente usar as variáveis de nível de API fornecidas pelo SDK do Flutter nos seus arquivos de build. Os valores configurados para esta versão são:

  • flutter.compileSdkVersion (API 36)

  • flutter.targetSdkVersion (API 36)

  • flutter.minSdkVersion (API 24) ou superior

Engine

Overlay de desempenho

O overlay de desempenho foi refatorado para ser mais eficiente, reduzindo seu tempo de renderização tanto nos backends Skia quanto Impeller. Isso significa que você obtém dados de desempenho mais precisos com menos overhead. (#176364)

Vulkan e OpenGL ES

Diversas correções e melhorias nos backends Vulkan e OpenGL ES aumentam a estabilidade e o desempenho em uma gama maior de dispositivos. Isso inclui um melhor tratamento de pipeline caches (#176322), fence waiters (#173085) e transições de layout de imagem (#173884).

Unificação dos renderizadores

O trabalho para unificar os renderizadores CanvasKit e Skwasm continua. Esta versão inclui uma refatoração significativa para compartilhar mais código entre os dois, o que levará a uma experiência mais consistente e a um desenvolvimento mais rápido no futuro (#174588).

Fusão de threads

A opção de desativar a fusão de threads foi removida do iOS e do Android. Para mais informações, confira o vídeo the great thread merge.

DevTools e IDEs

Widget Previews (experimental): atualizações

O Flutter 3.35 introduziu os Widget Previews, um recurso experimental pronto para feedback inicial da comunidade. O Flutter 3.38 traz melhorias significativas nos Widget Previews, incluindo:

  • Integração com IDEs: nossos plugins para VSCode e IntelliJ / Android Studio foram atualizados com suporte inicial para Widget Previews. Agora você pode visualizar seus previews diretamente na IDE, para uma experiência de desenvolvimento mais fluida.
*Widget Previews incorporados no VSCode.*
Widget Previews incorporados no VSCode.

Quando usado dentro de uma IDE, o ambiente de Widget Previews é configurado por padrão para filtrar os previews exibidos com base no arquivo de código-fonte selecionado:

  • Melhorias de tema e controle do ambiente de Widget Previews: o ambiente agora oferece suporte aos modos claro e escuro, além de esquemas de cores personalizados da IDE para combinar com o seu ambiente de desenvolvimento. Os controles do ambiente também foram ajustados para ocupar menos espaço, deixando mais área disponível para renderizar os previews.
*Suporte a tema personalizado para o ambiente de Widget Previews.*
Suporte a tema personalizado para o ambiente de Widget Previews.
  • Extensibilidade de preview: a classe de anotação Preview não está mais marcada como final e agora pode ser estendida para criar anotações Preview personalizadas, reduzindo o código repetitivo em tipos comuns de preview.
*Um exemplo de anotação BrightnessPreview personalizada.*
Um exemplo de anotação BrightnessPreview personalizada.
  • Suporte a MultiPreview: uma nova classe base MultiPreview permite criar múltiplas variações de preview a partir de uma única anotação personalizada.
  • Grupos de preview: um novo parâmetro group na classe Preview permite agrupar previews relacionados.
*Um exemplo de múltiplos previews de “Brightness” em um grupo de previews.*
Um exemplo de múltiplos previews de “Brightness” em um grupo de previews.
  • Menos restrições nos argumentos da anotação @Preview: constantes privadas agora são aceitas como argumentos nas anotações Preview. Argumentos de função (como wrapper e theme) ainda precisam ter nomes públicos e acessíveis estaticamente.

Os Widget Previews ainda são um recurso experimental, e o seu feedback é fundamental para moldar o futuro deles. As APIs e a experiência de uso ainda não são estáveis e vão mudar conforme aprendermos com você.

Com base no feedback inicial, estão planejadas mais melhorias para aprimorar a experiência com Widget Previews, incluindo:

  1. Suporte ao Widget Inspector do Flutter DevTools: o Widget Inspector está sendo atualizado para oferecer suporte à inspeção de previews dentro do ambiente de Widget Previews. Planejamos incorporar o inspector diretamente no visualizador de widgets, tornando-o facilmente acessível independentemente do seu ambiente de desenvolvimento.

  2. Suporte a múltiplos projetos nas IDEs: o visualizador de widgets atualmente só oferece suporte à exibição de previews contidos em um único projeto ou workspace do Pub. Estamos investigando ativamente opções para oferecer suporte a sessões de IDE com múltiplos projetos Flutter (issue #173550).

  3. Melhorias de desempenho na inicialização: estão sendo investigadas oportunidades para reduzir os tempos iniciais de carregamento, incluindo:

    • Iniciar um ambiente de Widget Previews pré-compilado a partir da segunda execução

    • Paralelizar a lógica de detecção de previews para lidar melhor com projetos grandes

Para começar, confira a documentação e nos conte o que você achou!

Observação importante: há um problema conhecido em que o visualizador de widgets pode travar ou parar de atualizar após uma flutter pub get. Se isso acontecer, execute flutter pub get no seu projeto e reinicie a IDE. Veja #178317 para mais detalhes.

Atualizações do DevTools

O Flutter 3.38 traz correções para alguns dos principais pontos de atrito apontados pelos usuários na pesquisa de 2025 sobre o DevTools, incluindo:

Melhorias no painel de rede

  • Tornou mais fácil entender quando o painel está gravando o tráfego de rede. (#9495)

  • Corrigidos problemas ao copiar e colar requisições de rede. (#9472, #9482, #9485, #8588)

Correções no Flutter Inspector

  • Corrigido um bug em que selecionar um widget às vezes abria o código-fonte do framework subjacente em vez do código-fonte do usuário. (#176530)

  • Corrigido um bug que, ocasionalmente, impedia a interação com os botões superiores do painel Inspector. (#9327)

Descontinuações e breaking changes

Esta versão inclui várias descontinuações e breaking changes importantes, como parte do esforço contínuo para modernizar e aprimorar o framework Flutter.

Algumas mudanças de build e de ferramentas podem afetar scripts de build personalizados. O arquivo version na raiz do SDK do Flutter foi removido em favor de um novo arquivo flutter.version.json localizado em bin/cache (#172793). Além disso, o arquivo AssetManifest.json não é mais gerado por padrão (#172594).

Outras mudanças relevantes incluem:

  • Para um comportamento mais previsível, um SnackBar que inclui uma ação não será mais descartado automaticamente (#173084).

  • O construtor OverlayPortal.targetsRootOverlay foi descontinuado em favor do mais flexível OverlayPortal(overlayLocation: OverlayChildLocation.rootOverlay).

  • Várias propriedades de CupertinoDynamicColor, como withAlpha e withOpacity, agora estão descontinuadas em favor dos métodos padrão Color (#171160).

  • O Flutter 3.38 exige Java 17 como versão mínima para Android, alinhando-se ao requisito mínimo do Gradle 8.14 (lançado em julho de 2025).

Para mais detalhes e orientações de migração sobre essas e outras mudanças, confira a página de breaking changes.

Encerramento

O Flutter 3.38 é focado em tornar seu dia a dia de desenvolvimento mais rápido e agradável. Essas melhorias buscam agilizar a forma como você constrói. Somos muito gratos pelo trabalho dedicado e pelo feedback de cada membro da comunidade que contribuiu para esta versão.

Para uma lista completa de todas as mudanças, não deixe de conferir os breaking changes detalhados e as notas de versão. Para ganhar um boost gratuito de produtividade, basta executar flutter upgrade!

Mais do Flutter