Adicionar o Firebase ao seu projeto para Android

Pré-requisitos

  • Instale ou atualize o Android Studio para a versão mais recente.

  • Certifique-se de que seu projeto atenda aos seguintes requisitos (alguns produtos podem ter requisitos mais rigorosos):

    • Visa o nível 21 da API (Lollipop) ou mais recente.
    • Usa o Android 5.0 ou versões mais recentes
    • Usa o Jetpack (AndroidX), que inclui o cumprimento dos seguintes requisitos de versão:
      • com.android.tools.build:gradle v7.3.0 ou mais recente
      • compileSdkVersion 28 ou posterior

  • Configure um dispositivo físico ou use um emulador para executar o app.
    Os SDKs do Firebase com uma dependência no Google Play Services exigem que o dispositivo ou o emulador tenham o Google Play Services instalado.

  • Faça login no Firebase com sua Conta do Google.

Se você ainda não tem um Projeto do Android, mas quer testar um produto do Firebase, faça o download de uma das nossas amostras introdutórias.


É possível conectar seu app Android ao Firebase usando uma das opções a seguir:

  • Opção 1: (recomendado) usar o Fluxo de trabalho de configuração do console do Firebase.
  • Opção 2: usar o Firebase Assistente do Android Studio (pode exigir configuração adicional).


Opção 1: adicionar o Firebase usando o Console do Firebase

A adição do Firebase ao seu projeto do Unity envolve tarefas no console do Firebase e no projeto do Android aberto (por exemplo, você faz o download dos arquivos de configuração do Firebase a partir do console e os move para o projeto do Android).

Etapa 1: criar um projeto do Firebase

Antes de adicionar o Firebase ao seu app Android, é preciso criar um projeto do Firebase e depois conectá-lo ao seu aplicativo. Para saber mais, consulte Noções básicas sobre projetos do Firebase.

Etapa 2: registrar seu app com o Firebase

Para usar o Firebase no seu app Android, é necessário registrá-lo no projeto do Firebase. Registrar o app também quer dizer "adicionar" o app ao projeto.

  1. Acesse o console do Firebase,

  2. No centro da página de visão geral do projeto, clique no ícone do Android () ou em Adicionar app para iniciar o fluxo de trabalho de configuração.

  3. Digite o nome do pacote do app no campo Nome do pacote Android.

  4. (Opcional) Insira outras informações do aplicativo: apelido do app e certificado de assinatura SHA-1 de depuração.

  5. Clique em Registrar app.

Etapa 3: adicionar um arquivo de configuração do Firebase

  1. Faça o download e adicione o arquivo de configuração do Firebase (google-services.json) do app à base de código:

    1. Clique em Fazer o download do google-services.json para receber o arquivo de configuração do Firebase do app.

    2. Mova esse arquivo para o diretório raiz do módulo (nível do app) do seu aplicativo.

  2. Para permitir que os SDKs do Firebase acessem os valores no seu arquivo de configuração google-services.json, você precisa do plug-in do Gradle para Serviços do Google (google-services).

    1. No arquivo Gradle no nível raiz do projeto (<project>/build.gradle.kts ou <project>/build.gradle), adicione o plug-in dos serviços do Google como uma dependência:

      Kotlin 

      plugins {
  id("com.android.application") version "7.3.0" apply false
  // ...

  // Add the dependency for the Google services Gradle plugin
  id("com.google.gms.google-services") version "4.4.3" apply false
}

      Groovy 

      plugins {
  id 'com.android.application' version '7.3.0' apply false
  // ...

  // Add the dependency for the Google services Gradle plugin
  id 'com.google.gms.google-services' version '4.4.3' apply false
}

    2. No arquivo Gradle do módulo (nível do app) (geralmente <project>/<app-module>/build.gradle.kts ou <project>/<app-module>/build.gradle), adicione o plug-in dos Serviços do Google:

      Kotlin 

      plugins {
  id("com.android.application")

  // Add the Google services Gradle plugin
  id("com.google.gms.google-services")
  // ...
}

      Groovy 

      plugins {
  id 'com.android.application'

  // Add the Google services Gradle plugin
  id 'com.google.gms.google-services'
  // ...
}

