Adicionar o Firebase ao seu app Flutter

Pré-requisitos

Instale o editor ou o ambiente de desenvolvimento integrado de sua preferência.
Instale o Flutter no seu sistema operacional específico e inclua o seguinte:
- SDK do Flutter
- Bibliotecas de suporte
- Software e SDKs específicos da plataforma
Faça login no Firebase usando sua Conta do Google.

Se você ainda não tem um app Flutter, conclua os Primeiros passos: test drive para criar um novo app Flutter usando o editor ou ambiente de desenvolvimento integrado de sua preferência.

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

Caso ainda não tenha feito isso, instale a CLI Firebase.
Faça login no Firebase com sua Conta do Google executando o seguinte comando:
```
firebase login
```
Instale a CLI do FlutterFire executando o seguinte comando em qualquer diretório:
```
dart pub global activate flutterfire_cli
```

Etapa 2: configurar os apps para usar o Firebase

Use a CLI do FlutterFire para configurar seus apps do Flutter e se conectar ao Firebase.

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

flutterfire configure

O que o fluxo de trabalho flutterfire configure faz?

O fluxo de trabalho flutterfire configure faz o seguinte:

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

Você pode usar um projeto do Firebase ou criar um novo. Se você já tiver apps registrados em um projeto do Firebase, a CLI do FlutterFire vai tentar fazer a correspondência com base na configuração atual do projeto do Flutter.

Observação: veja algumas dicas sobre como configurar e gerenciar seu projeto do Firebase:

Confira nossas práticas recomendadas para adicionar apps a um projeto do Firebase, incluindo como lidar com diversas variantes.

Ative o Google Analytics no projeto. Isso possibilita uma experiência ideal usando vários produtos do Firebase, como Crashlytics e Remote Config.

Crie um arquivo de configuração do Firebase (firebase_options.dart) e adicione ele ao diretório lib/.

Observação: esse arquivo de configuração do Firebase contém identificadores exclusivos, mas não secretos, para cada plataforma selecionada.
Acesse Noções básicas sobre projetos do Firebase para saber mais sobre esse arquivo de configuração.

(para Crashlytics ou Performance Monitoring no Android) Adiciona o necessário Plug-ins do Gradle específicos do produto ao app Flutter.

Observação: para que a CLI do FlutterFire adicione o plug-in apropriado do Gradle, o plug-in do Flutter do produto já precisa estar importado no app do Flutter.

Depois dessa primeira execução de flutterfire configure, execute o comando novamente sempre que você:

começar a oferecer suporte a uma nova plataforma no seu app do Flutter;
Comece a usar um novo serviço ou produto do Firebase no seu app Flutter. especialmente se você começa a usar o recurso Fazer login com o Google, Crashlytics, Performance Monitoring ou Realtime Database.

Executar o comando novamente garante que a configuração do Firebase do seu app do Flutter esteja atualizada e, para Android, adiciona automaticamente todos os plug-ins do Gradle necessários ao app.

Etapa 3: inicializar o Firebase no app

No diretório do projeto do Flutter, execute o seguinte comando para instalar o plug-in principal:
```
flutter pub add firebase_core
```
No diretório do projeto do Flutter, execute o seguinte comando para garantir que a configuração do app criado com o Flutter do Firebase esteja atualizada:
```
flutterfire configure
```
No arquivo lib/main.dart, importe o plug-in principal do Firebase e o arquivo de configuração gerado antes:
```
import 'package:firebase_core/firebase_core.dart';
import 'firebase_options.dart';
```

Ainda no arquivo lib/main.dart, inicialize o Firebase usando o objeto DefaultFirebaseOptions exportado pelo arquivo de configuração:

WidgetsFlutterBinding.ensureInitialized();
await Firebase.initializeApp(
  options: DefaultFirebaseOptions.currentPlatform,
);
runApp(const MyApp());

Recrie o aplicativo do Flutter:
```
flutter run
```

Se preferir usar um projeto de demonstração, inicie o Emulador do Firebase e no arquivo lib/main.dart, inicialize o Firebase usando demoProjectId (deve começar com demo-):

  await Firebase.initializeApp(
    demoProjectId: "demo-project-id",
  );

Etapa 4: adicionar plug-ins do Firebase

É possível acessar o Firebase no app do Flutter usando os vários plug-ins do Firebase para o Flutter, um para cada produto do Firebase, como Cloud Firestore, Authentication, Analytics etc.

Como o Flutter é um framework multiplataforma, cada plug-in do Firebase é aplicável a plataformas da Apple, do Android e da Web. Por isso, qualquer plug-in do Firebase adicionado ao seu app do Flutter será usado pelas versões para Apple, Android e Web do seu app.

Veja como adicionar um plug-in do Firebase ao Flutter:

No diretório do projeto do Flutter, execute o seguinte comando:
```
flutter pub add PLUGIN_NAME
```
No diretório do projeto do Flutter, execute o seguinte comando:
```
flutterfire configure
```
A execução desse comando garante que a configuração do Firebase do seu app criado com o Flutter esteja atualizada e, para o Crashlytics e o Performance Monitoring no Android, adicione os plug-ins necessários do Gradle ao app.
Após a conclusão, recrie seu projeto do Flutter:
```
flutter run
```

Está tudo pronto! Agora seus apps do Flutter estão registrados e configurados para usar o Firebase.

Plug-ins disponíveis

Produto	Nome do plug-in	Outra da Apple (como o macOS)	Windows
Analytics	`firebase_analytics`	beta
App Check	`firebase_app_check`	beta
Authentication	`firebase_auth`	beta	beta
Cloud Firestore	`cloud_firestore`	beta	beta
Cloud Functions	`cloud_functions`	beta
Cloud Messaging	`firebase_messaging`	beta
Cloud Storage	`firebase_storage`	beta	beta
Crashlytics	`firebase_crashlytics`	beta
Data Connect	`firebase_data_connect`
Dynamic Links	`firebase_dynamic_links`
In-App Messaging	`firebase_in_app_messaging`
Firebase Instalações	`firebase_app_installations`	beta
Download de modelos de ML	`firebase_ml_model_downloader`	beta
Performance Monitoring	`firebase_performance`
Realtime Database	`firebase_database`	beta
Remote Config	`firebase_remote_config`	beta
Vertex AI in Firebase	`firebase_vertexai`	beta

Testar um aplicativo de exemplo com o Analytics

Como todos os pacotes, o plug-in firebase_analytics vem com um programa de exemplo.

Abra um app Flutter que você já configurou para usar o Firebase. Veja instruções nesta página.
Acesse o diretório lib do aplicativo e exclua o arquivo main.dart atual.
No repositório de programas de exemplo do Google Analytics, copie e cole os dois arquivos abaixo no diretório lib do seu app:
- main.dart
- tabs_page.dart
Execute seu app Flutter.
Acesse o projeto do Firebase do seu app no console do Firebase e clique em Analytics no menu de navegação à esquerda.
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 que esse painel seja preenchido.
2. Clique em DebugView. Ative o recurso para ver todos os eventos gerados pelo programa de exemplo.

Saiba mais sobre como configurar o Analytics nos guias para iniciantes para iOS+, Android e Web.

Próximas etapas

Aprenda a usar o Firebase Flutter Codelab na prática.
Prepare-se para lançar seu aplicativo:
- Configure os alertas de orçamento para seu projeto no console Google Cloud.
- Monitore o painel Uso e faturamento no console do Firebase para ter uma visão geral do uso do projeto em vários serviços do Firebase.
- Consulte a checklist de lançamento do Firebase.