Novidades do Flutter 3.47

Modular por design: pacotes de UI independentes e Impeller no Desktop

O Flutter 3.47 chegou e, com ele, temos algumas novidades empolgantes.

Hoje, damos as boas-vindas ao lançamento 1.0 dos pacotes independentes material_ui e cupertino_ui. Este é um marco importante, pois desacopla os design systems do SDK principal.

Também estamos impulsionando desempenho e ferramentas em todas as frentes. Esta versão traz o Impeller para o desktop por padrão, prepara nossos pipelines para iOS, macOS e Xcode 27, e torna os Flutter Widget Previews estáveis.

Então, execute flutter upgrade no seu terminal para começar, ou continue lendo para saber mais sobre as principais mudanças desta versão.


Escolha sua própria aventura de UI

O primeiro passo rumo a um Flutter desacoplado chegou: Material e Cupertino agora estão disponíveis como pacotes independentes!

Um dos maiores pontos fortes do Flutter é a capacidade de renderizar widgets Material e Cupertino com pixel perfeito. No entanto, como essas bibliotecas de design eram historicamente embutidas diretamente no SDK principal, isso desacelerava o desenvolvimento delas e dificultava a contribuição ou a atualização.

Embora o SDK principal ainda inclua essas bibliotecas nesta versão, agora você pode optar pelos pacotes independentes material_ui e cupertino_ui que atingiram oficialmente a versão 1.0 em pub.dev.

Roadmaps de design desacoplados (opt-in)

Ao optar pelos design systems desacoplados, você ganha controle sobre o seu roadmap de design. Como material_ui e cupertino_ui agora vivem em pub.dev, eles podem lançar correções de bugs e novos componentes em seus próprios cronogramas semanais, independentemente das versões trimestrais do SDK do Flutter.

Desacoplar os design systems nos traz os seguintes benefícios:

  • Você pode usar os estilos mais recentes de widgets Cupertino e Material sem ser obrigado a atualizar toda a sua versão do SDK do Flutter.
  • Podemos incorporar contribuições e atualizações de forma mais rápida e frequente.
  • Preparamos o terreno para um catálogo de widgets principal do Flutter neutro em estilo, facilitando a criação de design systems personalizados no futuro.

Como migrar

Para migrar seu projeto para os novos pacotes independentes, execute o seguinte comando:

bash
dart fix --apply --code=migrate_design_widgets

Esta ferramenta atualiza automaticamente seus imports de package:flutter/material.dart e package:flutter/cupertino.dart para os novos pacotes independentes.

Observação: se a ferramenta de migração encontrar problemas ao atualizar seus pubspec.yaml (um bug conhecido do início), você pode resolver manualmente executando flutter pub add material_ui (e cupertino_ui, se você usar) e depois executando dart fix --apply mais uma vez.

As bibliotecas de design originais dentro do SDK principal estão programadas para descontinuação formal na próxima versão estável de outono, em novembro. Se você estiver migrando um pacote do ecossistema, trate essa mudança para os pacotes independentes como uma versão major.

Preenchendo a lacuna da migração

Para ajudar a preencher a lacuna enquanto o ecossistema migra para as novas bibliotecas de design independentes, material_ui e cupertino_ui vêm com utilitários de migração. O MaterialUiCompatibilityBridge permite que sua aplicação migre para os pacotes independentes imediatamente, mesmo que algumas das dependências de pacotes ainda usem imports legados do SDK principal.

Por exemplo, você pode envolver seu app na ponte de compatibilidade:

dart
import 'package:material_ui/material_ui.dart';
​
void main() {
  runApp(const MyApp());
}
​
class MyApp extends StatelessWidget {
  const MyApp({super.key});
​
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      theme: ThemeData(
        colorScheme: ColorScheme.fromSeed(seedColor: const Color(0xFF6750A4)),
      ),
      builder: (BuildContext context, Widget? child) {
        return MaterialUiCompatibilityBridge(child: child!);
      },
      home: const HomeScreen(),
    );
  }
}

