Novidades do Flutter 3.16
Material 3 por padrão, prévia do Impeller para Android, extensões do DevTools e muito mais
Novidades do Flutter 3.16
Material 3 por padrão, prévia do Impeller para Android, extensões do DevTools e muito mais
Bem-vindo de volta ao lançamento estável trimestral do Flutter, desta vez para o Flutter 3.16. Esta versão define o Material 3 como o novo tema padrão, traz uma prévia do Impeller para Android, permite adicionar extensões para o DevTools e muito mais! Ela também coincide com atualizações significativas do Flutter Casual Games Toolkit!
Em apenas três meses desde nosso último lançamento, tivemos 928 pull requests mesclados por 145 membros da comunidade, com 40 membros da comunidade criando seu primeiro commit no Flutter!
Continue lendo para conhecer todas as novas adições e melhorias que a comunidade do Flutter contribuiu para este release!
Framework
O Material 3 é o novo padrão
A partir da versão 3.10 (maio de 2023), a biblioteca Material foi atualizada para corresponder à especificação mais recente do Material Design. As mudanças incluem novos componentes, temas de componentes e visuais de componentes atualizados. Antes da versão 3.16, as mudanças eram “opt-in”, com a flag de tema useMaterial3. A partir desta versão, useMaterial3 é true por padrão. (#130764)
Você ainda pode optar pela versão M3 da biblioteca Material especificando useMaterial3: false no seu MaterialApp de tema, mas o Material 2 eventualmente será descontinuado e removido. Além disso, alguns widgets não puderam apenas ser atualizados, mas precisaram de uma implementação completamente nova. Por isso, sua UI pode parecer um pouco estranha ao ser executada como Material 3. Para corrigir isso, migre manualmente para os novos widgets, como NavigationBar. Para mais detalhes, confira a issue guarda-chuva do Material 3 no GitHub.
Um aplicativo de demonstração permite que você experimente todos os componentes. A demo permite alternar useMaterial3 para que você possa comparar as mudanças.
A aparência dos componentes Material 3 é determinada principalmente pelos valores de ThemeData.colorScheme e ThemeData.textTheme. A forma preferida de criar um esquema de cores Material 3 é com ColorScheme.fromSeed(), que cria esquemas claros e escuros esteticamente agradáveis e que atendem aos requisitos de contraste de acessibilidade. Você também pode criar um esquema de cores a partir das cores dominantes em uma imagem com ColorScheme.fromImageProvider. Para personalizar ainda mais a aparência dos componentes Material 3, adicione temas de componentes ao seu ThemeData, como ThemeData.segmentedButtonTheme ou ThemeData.snackBarTheme. Propriedades de tema de componente não nulas sobrescrevem os padrões especificados na documentação da API do componente.

Suporte a motion do Material 3
As melhorias de motion do Material 3 incluem a adição das classes Easing e Durations. As curvas do Material 2 foram renomeadas para incluir a palavra “legacy” e eventualmente serão descontinuadas e removidas. (#129942)
Adicione opções adicionais no menu de edição
No iOS nativo, os usuários agora podem selecionar texto e abrir um menu de compartilhamento que oferece vários serviços padrão. Nesta versão, adicionamos as opções de consulta (look up), pesquisa e compartilhamento.

TextScaler para especificar um fator global de escala de texto
Para oferecer suporte ao recurso de escala de fonte não linear do Android 14 que ajuda pessoas com deficiência visual, a nova classe TextScaler substitui a propriedade Text.textScaleFactor. (#128522)
Atualizações do SelectionArea
O SelectionArea do Flutter foi atualizado para oferecer suporte a gestos nativos associados a um clique simples ou duplo com mouse e a pressionar longamente em dispositivos touch. Esses novos gestos estão disponíveis por padrão com SelectionArea e SelectableRegion.
Clique simples: define a seleção recolhida na posição clicada.
Clique duplo: seleciona a palavra na posição clicada.
Clique duplo + arrastar: estende a seleção em blocos de palavras.

- Pressionar longamente + arrastar: estende a seleção em blocos de palavras.

Itens de menu que operam sobre o widget focado
Esta versão traz uma limpeza das mudanças de foco ao usar itens de menu: a função applyFocusChangesIfNeeded de FocusManager agora restaura o foco do menu — quando o usuário clica em um item de menu, o foco já terá retornado ao item que tinha foco antes de o menu ser aberto. (#130536)
Reordenação automática dos atalhos de itens de menu para iOS e macOS
Apps Flutter em plataformas Mac agora ordenam os modificadores de atalho nos menus para seguir as Apple Human Interface Guidelines. (#129309)
Animação MatrixTransition
Um novo widget MatrixTransition permite transformações ao criar transições animadas. Com base no valor atual da animação, você pode fornecer uma transformação de matriz que é aplicada ao widget filho para criar efeitos como o do GIF a seguir. (Exemplo no DartPad) (#131084)
PaintPattern adicionado ao flutter_test
No pacote flutter_test, a nova classe PaintPattern permite validar chamadas de pintura feitas no canvas por widgets como CustomPainters e Decorations (usados em testes unitários).
Antes, era necessário um golden file para verificar se a cor e o retângulo corretos foram pintados, mas agora você pode usar PaintPattern. O exemplo a seguir verifica que MyWidget pintou um círculo no canvas:
expect(
find.byType(MyWidget),
paints
..circle(
x: 10,
y: 10,
radius: 20,
color: const Color(0xFFF44336),
),
);
// Multiple paint calls can even be chained together.
expect(
find.byType(MyWidget),
paints
..circle(
x: 10,
y: 10,
radius: 20,
color: const Color(0xFFF44336),
),
..image(
image: MyImage,
x: 20,
y: 20,
),
);
Essa API existia antes profundamente nos arquivos de teste do framework, e percebemos que alguns desenvolvedores a acharam tão útil que a copiaram para seus próprios projetos. Se for o seu caso, você pode excluir a cópia do seu projeto após atualizar para o Flutter 3.16.
Atualizações de rolagem
Após o lançamento inicial da fundação de rolagem bidimensional no Flutter 3.13, esta versão traz mais recursos e refinamentos. Com o Flutter 3.16, a fundação 2D agora oferece suporte aos widgets KeepAlive, além de foco padrão na navegação e rolagem implícita. Widgets de rolagem 2D construídos sobre a fundação adotarão esse suporte automaticamente. Para um guia completo sobre como construir sobre a fundação 2D, veja o episódio mais recente do Flutter Build Show.
Logo após o lançamento da 3.13, o pacote two_dimensional_scrollables foi publicado. Esse pacote é mantido pela equipe do Flutter e contém o primeiro de vários widgets de rolagem 2D construídos sobre a fundação do framework — TableView. Desde o lançamento inicial, foram adicionados mais suporte a decoração e estilização, com correções de bugs adicionais.
Engine
Impeller
Android
Nesta versão, temos o prazer de anunciar que o Impeller no Android está pronto para feedback de prévia no canal stable. Desde o início deste ano, a equipe tem trabalhado arduamente em um backend Vulkan para o Impeller, e esta prévia inclui a coleta de feedback sobre as características do Impeller em dispositivos com suporte a Vulkan.
O Impeller ainda não deve ter bom desempenho em dispositivos sem suporte a Vulkan. À medida que trouxermos o backend OpenGL do Impeller à completude de recursos nos próximos meses, também planejamos buscar feedback sobre as características do Impeller nesses dispositivos em uma futura versão estável.
Desenvolvedores Flutter podem testar o Impeller em dispositivos Android com suporte a Vulkan passando a flag --enable-impeller para flutter run, ou adicionando a seguinte configuração ao arquivo AndroidManifest.xml do projeto, sob a tag <application>:
<meta-data
android:name="io.flutter.embedding.android.EnableImpeller"
android:value="true" />
Para determinar se um dispositivo oferece suporte a Vulkan, o Impeller usa os testes discutidos na documentação do repositório do Impeller. Geralmente, o Impeller usa o backend Vulkan em dispositivos com SO de 64 bits e Android API nível 29 ou superior. Os usuários também podem verificar se o dispositivo suporta Vulkan seguindo as orientações em verificando o suporte a Vulkan.
Apesar de estarmos confiantes no progresso que fizemos até agora no backend Vulkan do Impeller, há alguns problemas conhecidos para o período de prévia:
-
Platform views ainda não foram implementadas, e frames que, de outra forma, incluiriam uma platform view têm desempenho um pouco ruim.
Shaders customizados ainda não foram implementados.
-
Para a lista completa de bugs conhecidos e recursos ausentes, as informações mais atualizadas estão no quadro de projeto do Impeller no GitHub. Muitos problemas já têm correções previstas para o beta do 3.17, então experimente também.
Estamos, em geral, satisfeitos com nosso progresso em fidelidade e desempenho do Impeller nos dispositivos Android com suporte a Vulkan que testamos. No entanto, em comparação com o iOS, o ecossistema de hardware Android é muito mais diverso, e prevemos um período de prévia mais longo para Android do que para iOS antes de torná-lo o backend padrão no canal stable. Por isso, o feedback mais útil sobre o Impeller deve incluir informações detalhadas sobre o dispositivo específico e a versão do Android em que os problemas ocorreram.
Além disso, o backend Vulkan do Impeller habilita recursos de depuração adicionais em builds de “debug” além do que é usado com o Skia, e esses recursos têm sobrecarga adicional em tempo de execução. Por isso, é importante que o feedback sobre o desempenho do Impeller venha de um build de profile ou de release e inclua linhas do tempo do DevTools e uma comparação com o backend Skia no mesmo dispositivo. Por fim, como sempre, agradecemos muito feedback que inclua um caso de teste pequeno e reproduzível que demonstre o problema.
Desempenho, fidelidade e estabilidade do Impeller
Além do foco no backend Vulkan, desde o início do ano a equipe também fez várias melhorias de desempenho de texto no Impeller que beneficiam Android e iOS. Em particular, melhoramos o gerenciamento do glyph atlas do Impeller e a forma como as cargas de trabalho de texto são divididas entre as threads de UI e de raster da engine. Como resultado, os usuários notarão menos jank em cargas de trabalho com muito texto.
A equipe também tem se dedicado a melhorias de fidelidade e estabilidade para Android e iOS, especialmente as relatadas pelos usuários. Em particular, nos três meses deste ciclo de lançamento estável, a equipe fez 209 commits relacionados ao Impeller no repositório flutter/engine, fechando 217 issues, incluindo 42 relatos de usuários sobre problemas de fidelidade, estabilidade ou performance.
Performance do engine
Para oferecer melhor performance em dispositivos móveis com multiprocessamento heterogêneo, modificamos o engine para que as threads sensíveis à performance, como as threads de UI e de raster, tenham afinidade com os núcleos mais potentes do dispositivo. Observamos que essa mudança teve um impacto positivo em uma série de benchmarks e dispositivos. Em alguns casos, a melhoria foi expressiva, reduzindo pela metade ou mais os tempos de frame nos percentis 99% e 90%. Esperamos que os usuários percebam menos jank após essa mudança, tanto com o backend Skia quanto com o Impeller, no Android. O efeito é menos dramático no iOS, onde a diferença entre os núcleos mais potentes e os menos potentes é menor.
Melhorias de API e fidelidade
Overlay de performance do Impeller
Em releases anteriores, o overlay de performance do Flutter não era exibido com o Impeller. Esta versão corrige esse problema. O overlay de performance agora é exibido corretamente com o Impeller habilitado.
O dithering agora é exibido corretamente
Nesta versão, a propriedade Paint.enableDithering é definida como true e está descontinuada, conforme a política de descontinuação do Flutter. O dithering agora vem habilitado por padrão (o dithering configurável pelo desenvolvedor não é mais suportado), e você não verá mais problemas de banding. Para a explicação completa dessa mudança e o guia de migração, veja a página de breaking change
na docs.flutter.dev.
Jogos
Flutter Games Toolkit
Nos últimos anos, vimos crescer uma comunidade em torno do desenvolvimento de jogos casuais. Dezenas de milhares de jogos já foram publicados com Flutter, de quebra-cabeças simples e divertidos a jogos de arcade mais complexos. Alguns dos nossos favoritos são o Trivia Crack, da Etermax; o 4 Pics 1 Word, da Lotum (jogo de adivinhar palavras); o Brick Mania, da Dong Digital (jogo de arcade); o StopotS, da Onrizon (jogo de categorias); o jogo de pinball retrô que criamos em Flutter para o I/O; e o PUBG mobile, que usa Flutter nas telas sociais e de menu.

Para ajudar desenvolvedores de jogos a ganhar produtividade, hoje o Flutter lança uma grande atualização do seu Casual Games Toolkit. É uma coleção de novos recursos para ajudar você a ir do conceito ao lançamento, com templates específicos por gênero, como um jogo de cartas e um endless runner, além de integrações com serviços como Play Games Services, compras no app, anúncios, conquistas, Crashlytics e suporte a multiplayer. Para saber mais, confira o post de lançamento do games toolkit escrito por Zoey Fan.
Web
Eventos de timeline do Flutter no Chrome DevTools
Os eventos de Timeline do Flutter agora são expostos no painel de performance do Chrome DevTools. (#130132)
Para saber mais, confira Depurando performance em apps web.

Android
Suporte à roda de rolagem do mouse
Ao otimizar o Wonderous para atender às diretrizes do Android para telas grandes, encontramos um problema: a roda de rolagem do mouse não funcionava bem em tablets ou dispositivos dobráveis. Era bem conhecido que o usuário precisava girar a roda de rolagem por uma distância grande para a tela responder.
Com esta versão, a rolagem com mouse em uma view do Flutter passa a ter a mesma velocidade dos dispositivos Android. (44724)
Navegação preditiva de volta
O Android 14 incluiu o recurso de gesto de voltar preditivo, que permite usar o gesto de voltar do dispositivo para “espiar” a tela inicial atrás da tela atual. Esta atualização traz gestos de voltar preditivos para o Flutter! Confira o guia de migração.

iOS
Extensões de app
Agora o Flutter pode ser usado para criar extensões de app do iOS. Isso significa que você pode desenhar a UI de certos tipos de extensões de app do iOS usando widgets do Flutter. Isso não funciona para todos os tipos de extensão, pois pode haver limitações da API (por exemplo, widgets de tela inicial) ou de memória.

Saiba mais e veja um exemplo de como segmentar a extensão de Compartilhamento em Adicionando extensões de app do iOS na docs.flutter.dev.
Ecossistema de pacotes
Novos Flutter Favorites
Reiniciamos o programa Flutter Favorite! Neste ciclo, o Comitê do Ecossistema Flutter designou os pacotes flame, flutter_animate, flutter_rust_bridge, riverpod, video_player, macos_ui e fpdart como novos Flutter Favorites. Parabéns a todos!
Fique de olho em novos Flutter Favorites no futuro. Para indicar um pacote ou plugin como possível futuro Flutter Favorite, ou para levar qualquer outra questão à atenção do comitê, envie um e-mail para o comitê em flutter-committee@googlegroups.com.

Primeiro summit virtual do ecossistema de pacotes
Em agosto, realizamos pela primeira vez um summit virtual do ecossistema de pacotes, com a participação de mais de 50 colaboradores, Googlers e não-Googlers, do pub.dev. O objetivo foi reunir os colaboradores em discussões no estilo unconference para planejar, ensinar, aprender e compartilhar com a comunidade. A satisfação com o evento foi de 100% em uma pesquisa pós-evento. Planejamos fazer parcerias com a comunidade em eventos semelhantes para o ecossistema de pacotes, presenciais e virtuais, no futuro. Saiba mais em uma próxima publicação do blog sobre o ecossistema de pacotes.
Estilo de mapa baseado em nuvem no Google Maps
A Google Maps Platform permite personalizar o estilo do seu mapa na página Map Styles do Google Cloud Console. Isso permite criar uma experiência personalizada sem precisar atualizar o código do app a cada mudança de estilo.

Para usar esse recurso no Flutter, basta referenciar seu mapa pelo Map ID definido no console:
GoogleMap(
onMapCreated: _onMapCreated,
initialCameraPosition: const CameraPosition(
target: _kMapCenter,
zoom: 7.0,
),
key: _key,
cloudMapId: _mapId
);
Melhorias no Camera X
Na versão estável 3.10, adicionamos suporte preliminar ao Camera X no plugin de câmera do Flutter. Camera X é uma biblioteca Jetpack que simplifica a adição de funcionalidades avançadas de câmera ao seu app Android.
Com esta versão, adicionamos a maioria dos recursos necessários para qualquer app que use câmera. O CameraX resolve muitos problemas que existem na implementação do Camera 2 no plugin.
Recomendamos que você use o plugin CameraX. Para ativá-lo, adicione a seguinte linha ao seu arquivo pubspec.yaml.
dependencies:
camera: ^0.10.4 # Or try the latest camera version
camera_android_camerax: ^0.5.0
Adoraríamos receber seu feedback, pois planejamos tornar o CameraX a implementação padrão em uma versão futura.
Video player para macOS
Adicionamos suporte a macOS ao plugin video player, permitindo que desenvolvedores reproduzam vídeos em uma superfície de widget.
Para saber mais, confira o plugin video player no pub.dev.
DevTools
Extensões do DevTools
O novo framework de extensões do DevTools permite:
-
que autores de pacotes criem ferramentas personalizadas para o seu pacote, exibidas diretamente no DevTools.
-
que autores de pacotes criem ferramentas poderosas que aproveitam frameworks e utilitários já existentes no DevTools.
-
que desenvolvedores Dart e Flutter que estão depurando um app com o DevTools tenham acesso a ferramentas específicas para os seus casos de uso (determinadas pelas dependências do app e pelos pacotes que fornecem extensões do DevTools).
Graças aos autores dos pacotes Provider, Drift e Patrol, esse ecossistema já está sendo construído, e você já pode usar as extensões do DevTools desses pacotes hoje!
Para um mergulho profundo nas extensões do DevTools, confira o anúncio das extensões do DevTools para Dart e Flutter escrito por Kenzie Davisson.
Atualizações do DevTools
Alguns destaques do DevTools nesta versão são:
Adicionado suporte a extensões do DevTools
Adicionada uma nova tela “Home” que mostra um resumo do seu app conectado.

Outras melhorias incluem:
Performance geral
Robustez do hot restart
Comportamento de seleção e cópia de texto
Refinamentos no visualizador de respostas do network profiler
Para saber mais, confira as notas de versão do DevTools 2.26.1, 2.27.0, e 2.28.1.
Descoberta da UI no VS Code
Graças ao trabalho incrível do membro da comunidade Flutter DanTup, a extensão do Flutter para VS Code agora tem uma barra lateral do Flutter que dá acesso fácil a:
Abrir telas do Flutter DevTools
Ver sessões de debug ativas
Ver dispositivos disponíveis
Criar novos projetos
Hot reload e restart
Executar o Flutter Doctor -v
E muito mais

Descontinuações e breaking changes
Descontinuações e breaking changes
As breaking changes desta versão incluem APIs descontinuadas que expiraram após o lançamento da v3.13. Para ver todas as APIs afetadas, junto com contexto adicional e orientações de migração, veja o guia de descontinuações desta versão. Muitas delas são suportadas pelo Flutter fix, incluindo correções rápidas na IDE. Correções em massa podem ser avaliadas e aplicadas com o comando
dart fix.
Como sempre, muito obrigado à comunidade por contribuir com testes — eles nos ajudam a identificar essas breaking changes. Para saber mais, confira a política de breaking changes do Flutter.
Na próxima versão, planejamos estender a política de descontinuação para cobrir o pacote flutter_driver
além dos pacotes já suportados, flutter e flutter_test.
Conclusão
Mencionamos o número de colaboradores no início deste anúncio de propósito. O Flutter não seria o toolkit encantador e produtivo que é hoje sem o esforço de todos vocês, nossa incrível comunidade. Muito obrigado.
Para a lista completa de PRs incluídos nesta versão, confira as notas de versão e o changelog.
O Flutter 3.16 está disponível hoje no canal stable e inclui o Dart 3.2. Para começar a usar essas novidades, basta executar o
flutter upgrade.
Até breve!