Adicione o Firebase ao seu aplicativo Flutter

  • Instale seu editor ou IDE preferido.

  • Configure um dispositivo Apple físico ou use um simulador para executar seu aplicativo.

    Para Cloud Messaging em plataformas Apple, aqui estão os pré-requisitos:

    • Configure um dispositivo Apple físico .
    • Obtenha uma chave de autenticação de notificação push da Apple para sua conta de desenvolvedor Apple .
    • Habilite notificações push no Xcode em App > Capabilities .

  • Certifique-se de que seu aplicativo Flutter seja direcionado às seguintes versões de plataforma ou posteriores:

    • iOS 11
    • macOS 10.13
  • Instale o Flutter para seu sistema operacional específico, incluindo o seguinte:

    • Flutter SDK
    • Bibliotecas de apoio
    • Software e SDKs específicos da plataforma
  • Faça login no Firebase usando sua conta do Google.

Se você ainda não tem um aplicativo Flutter, pode concluir o Primeiros passos: Test Drive para criar um novo aplicativo Flutter usando seu editor ou IDE preferido.

Etapa 1 : Instale as ferramentas de linha de comando necessárias

  1. Se ainda não o fez, instale a Firebase CLI .

  2. Faça login no Firebase usando sua conta do Google executando o seguinte comando:

    firebase login
  3. Instale a CLI do FlutterFire executando o seguinte comando em qualquer diretório:

    dart pub global activate flutterfire_cli

Etapa 2 : configure seus aplicativos para usar o Firebase

Use a CLI do FlutterFire para configurar seus aplicativos Flutter para se conectarem ao Firebase.

No diretório do projeto Flutter, execute o seguinte comando para iniciar o fluxo de trabalho de configuração do aplicativo:

flutterfire configure

O fluxo de trabalho flutterfire configure faz o seguinte:

  • Solicita que você selecione as plataformas (iOS, Android, Web) compatíveis com seu aplicativo Flutter. Para cada plataforma selecionada, a CLI do FlutterFire cria um novo aplicativo Firebase em seu projeto Firebase.

    Você pode optar por usar um projeto Firebase existente ou criar um novo projeto Firebase. Se você já tiver aplicativos registrados em um projeto existente do Firebase, a CLI do FlutterFire tentará combiná-los com base na configuração atual do seu projeto Flutter.

  • Cria um arquivo de configuração do Firebase ( firebase_options.dart ) e o adiciona ao diretório lib/ .

  • (para Crashlytics ou Performance Monitoring no Android) Adiciona os plug-ins Gradle específicos do produto necessários ao seu aplicativo Flutter.


Etapa 3 : inicialize o Firebase em seu aplicativo

  1. No diretório do projeto Flutter, execute o seguinte comando para instalar o plugin principal:

    flutter pub add firebase_core
  2. No diretório do projeto Flutter, execute o seguinte comando para garantir que a configuração do Firebase do seu aplicativo Flutter esteja atualizada:

    flutterfire configure
  3. Em seu arquivo lib/main.dart , importe o plug-in principal do Firebase e o arquivo de configuração que você gerou anteriormente:

    import 'package:firebase_core/firebase_core.dart';
    import 'firebase_options.dart';
  4. Também em seu arquivo lib/main.dart , inicialize o Firebase usando o objeto DefaultFirebaseOptions exportado pelo arquivo de configuração:

    await Firebase.initializeApp(
      options
    : DefaultFirebaseOptions.currentPlatform,
    );
  5. Recrie seu aplicativo Flutter:

    flutter run

Etapa 4 : adicionar plug-ins do Firebase

Você acessa o Firebase em seu aplicativo Flutter por meio dos diversos plug-ins do Firebase Flutter , um para cada produto Firebase (por exemplo: Cloud Firestore, Authentication, Analytics, etc.).

Como o Flutter é uma estrutura multiplataforma, cada plug-in do Firebase é aplicável para plataformas Apple, Android e web. Portanto, se você adicionar qualquer plug-in do Firebase ao seu aplicativo Flutter, ele será usado pelas versões Apple, Android e web do seu aplicativo.

Veja como adicionar um plug-in Firebase Flutter:

  1. No diretório do projeto Flutter, execute o seguinte comando:

    flutter pub add PLUGIN_NAME
  2. No diretório do projeto Flutter, execute o seguinte comando:

    flutterfire configure

    A execução deste comando garante que a configuração do Firebase do seu aplicativo Flutter esteja atualizada e, para Crashlytics e Performance Monitoring no Android, adiciona os plug-ins Gradle necessários ao seu aplicativo.

  3. Depois de concluído, reconstrua seu projeto Flutter:

    flutter run

Está tudo pronto! Seus aplicativos Flutter estão registrados e configurados para usar o Firebase.

Plug-ins disponíveis

produtos Nome do plug-in iOS Android Rede Outra maçã
(macOS, etc.)
janelas
Análise firebase_analytics
beta
Verificação de aplicativo firebase_app_check
beta
Autenticação firebase_auth
beta beta
Cloud Firestore cloud_firestore
beta beta
Funções de nuvem cloud_functions
beta
Mensagens na nuvem firebase_messaging
beta
Armazenamento na núvem firebase_storage
beta beta
Crashlytics firebase_crashlytics
beta
Links Dinâmicos firebase_dynamic_links
Mensagens no aplicativo firebase_in_app_messaging
Instalações do Firebase firebase_app_installations
beta
Downloader de modelo de ML firebase_ml_model_downloader
beta
Monitoramento de desempenho firebase_performance
Banco de dados em tempo real firebase_database
beta
Configuração remota firebase_remote_config
beta

Experimente um aplicativo de exemplo com o Analytics

Como todos os pacotes, o plugin firebase_analytics vem com um programa de exemplo .

  1. Abra um aplicativo Flutter que você já configurou para usar o Firebase (veja as instruções nesta página).

  2. Acesse o diretório lib do aplicativo e exclua o arquivo main.dart existente.

  3. No repositório de programas de exemplo do Google Analytics, copie e cole os dois arquivos a seguir no diretório lib do seu aplicativo:

    • main.dart
    • tabs_page.dart
  4. Execute seu aplicativo Flutter.

  5. Acesse o projeto Firebase do seu aplicativo no Firebase console e clique em Analytics no painel de navegação esquerdo.

    1. Clique em Painel . Se o Analytics estiver funcionando corretamente, o painel mostrará um usuário ativo no painel "Usuários ativos nos últimos 30 minutos" (pode levar algum tempo para preencher esse painel).

    2. Clique em DebugView . Habilite o recurso para ver todos os eventos gerados pelo programa de exemplo.

Para obter mais informações sobre como configurar o Analytics, visite os guias de primeiros passos para iOS+ , Android e Web .

Próximos passos