Localizações desacopladas

Como parte dessa transição, flutter_localizations também foi desempacotado. Os delegates de localização e as strings traduzidas para os widgets Material e Cupertino agora ficam dentro de package:material_ui e package:cupertino_ui, respectivamente.

Antes:

dart
import 'package:flutter_localizations/flutter_localizations.dart';
import 'package:flutter/material.dart';
​
// ...
localizationsDelegates: const <LocalizationsDelegate<dynamic>>[
  GlobalCupertinoLocalizations.delegate,
  GlobalMaterialLocalizations.delegate,
  GlobalWidgetsLocalizations.delegate,
],

Depois:

dart
import 'package:material_ui/material_ui.dart';
​
// ...
localizationsDelegates: GlobalMaterialLocalizations.delegates,

Definir localizationsDelegates como GlobalMaterialLocalizations.delegates agora inclui também os delegates de Cupertino e Widgets, simplificando sua configuração.

Diagrama de arquitetura mostrando o desempacotamento dos pacotes
Estrutura de localização desacoplada

Aberto para contribuições

Ao congelar as contribuições para as bibliotecas Material e Cupertino lá em abril, conseguimos garantir uma migração tranquila. As bibliotecas que esperam por você em material_ui e cupertino_ui são as mesmas bibliotecas que você já está usando.

Agora que estamos prontos para suspender o congelamento, fique de olho em mais correções e recursos sendo lançados regularmente nos novos pacotes, com versões previstas para sair semanalmente. Também estamos animados para abrir oficialmente esses pacotes para contribuições da comunidade.


Preparando a próxima onda de atualizações da Apple

Com o Xcode 27, o iOS 27 e o macOS 27 chegando neste outono, concentramos muitos esforços em garantir que o Flutter esteja pronto para as próximas atualizações. Para que seus usuários não tenham surpresas no primeiro dia, recomendamos testar seus apps com as betas da Apple agora.

Além disso, para oferecer suporte ao Xcode 27, as versões mínimas de sistema operacional foram aumentadas:

PlataformaMínimo anteriorNovo mínimo (Flutter 3.47+)
iOS1315
macOS10.1512

Obrigatoriedade do ciclo de vida UIScene

O iOS 27 SDK agora torna obrigatório o ciclo de vida UIScene para todos os apps baseados em UIKit. Apps criados com o Xcode 27 que não adotarem UIScene não vão abrir na inicialização.

Para a maioria dos apps, a CLI do Flutter faz essa migração automaticamente durante o build. No entanto, a migração manual é necessária se você tiver código nativo personalizado no seu AppDelegate ou usar plugins que ainda dependam do ciclo de vida legado do aplicativo. Nesses casos, você deve migrar manualmente seguindo o Guia de adoção de UIScene/Delegate.

Descontinuando os Macs Intel

Alinhado à transição da Apple para o Apple Silicon, o Flutter está encerrando o suporte aos Macs com processador Intel. Desativamos as execuções automáticas de testes em hardware Intel, e a CLI do Flutter agora exibe avisos ao fazer build em hosts Intel ou ao gerar binários para duas arquiteturas. Esses avisos vão se tornar erros em uma versão futura.

Você pode optar por gerar apps macOS somente ARM64 imediatamente executando flutter config --enable-macos-arm64-only.

Progresso do Swift Package Manager

A comunidade fez um progresso incrível na transição para o Swift Package Manager, com 92 dos 100 principais plugins iOS já migrados. Se você desativou o Swift Package Manager antes, pode tentar novamente executando flutter config --enable-swift-package-manager.

Como o CocoaPods agora está em modo de manutenção, os plugins que não migrarem para o SwiftPM eventualmente deixarão de funcionar. Plugins não migrados também recebem pontuações pub.dev mais baixas. Se você mantém um plugin, consulte o Guia de migração e leia nosso post anterior no blog para mais detalhes.

Esta versão também traz tempos de build otimizados, graças ao colaborador da comunidade @lukemmtt, que melhorou os pipelines de build ao filtrar cedo, no processo de build, os schemes de pacotes SwiftPM desnecessários (#186006).


Definindo o Wasm como padrão

Estamos trabalhando ativamente para habilitar o WebAssembly (Wasm) por padrão em aplicações web Flutter, trazendo desempenho nativo para o navegador. Se você ainda não testou seus apps web com Wasm, pode optar por usá-lo hoje passando a flag --wasm para o comando do seu build de release:

bash
flutter build web --release --wasm

Ao se preparar para essa transição, lembre-se de que o Wasm exige migrar sua base de código para o novo pacote de interop JS (package:web), já que a biblioteca legada dart:html não é suportada. Atualizar as dependências de pacotes do seu projeto costuma resolver esses problemas de interop legados automaticamente.

Para ajudar a escalar aplicações web maiores, esta versão também introduz suporte experimental a carregamento tardio (deferred loading) no Wasm. Disponível sob uma flag no canal main, isso permite dividir sua aplicação Wasm em módulos menores, carregados sob demanda, otimizando os tempos de carregamento inicial:

bash
flutter build web --release --wasm --enable-wasm-deferred-loading

Gráficos modernos chegam ao desktop com o Impeller

Estamos comprometidos em tornar as plataformas desktop alvos de primeira classe para gráficos de alto desempenho. No Flutter 3.47, o Impeller se torna o renderizador padrão para macOS, Windows e Linux.

Se você é novo no Impeller, saiba que ele é o mecanismo de renderização de próxima geração do Flutter, construído do zero para substituir o Skia. Ao mirar APIs de hardware modernas (como Metal no macOS e Vulkan no Windows e Linux), o Impeller compila um conjunto fixo de shaders em tempo de build, em vez de compilá-los dinamicamente em tempo de execução. Isso elimina a breve trepidação chamada jank de compilação de shaders, que acontece na primeira vez em que uma animação é reproduzida, e entrega transições consistentemente suaves desde o primeiro frame. Saiba mais na documentação do mecanismo de renderização Impeller.

Se você precisar desativar temporariamente o Impeller, siga estes passos:

  • macOS: defina FLTEnableImpeller como false em Info.plist.
  • Windows: adicione project.set_impeller_switch(flutter::ImpellerSwitch::Disabled) em main.cpp.
  • Linux: chame fl_dart_project_set_enable_impeller(project, FALSE) em my_application.cc.

As opções de fallback serão removidas em uma versão futura, então registre bugs caso precise voltar a usar o Skia. Além disso, o Wide Gamut Color agora está ativo por padrão no macOS, entregando renderização de cores ricas, vibrantes e precisas em hardware compatível.

Multi-janela experimental em andamento

Em parceria com a Canonical, e graças aos mantenedores @robert-ancell e @mattkae, estamos expandindo nossas APIs experimentais de janelas para desktop. Linux e Windows agora oferecem suporte a janelas pop-up (#185866, #184516), permitindo criar menus de contexto nativos e paletas utilitárias.

Janelas pop-up no Win32
Janelas pop-up no Win32

Você também pode consultar agora windowHandle nos controladores específicos de plataforma para obter um ponteiro direto para a janela nativa subjacente (HWND, NSWindow ou GtkWindow). Isso possibilita acesso avançado a recursos nativos, como painéis acopláveis no Windows, como esta demonstração de painéis acopláveis contribuída por @orestesgaolin:

Demonstração de painéis acopláveis
Demonstração de painéis acopláveis

Também resolvemos vários bugs de foco e de realização de janelas. No Windows, ativar uma janela não traz mais as janelas em segundo plano para frente nem rouba o foco de volta ao retomar o app, graças ao colaborador @9AZX (#188016):

Correção de foco e realização de janela no Windows
Correção de foco e realização de janela

No Linux, a criação de múltiplas janelas agora realiza explicitamente as janelas antes que elas recebam seu primeiro frame do compositor, corrigindo avisos de renderização precoces e asserções do compositor.

Também adicionamos uma nova API de dimensionamento pelo conteúdo, que permite criar janelas regulares e de diálogo que se ajustam automaticamente ao seu conteúdo.

Flavors para desktop

Windows e Linux agora oferecem suporte a flavors do Flutter.

Por exemplo, seu arquivo pubspec.yaml pode usar assets diferentes em cada flavor:

yaml
flutter:
  assets:
    - path: assets/flavor_a/images
      flavors:
        - flavor_a
    - path: assets/flavor_b/images
      flavors:
        - flavor_c

Use a opção --flavor para especificar seu flavor. Por exemplo:

  • flutter build windows --flavor flavor_a
  • flutter build linux --flavor flavor_a

Obrigado a @AngeloAvv pelas excelentes contribuições (#187034, #187029)!

Texto mais nítido no desktop

Telas de desktop costumam ter densidades de pixels menores do que os displays mobile, mas têm mais poder de processamento gráfico. Para entregar texto mais nítido e curvas vetoriais mais limpas no desktop, a engine do Flutter, usando o Impeller, agora utiliza renderização por Signed Distance Function (SDF) no macOS, Linux e Windows.


Previews estáveis e atualizações do GenUI

Widget Previews chega à versão estável

O Flutter Widget Preview agora é estável, permitindo renderizar, inspecionar e iterar rapidamente sobre componentes de UI individuais, sem precisar compilar ou iniciar todo o seu aplicativo.

Com esta versão estável, você pode esperar:

  • Tempos de inicialização mais rápidos graças ao cache local do projeto em uma pasta .widget_preview/, que elimina a sobrecarga repetida de configuração.
  • Testes mais flexíveis com uma API abstrata PreviewThemeData que oferece suporte a camadas sequenciais de tema para matrizes de testes complexas.
  • Sincronização automática de assets da web ao visualizar widgets web, copiando diretamente os assets web/ do seu projeto host, aplicando qualquer tema personalizado ou personalizando seu arquivo index.html automaticamente ao usar Flutter web.

Avanços contínuos no GenUI

O ecossistema do Flutter continua evoluindo para atender às necessidades de desenvolvedores que usam o GenUI para criar novos tipos de experiências agênticas para seus usuários. A versão 0.10.0 do pacote genui foi lançada recentemente, trazendo várias correções e novos recursos, entre eles:

  • Um novo pacote a2ui_core que centraliza as classes relacionadas ao protocolo, incluindo coisas como expressões, entradas de catálogo e muito mais.
  • Suporte às funções do lado do cliente do A2UI, que permitem fornecer ao agente funções que ele pode direcionar ao cliente para validação, valores derivados e outras pequenas tarefas, sem uma viagem de ida e volta.

Refinando a experiência de plataforma

Esta seção destaca melhorias pontuais contribuídas pela comunidade e pela equipe do Flutter para aprimorar a experiência de desenvolvedores e de usuários em todas as plataformas.

Android

No Android, resolvemos um problema do teclado virtual em que teclas modificadoras (como Shift) podiam ficar presas durante os eventos. O responder de teclas agora ignora a síntese de teclas físicas para entradas do teclado virtual, mantendo as interações com o teclado limpas.

Matriz de dependências do Android

Para garantir builds estáveis, o Flutter 3.47 é verificado com as seguintes versões de dependências do Android:

  • Java: 17 (versão mínima exigida)
  • Kotlin Gradle Plugin (KGP): 2.4.0
  • Android Gradle Plugin (AGP): 9.1.0 (a mais recente compatível com o KGP 2.4.0)
  • Gradle: 9.3.1 (mínimo exigido para o AGP 9.1.0)

Para garantir que seu aplicativo continue sendo compilado com sucesso nas próximas versões, recomendamos usar as variáveis padrão de nível de API oferecidas pelo SDK do Flutter nos seus arquivos de build. Nesta versão, elas estão configuradas com os seguintes valores padrão:

  • flutter.compileSdkVersion (API 36)
  • flutter.targetSdkVersion (API 36)
  • flutter.minSdkVersion (API 24)

iOS e macOS

Para desenvolvedores iOS, a assinatura de código agora é mais transparente. Graças ao membro da comunidade @alex-medinsh, a CLI exibe tanto o Team ID quanto o Team Name ao selecionar um certificado (#184665).

Além disso, o membro da comunidade @mozammal-hossain melhorou a solução de problemas ao fornecer mensagens de erro mais claras sobre perfis de provisionamento quando a assinatura falha (#184051).

Desktop

As plataformas desktop também receberam refinamentos pontuais. O posicionamento do cursor (caret) na composição de texto em coreano foi corrigido no Windows (graças a @CHOIgoung, #186353), e plugins do Windows agora podem mover tarefas custosas para fora da thread da plataforma usando FlutterEngine::PostPlatformThreadTask. No Linux, @CodeDoctorDE adicionou suporte à rotação e ao relatório de pressão da caneta stylus (#186831).

Gráficos e engine

Na engine, shaders de fragmento voltados para OpenGLES não precisam mais de inversão condicional de coordenadas ao ler texturas. Isso agora é tratado no vertex shader. Consulte a página de breaking change de render-to-texture do OpenGLES para mais detalhes.

Refinamentos do framework

Por fim, o framework em si está mais suave, com melhorias distribuídas entre componentes-chave:

Acessibilidade e semântica: as configurações de alto contraste e de inversão de cores do Android agora são detectadas automaticamente, graças a @xxxOVALxxx (MediaQueryData.highContrast e MediaQueryData.invertColors, #182263). Spans de texto aninhados dentro de Text.rich agora correspondem à sua sequência de layout na árvore de semântica, e foi adicionado o bloqueio de foco do teclado para BlockSemantics.

Configurações de acessibilidade do Android
Configurações de acessibilidade do Android

Texto e seleção: as alças de seleção de texto em dispositivos móveis agora permanecem estáveis durante rolagens leves, e atalhos de teclado agora podem fechar menus de seleção abertos. No Android, as alças de seleção não ocultam mais o menu de contexto quando posicionadas perto do topo da tela, graças a @JhonaCodes (#182663).

ANTESDEPOIS
Alças de seleção sobrepondo o menu Alças de seleção posicionadas corretamente

Também corrigimos um crash em SelectableRegion quando a seleção começava em um contêiner rolável vazio, e resolvemos artefatos visuais de destaque em texto selecionável com fade, graças a @ikramhasan (#183628).

ANTESDEPOIS
Destaque antes Destaque depois

Gestos e rolagem: melhoramos a propagação de gestos para views nativas do iOS incorporadas via platform views. EdgeDraggingAutoScroller agora respeita o ScrollPhysics da visualização de rolagem ativa, evitando a rolagem automática em listas travadas.

Demonstração do EdgeDraggingAutoScroller
Demonstração do EdgeDraggingAutoScroller

Melhorias no Core Widget: preserve as cores originais dentro de ImageIcon com useOriginalColors: true (#180491), especifique o comportamento de clipping em AnimatedCrossFade (#184545) e acompanhe erros de stream de imagem diretamente com ImageStreamListener.


Pronto para atualizar

Tudo está preparado, e as bases estão prontas. Falta só trazer essas atualizações para a sua máquina local:

bash
flutter upgrade

Enquanto o seu SDK se atualiza em segundo plano, temos uma lição de casa (do tipo divertido) para você:

  • Conheça os colaboradores: pegue a pipoca e assista à nossa nova série de vídeos, Apresentando: Flutter Notable Commits, que celebra os membros da comunidade que tornaram esta versão possível.
  • Confira os detalhes: dê uma olhada rápida na página de Breaking Changes para se preparar para as migrações dos pacotes de UI independentes.

Estamos animados para ver o que vocês vão construir com esta versão nova e aprimorada do Flutter!

Mais do Flutter