Etapa 4: adicionar SDKs do Firebase ao seu app

  1. No arquivo Gradle do módulo (nível do app) (geralmente <project>/<app-module>/build.gradle.kts ou <project>/<app-module>/build.gradle), adicione as dependências dos produtos do Firebase que você quer usar no seu app. Recomendamos usar Firebase Android BoM para gerenciar o controle de versões das bibliotecas.

    Analytics ativado 

    dependencies {
  // ...

  // Import the Firebase BoM
  implementation(platform("com.google.firebase:firebase-bom:33.16.0"))

  // When using the BoM, you don't specify versions in Firebase library dependencies

  // Add the dependency for the Firebase SDK for Google Analytics
  implementation("com.google.firebase:firebase-analytics")

  // TODO: Add the dependencies for any other Firebase products you want to use
  // See https://firebase.google.com/docs/android/setup#available-libraries
  // For example, add the dependencies for Firebase Authentication and Cloud Firestore
  implementation("com.google.firebase:firebase-auth")
  implementation("com.google.firebase:firebase-firestore")
}

    Com o Firebase Android BoM, seu app sempre vai usar versões compatíveis das bibliotecas do Firebase para Android.

    Está procurando um módulo de biblioteca específico do Kotlin? A partir de outubro de 2023 (Firebase BoM 32.5.0), os desenvolvedores Kotlin e Java poderão depender do módulo da biblioteca principal. Para mais detalhes, consulte Perguntas frequentes sobre essa iniciativa.

    Analytics não ativado

    dependencies {
  // ...

  // Import the Firebase BoM
  implementation(platform("com.google.firebase:firebase-bom:33.16.0"))

  // When using the BoM, you don't specify versions in Firebase library dependencies

  // TODO: Add the dependencies for Firebase products you want to use
  // See https://firebase.google.com/docs/android/setup#available-libraries
  // For example, add the dependencies for Firebase Authentication and Cloud Firestore
  implementation("com.google.firebase:firebase-auth")
  implementation("com.google.firebase:firebase-firestore")
}

    Com o Firebase Android BoM, seu app sempre vai usar versões compatíveis das bibliotecas do Firebase para Android.

    Está procurando um módulo de biblioteca específico do Kotlin? A partir de outubro de 2023 (Firebase BoM 32.5.0), os desenvolvedores Kotlin e Java poderão depender do módulo da biblioteca principal. Para mais detalhes, consulte Perguntas frequentes sobre essa iniciativa.

  2. Depois de adicionar as dependências dos produtos que você quer usar, sincronize seu projeto do Android com os arquivos do Gradle.

Pronto. Você pode pular para conferir as próximas etapas recomendadas.

Se você estiver com problemas para configurar, acesse as Solução de problemas e perguntas frequentes sobre o Android.


Opção 2: adicionar o Firebase usando o Firebase Assistente

O Firebase Assistente registra seu app com um projeto do Firebase e adiciona ao projeto do Android os arquivos, plug-ins e dependências necessários. Tudo isso é feito no Android Studio.

  1. Abra seu projeto Android no Android Studio e verifique se você está usando as versões mais recentes do Android Studio e do Firebase Assistente:

    • Windows/Linux: acesse Ajuda > Verificar atualizações
    • macOS: Android Studio > Verificar atualizações

  2. Abra o Firebase Assistente: Ferramentas > Firebase.

  3. No painel Assistente, escolha um produto do Firebase para adicionar ao seu aplicativo. Expanda a seção e clique no link do tutorial (por exemplo, Analytics > Registre um evento do Analytics).

    1. Clique em Conectar ao Firebase para conectar seu projeto Android com o Firebase.

    2. Clique no botão para adicionar um produto do Firebase desejado (por exemplo, Adicionar o Analytics ao seu aplicativo).

  4. Sincronize seu app para garantir que todas as dependências tenham as versões necessárias.

  5. No painel do Assistente siga as outras instruções de configuração para seu produto do Firebase.

  6. Adicione quantos produtos do Firebase quiser usando o Firebase Assistente.

Pronto. Confira as próximas etapas recomendadas.

Se você estiver com problemas para configurar, acesse as Solução de problemas e perguntas frequentes sobre o Android.


Bibliotecas disponíveis

Esta seção lista os produtos do Firebase compatíveis com o Android e as dependências do Gradle. Confira mais informações sobre estas bibliotecas do Firebase para Android:

Ao usar o Firebase Android BoM, você não especifica versões individuais da biblioteca ao declarar dependências da biblioteca do Firebase no arquivo de configuração do build do Gradle.

Serviço ou produto Dependência do Gradle Versão
mais recente		 Adicionar Analytics?
Firebase Android BoM
(Bill of Materials)		 com.google.firebase:firebase-bom

A versão mais recente do Firebase BoM contém as versões mais recentes de cada biblioteca do Firebase para Android. Para saber quais versões da biblioteca são associadas a uma versão específica do BoM, consulte as notas da versão do BoM.

 33.16.0
