Adicionar o Firebase ao projeto para Android

Pré-requisitos

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

  • Verifique se o projeto atende a estes requisitos:

    • O nível desejado da API é 19 (KitKat) ou superior
    • Usa o Android 4.4 ou versões mais recentes
    • Usa o Jetpack (AndroidX), que inclui o cumprimento dos seguintes requisitos de versão:
      • com.android.tools.build:gradle v3.2.1 ou mais recente
      • compileSdkVersion 28 ou mais recente
  • 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 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: usar o fluxo de configuração do Console do Firebase (recomendado).
  • 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 no 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 ao seu app o arquivo de configuração do Firebase para Android (google-services.json):

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

    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.2.0" apply false
        // ...
      
        // Add the dependency for the Google services Gradle plugin
        id("com.google.gms.google-services") version "4.3.15" apply false
      }
      

      Groovy

      plugins {
        id 'com.android.application' version '7.2.0' apply false
        // ...
      
        // Add the dependency for the Google services Gradle plugin
        id 'com.google.gms.google-services' version '4.3.15' 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>/build.gradle.kts ou <project>/build.gradle), adicione as dependências dos produtos do Firebase que você quer usar no seu app. Recomendamos usar a BoM do Firebase para Android para gerenciar o controle de versões das bibliotecas.

    Analytics ativado

    Kotlin+KTX

    dependencies {
      // ...
    
      // Import the Firebase BoM
      implementation(platform("com.google.firebase:firebase-bom:32.3.1"))
    
      // 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-ktx")
    
      // 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-ktx")
      implementation("com.google.firebase:firebase-firestore-ktx")
    }
    

    Java

    dependencies {
      // ...
    
      // Import the Firebase BoM
      implementation(platform("com.google.firebase:firebase-bom:32.3.1"))
    
      // 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 a BoM do Firebase para Android, seu app sempre vai usar versões compatíveis das bibliotecas Android do Firebase.

    Analytics não ativado

    Kotlin+KTX

    dependencies {
      // ...
    
      // Import the Firebase BoM
      implementation(platform("com.google.firebase:firebase-bom:32.3.1"))
    
      // 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-ktx")
      implementation("com.google.firebase:firebase-firestore-ktx")
    }
    

    Java

    dependencies {
      // ...
    
      // Import the Firebase BoM
      implementation(platform("com.google.firebase:firebase-bom:32.3.1"))
    
      // 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 a BoM do Firebase para Android, seu app sempre vai usar versões compatíveis das bibliotecas Android do Firebase.

  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 a BoM do Firebase para Android, você não especifica versões de biblioteca individuais ao declarar dependências da biblioteca do Firebase no arquivo de configuração de compilação do Gradle.

Kotlin+KTX

Serviço ou produto Dependência do Gradle Versão
mais recente
Adicionar Analytics?
Lista de materiais (BoM)
do Android para Firebase
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 conferir quais versões de uma biblioteca estão associadas a uma versão específica da BoM, consulte as notas dessa versão.

32.3.1
AdMob com.google.android.gms:play-services-ads 22.4.0
Analytics com.google.firebase:firebase-analytics-ktx 21.3.0
Provedor personalizado do App Check com.google.firebase:firebase-appcheck-ktx 17.0.1
Provedor de depuração do App Check com.google.firebase:firebase-appcheck-debug 17.0.1
Provedor da Play Integrity do App Check com.google.firebase:firebase-appcheck-playintegrity 17.0.1
App Distribution com.google.firebase:firebase-appdistribution 16.0.0-beta10
API App Distribution com.google.firebase:firebase-appdistribution-api-ktx 16.0.0-beta10
Plug-in do App Distribution com.google.firebase:firebase-appdistribution-gradle 4.0.0
Authentication com.google.firebase:firebase-auth-ktx 22.1.2
Cloud Firestore com.google.firebase:firebase-firestore-ktx 24.8.1
SDK de cliente do Cloud Functions para Firebase com.google.firebase:firebase-functions-ktx 20.3.1
Cloud Messaging com.google.firebase:firebase-messaging-ktx 23.2.1
Cloud Storage com.google.firebase:firebase-storage-ktx 20.2.1
Crashlytics com.google.firebase:firebase-crashlytics-ktx 18.4.3
Crashlytics NDK com.google.firebase:firebase-crashlytics-ndk 18.4.3
Plug-in do Crashlytics com.google.firebase:firebase-crashlytics-gradle 2.9.9
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-ktx 21.1.0
Mensagens no app com.google.firebase:firebase-inappmessaging-ktx 20.3.5
(obrigatório)
Exibição de mensagens no app com.google.firebase:firebase-inappmessaging-display-ktx 20.3.5
(obrigatório)
Instalações do Firebase com.google.firebase:firebase-installations-ktx 17.1.4
API Firebase ML Model Downloader com.google.firebase:firebase-ml-modeldownloader-ktx 24.1.3
Monitoramento de desempenho com.google.firebase:firebase-perf-ktx 20.4.1
Plug-in do Monitoramento de desempenho com.google.firebase:perf-plugin 1.4.2
Realtime Database com.google.firebase:firebase-database-ktx 20.2.2
Configuração remota com.google.firebase:firebase-config-ktx 21.4.1
Plug-in do Google Play Services com.google.gms:google-services 4.3.15
Bibliotecas descontinuadas
Provedor SafetyNet do App Check com.google.firebase:firebase-appcheck-safetynet 16.1.2
Indexação de apps com.google.firebase:firebase-appindexing 20.0.0

Bibliotecas do Kit de ML do Firebase

APIs do modelo personalizado do Firebase ML com.google.firebase:firebase-ml-model-interpreter 22.0.4
APIs do Firebase ML Vision com.google.firebase:firebase-ml-vision 24.1.0
Firebase ML: modelo de rotulagem 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 Natural Language 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

Java

Serviço ou produto Dependência do Gradle Versão
mais recente
Adicionar Analytics?
Lista de materiais (BoM)
do Android para Firebase
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 conferir quais versões de uma biblioteca estão associadas a uma versão específica da BoM, consulte as notas dessa versão.

32.3.1
AdMob com.google.android.gms:play-services-ads 22.4.0
Analytics com.google.firebase:firebase-analytics 21.3.0
Provedor personalizado do App Check com.google.firebase:firebase-appcheck 17.0.1
Provedor de depuração do App Check com.google.firebase:firebase-appcheck-debug 17.0.1
Provedor da Play Integrity do App Check com.google.firebase:firebase-appcheck-playintegrity 17.0.1
App Distribution com.google.firebase:firebase-appdistribution 16.0.0-beta10
API App Distribution com.google.firebase:firebase-appdistribution-api 16.0.0-beta10
Plug-in do App Distribution com.google.firebase:firebase-appdistribution-gradle 4.0.0
Authentication com.google.firebase:firebase-auth 22.1.2
Cloud Firestore com.google.firebase:firebase-firestore 24.8.1
SDK de cliente do Cloud Functions para Firebase com.google.firebase:firebase-functions 20.3.1
Cloud Messaging com.google.firebase:firebase-messaging 23.2.1
Cloud Storage com.google.firebase:firebase-storage 20.2.1
Crashlytics com.google.firebase:firebase-crashlytics 18.4.3
Crashlytics NDK com.google.firebase:firebase-crashlytics-ndk 18.4.3
Plug-in do Crashlytics com.google.firebase:firebase-crashlytics-gradle 2.9.9
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 21.1.0
Mensagens no app com.google.firebase:firebase-inappmessaging 20.3.5
(obrigatório)
Exibição de mensagens no app com.google.firebase:firebase-inappmessaging-display 20.3.5
(obrigatório)
Instalações do Firebase com.google.firebase:firebase-installations 17.1.4
API Firebase ML Model Downloader com.google.firebase:firebase-ml-modeldownloader 24.1.3
Monitoramento de desempenho com.google.firebase:firebase-perf 20.4.1
Plug-in do Monitoramento de desempenho com.google.firebase:perf-plugin 1.4.2
Realtime Database com.google.firebase:firebase-database 20.2.2
Configuração remota com.google.firebase:firebase-config 21.4.1
Plug-in do Google Play Services com.google.gms:google-services 4.3.15
Bibliotecas descontinuadas
Provedor SafetyNet do App Check com.google.firebase:firebase-appcheck-safetynet 16.1.2
Indexação de apps com.google.firebase:firebase-appindexing 20.0.0

Bibliotecas do Kit de ML do Firebase

APIs do modelo personalizado do Firebase ML com.google.firebase:firebase-ml-model-interpreter 22.0.4
APIs do Firebase ML Vision com.google.firebase:firebase-ml-vision 24.1.0
Firebase ML: modelo de rotulagem 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 Natural Language 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



Próximas etapas

Adicione serviços do Firebase ao seu app:

Saiba mais sobre o Firebase: