Coloque o Flutter para trabalhar

Conecte um recurso Flutter a um app nativo e coloque tudo para funcionar em poucas linhas de código

Uma caixa de diálogo de feedback do Flutter, com escala de avaliação de cinco pontos e um botão Enviar, sobrepõe um feed de notícias.

Se você já quis experimentar o Flutter, mas não quer construir algo do zero, a funcionalidade add-to-app do Flutter é um ótimo ponto de partida. Para tornar ainda mais fácil colocar o Flutter para trabalhar por você, fizemos uma parceria com a equipe do Flutter para criar um protótipo de exemplo de add-to-app que mostra como o Flutter pode ser integrado a uma base de código nativa com esforço mínimo. Seja para fazer um teste rápido com o Flutter ou para mostrar à sua equipe como ele funciona de forma tangível, este artigo é para você!

Adicionando Flutter a um app nativo de feed de notícias

Neste tutorial, mostramos como pegar um recurso do Flutter e, usando a API add-to-app do Flutter, incorporá-lo a um app nativo em apenas algumas linhas.

O projeto que vamos analisar é dividido em duas partes. A primeira parte contém três aplicações de feed de notícias idênticas para três plataformas nativas diferentes: Android, iOS e web. O app é interativo, então você pode executá-lo em um dispositivo, rolar pelos artigos, clicar nas notícias e muito mais. A segunda parte do projeto é uma caixa de diálogo que aparece durante a interação com o app e pede que as pessoas usuárias enviem feedback. Este recurso, que chamaremos de módulo NPS (Net Promoter Score), é construído com Flutter.

Primeiro, acesse o repositório de exemplo. Ali você verá uma pasta para cada plataforma, contendo o código nativo do app de feed de notícias. Também no repositório está a flutter_nps, uma pasta que contém todo o código Flutter do módulo NPS.

Adicionando Flutter na web com Angular

O módulo Flutter roda como um <iframe> dentro do app web nativo. Para integrar o recurso à base de código Angular, primeiro execute um build do Flutter para o alvo web. Essa etapa gera um index.html e outros arquivos necessários. Copie todos os arquivos de build para a pasta src do app Angular. A partir daí, você pode referenciar os arquivos de build dentro do iframe. Na próxima vez que você executar o app web, verá o recurso Flutter!

Veja o README com as instruções completas.

Adicionando Flutter ao Android com Kotlin

Agora vamos adicionar o módulo NPS ao app Android. Primeiro, inicie uma activity do Flutter usando uma engine em cache. Assim que você abre o app de notícias nativo, a engine do Flutter começa a aquecer em segundo plano. Depois, você inicia uma nova activity e a aponta para a activity do Flutter. Isso garante uma transição rápida do código Kotlin nativo para o Flutter e permite que o recurso Flutter funcione perfeitamente dentro do app Android.

Veja o README com as instruções completas.

Adicionando Flutter no iOS com SwiftUI

Por fim, podemos adicionar o módulo NPS ao app iOS. Primeiro, incorpore o módulo Flutter compilado ao seu aplicativo nas configurações de build do Xcode. Depois, no seu application delegate, crie uma instância da engine do Flutter e inicie-a. Com isso feito, você está pronto para exibir a UI do Flutter onde for necessário: basta criar um FlutterViewController usando a engine do Flutter e apresentá-lo. Depois, execute flutter build ios-framework com o caminho.

Veja o README com as instruções completas.

Coloque o Flutter para trabalhar por você (e pela sua equipe!)

Agora que o código Flutter está em execução no seu app, você pode experimentar algumas das partes divertidas do Flutter. As seções a seguir incluem algumas ideias para começar.

Suporte a múltiplas plataformas

Neste exemplo de feed de notícias, você pode ver como o módulo NPS lida com as diferenças entre plataformas. Na web, o módulo aparece como uma caixa de diálogo sobre o feed de notícias e reage a entradas de mouse ou leitor de tela. No mobile, o módulo ocupa a tela inteira e reage a entradas por toque ou leitor de tela.

Observe que o módulo NPS do Flutter contém widgets Material, que tratam automaticamente a detecção de gestos, dependendo do dispositivo da pessoa usuária. Em um dispositivo desktop, o app recebe entradas de mouse e, em um dispositivo mobile, recebe entradas de toque.

Animações

Este protótipo inclui algumas animações implícitas que são fáceis de ajustar, pois já vêm integradas ao framework Flutter. Por exemplo, se você quiser fazer mudanças no widget AnimatedContainer, basta ajustar suas propriedades, como a duração da animação, a altura do container, o formato e a cor.

dart
// ...
return AnimatedContainer(
  duration: duration,
  height: Spacing.huge,
  decoration: BoxDecoration(
    shape: BoxShape.circle,
    color: isSelected
      ? NpsColors.colorSecondary
      : NpsColors.colorGrey5,
  ),
  // ...
);

O módulo NPS inclui uma transição de animação de página personalizada. Dê uma olhada no widget SlideTransition para outro exemplo de animação, que pode ser personalizado atualizando sua duração e outros elementos.

dart
SlideTransition(
  position: Tween<Offset>(
    begin: const Offset(0, 1),
    end: Offset.zero,
  ).animate(animation),
  child: child,
);

Se você quiser levar suas animações para o próximo nível, pode importar o pacote animations do pub.dev e usar algumas das animações prontas e sofisticadas.

Theming

Também é simples atualizar o tema do módulo NPS. Como ele usa o tema Material integrado por meio de ThemeData, você pode simplesmente atualizar as cores, o estilo dos botões e a fonte em um único lugar. Por exemplo, para mudar o accentColor e o backgroundColor do módulo NPS com Flutter, basta escolher a cor desejada usando as variações da paleta de cores Material fornecidas, ou suas próprias cores personalizadas.

dart
class AppTheme {
  ThemeData get theme =>
      ThemeData(
        colorScheme: ColorScheme.fromSwatch(
          accentColor: NpsColors.colorSecondary,
          backgroundColor: NpsColors.colorWhite,
        ),
        scaffoldBackgroundColor: NpsColors.colorWhite,
        elevatedButtonTheme: ElevatedButtonThemeData(
          style: ElevatedButton.styleFrom(
            primary: NpsColors.colorSecondary,
            shape: RoundedRectangleBorder(
              borderRadius: BorderRadius.circular(24),
            ),
          ).copyWith(
            backgroundColor: MaterialStateProperty.resolveWith<Color?>(
              (Set<MaterialState> states) {
                if (!states.contains(MaterialState.disabled)) {
                  return NpsColors.colorSecondary;
                } else if (states.contains(MaterialState.disabled)) {
                  return NpsColors.colorWhite;
                }
                return null;
              },
            ),
          ),
        ),
        textTheme: const TextTheme(
          headline5: NpsStyles.headline5,
          subtitle1: NpsStyles.subtitle1,
          bodyText2: NpsStyles.link,
        ),
      );
}

Recursos adicionais

O módulo NPS do Flutter usa flutter_bloc para gerenciamento de estado e acompanhar a resposta de pontuação da pessoa usuária. O Cubit é uma das muitas opções de gerenciamento de estado ao construir apps Flutter. O recurso também inclui testes unitários e de widget, que são ferramentas úteis para garantir que o código que você está escrevendo funcione como esperado. Por fim, a base de código tem suporte a localização para 78 idiomas nativamente. Este projeto tem integração com GitHub Actions para integração contínua para executar as etapas de formatação, lint e testes antes de mesclar mudanças.

Backend

Embora este protótipo não interaja atualmente com um backend, você pode configurá-lo com um backend de sua escolha para armazenar os dados do módulo NPS ou até buscar artigos de exemplo para o feed de notícias nativo. Uma opção a explorar é o Firebase, que se integra perfeitamente com o Flutter. Veja a documentação do Firebase para adicionar o Firebase ao seu app Flutter.

Agora que você sabe como adicionar um recurso Flutter a uma base de código web, Android e iOS nativa, pode seguir um processo semelhante para integrar o recurso a qualquer app nativo. Veja a documentação completa do add-to-app para mais informações.

Confira o código completo no repositório open source aqui.

Mais do Flutter