AdMob com.google.android.gms:play-services-ads 24.4.0
Firebase AI Logic 1 com.google.firebase:firebase-ai 16.2.0
Analytics com.google.firebase:firebase-analytics 22.5.0
Provedor personalizado do App Check com.google.firebase:firebase-appcheck 18.0.0
Provedor de depuração do App Check com.google.firebase:firebase-appcheck-debug 18.0.0
Provedor da Play Integrity para App Check com.google.firebase:firebase-appcheck-playintegrity 18.0.0
App Distribution com.google.firebase:firebase-appdistribution 16.0.0-beta15
API do App Distribution com.google.firebase:firebase-appdistribution-api 16.0.0-beta15
Plug-in do App Distribution com.google.firebase:firebase-appdistribution-gradle 5.1.1
Authentication com.google.firebase:firebase-auth 23.2.1
Cloud Firestore com.google.firebase:firebase-firestore 25.1.4
Cloud Functions for Firebase Client SDK com.google.firebase:firebase-functions 21.2.1
Cloud Messaging com.google.firebase:firebase-messaging 24.1.2
Cloud Storage com.google.firebase:firebase-storage 21.0.2
Crashlytics com.google.firebase:firebase-crashlytics 19.4.4
NDK do Crashlytics com.google.firebase:firebase-crashlytics-ndk 19.4.4
Plug-in do Crashlytics com.google.firebase:firebase-crashlytics-gradle 3.0.4
Data Connect com.google.firebase:firebase-dataconnect 16.0.3
Suporte para o módulo de recurso dinâmico com.google.firebase:firebase-dynamic-module-support 16.0.0-beta03
Dynamic Links com.google.firebase:firebase-dynamic-links 22.1.0
In-App Messaging com.google.firebase:firebase-inappmessaging 21.0.2
(obrigatório)
Display do In-App Messaging com.google.firebase:firebase-inappmessaging-display 21.0.2
(obrigatório)
Firebase Instalações com.google.firebase:firebase-installations 18.0.0
API Model Downloader do Firebase ML com.google.firebase:firebase-ml-modeldownloader 25.0.1
Performance Monitoring com.google.firebase:firebase-perf 21.0.5
Plug-in do Performance Monitoring com.google.firebase:perf-plugin 1.4.2
Realtime Database com.google.firebase:firebase-database 21.0.0
Remote Config com.google.firebase:firebase-config 22.1.2
Plug-in do Google Play Services com.google.gms:google-services 4.4.3
BIBLIOTECAS DESCONTINUADAS
Provedor do SafetyNet para App Check com.google.firebase:firebase-appcheck-safetynet 16.1.2
App Indexing com.google.firebase:firebase-appindexing 20.0.0

Módulos KTX do Firebase

Analytics com.google.firebase:firebase-analytics-ktx 22.5.0
Provedor personalizado do App Check com.google.firebase:firebase-appcheck-ktx 18.0.0
API do App Distribution com.google.firebase:firebase-appdistribution-api-ktx 16.0.0-beta15
Authentication com.google.firebase:firebase-auth-ktx 23.2.1
Cloud Firestore com.google.firebase:firebase-firestore-ktx 25.1.4
Cloud Functions for Firebase Client SDK com.google.firebase:firebase-functions-ktx 21.2.1
Cloud Messaging com.google.firebase:firebase-messaging-ktx 24.1.2
Cloud Storage com.google.firebase:firebase-storage-ktx 21.0.2
Crashlytics com.google.firebase:firebase-crashlytics-ktx 19.4.4
Dynamic Links com.google.firebase:firebase-dynamic-links-ktx 22.1.0
In-App Messaging com.google.firebase:firebase-inappmessaging-ktx 21.0.2
(obrigatório)
Display do In-App Messaging com.google.firebase:firebase-inappmessaging-display-ktx 21.0.2
(obrigatório)
Firebase Instalações com.google.firebase:firebase-installations-ktx 18.0.0
API Model Downloader do Firebase ML com.google.firebase:firebase-ml-modeldownloader-ktx 25.0.1
Performance Monitoring com.google.firebase:firebase-perf-ktx 21.0.5
Realtime Database com.google.firebase:firebase-database-ktx 21.0.0
Remote Config com.google.firebase:firebase-config-ktx 22.1.2

Bibliotecas do Kit de ML do Firebase

Firebase ML APIs de modelo personalizado com.google.firebase:firebase-ml-model-interpreter 22.0.4
APIs Vision do Firebase ML com.google.firebase:firebase-ml-vision 24.1.0
Firebase ML: modelo de identificador de imagens com.google.firebase:firebase-ml-vision-image-label-model 20.0.2
Firebase ML: modelo de rastreamento e detecção de objetos com.google.firebase:firebase-ml-vision-object-detection-model 19.0.6
Firebase ML: modelo de detecção facial com.google.firebase:firebase-ml-vision-face-model 20.0.2
Firebase ML: modelo de leitura de código de barras com.google.firebase:firebase-ml-vision-barcode-model 16.1.2
Firebase ML: API AutoML Vision Edge com.google.firebase:firebase-ml-vision-automl 18.0.6
Firebase ML: APIs de linguagem natural com.google.firebase:firebase-ml-natural-language 22.0.1
Firebase ML: modelo de identificação de linguagem com.google.firebase:firebase-ml-natural-language-language-id-model 20.0.8
Firebase ML: modelo de tradução com.google.firebase:firebase-ml-natural-language-translate-model 20.0.9
Firebase ML: modelo de resposta inteligente com.google.firebase:firebase-ml-natural-language-smart-reply-model 20.0.8

1 Firebase AI Logic antes se chamava "Vertex AI in Firebase" com o pacote com.google.firebase:firebase-vertexai.


Próximas etapas

Adicione serviços do Firebase ao seu app:

Saiba mais sobre o Firebase: