欢迎参加我们将于 2022 年 10 月 18 日举办的 Firebase 峰会(线上线下同时进行),了解 Firebase 如何帮助您加快应用开发速度、满怀信心地发布应用并在之后需要时轻松地扩大应用规模。立即报名

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 e quer testar um produto do Firebase, faça o download de uma das nossas amostras nos guias de início rápido.


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

  • Opção 1: usar o fluxo de trabalho 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 Register 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 (projeto) (<project>/build.gradle), adicione o plug-in dos Serviços do Google como uma dependência do buildscript:

      buildscript {
      
          repositories {
            // Make sure that you have the following two repositories
            google()  // Google's Maven repository
            mavenCentral()  // Maven Central repository
          }
      
          dependencies {
            ...
      
            // Add the dependency for the Google services Gradle plugin
            classpath 'com.google.gms:google-services:4.3.14'
          }
      }
      
      allprojects {
        ...
      
        repositories {
          // Make sure that you have the following two repositories
          google()  // Google's Maven repository
          mavenCentral()  // Maven Central repository
        }
      }
      
    2. No arquivo Gradle do módulo (nível do app) (geralmente <project>/<app-module>/build.gradle), adicione o plug-in dos Serviços do Google:

      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), 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

    Java

    dependencies {
      // ...
    
      // Import the Firebase BoM
      implementation platform('com.google.firebase:firebase-bom:30.4.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'
    }
    

    Kotlin+KTX

    dependencies {
      // ...
    
      // Import the Firebase BoM
      implementation platform('com.google.firebase:firebase-bom:30.4.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'
    }
    

    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

    Java

    dependencies {
      // ...
    
      // Import the Firebase BoM
      implementation platform('com.google.firebase:firebase-bom:30.4.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'
    }
    

    Kotlin+KTX

    dependencies {
      // ...
    
      // Import the Firebase BoM
      implementation platform('com.google.firebase:firebase-bom:30.4.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'
    }
    

    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 seu projeto do Android os arquivos, plug-ins e dependências necessários. Tudo isso pelo 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. Veja 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 quando declara dependências das bibliotecas do Firebase no build.gradle.

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 saber quais versões das bibliotecas são associadas a uma versão específica da BoM, consulte as notas delas.

30.4.1
AdMob com.google.android.gms:play-services-ads 21.2.0
Analytics com.google.firebase:firebase-analytics 21.1.1
Provedor personalizado do App Check com.google.firebase:firebase-appcheck 16.0.2
Provedor de depuração do App Check com.google.firebase:firebase-appcheck-debug 16.0.2
Provedor Play Integrity do App Check com.google.firebase:firebase-appcheck-playintegrity 16.0.2
Provedor SafetyNet do App Check com.google.firebase:firebase-appcheck-safetynet 16.0.2
App Distribution com.google.firebase:firebase-appdistribution 16.0.0-beta04
API App Distribution com.google.firebase:firebase-appdistribution-api 16.0.0-beta04
Plug-in do App Distribution com.google.firebase:firebase-appdistribution-gradle 3.0.3
Authentication com.google.firebase:firebase-auth 21.0.8
Cloud Firestore com.google.firebase:firebase-firestore 24.3.1
SDK de cliente do Cloud Functions para Firebase com.google.firebase:firebase-functions 20.1.1
Cloud Messaging com.google.firebase:firebase-messaging 23.0.8
Cloud Storage com.google.firebase:firebase-storage 20.0.2
Crashlytics com.google.firebase:firebase-crashlytics 18.2.13
Crashlytics NDK com.google.firebase:firebase-crashlytics-ndk 18.2.13
Plug-in do Crashlytics com.google.firebase:firebase-crashlytics-gradle 2.9.2
Suporte para o módulo de recursos dinâmicos com.google.firebase:firebase-dynamic-module-support 16.0.0-beta03
Dynamic Links com.google.firebase:firebase-dynamic-links 21.0.2
Mensagens no app com.google.firebase:firebase-inappmessaging 20.1.3
(obrigatório)
Exibição de mensagens no app com.google.firebase:firebase-inappmessaging-display 20.1.3
(obrigatório)
Instalações do Firebase com.google.firebase:firebase-installations 17.0.3
API Firebase ML Model Downloader com.google.firebase:firebase-ml-modeldownloader 24.0.5
Monitoramento de desempenho com.google.firebase:firebase-perf 20.1.1
Plug-in do Monitoramento de desempenho com.google.firebase:perf-plugin 1.4.1
Realtime Database com.google.firebase:firebase-database 20.0.6
Configuração remota com.google.firebase:firebase-config 21.1.2
Plug-in do Google Play Services com.google.gms:google-services 4.3.14
Bibliotecas descontinuadas
Indexação de apps com.google.firebase:firebase-appindexing 20.0.0
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

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 saber quais versões das bibliotecas são associadas a uma versão específica da BoM, consulte as notas delas.

30.4.1
AdMob com.google.android.gms:play-services-ads 21.2.0
Analytics com.google.firebase:firebase-analytics-ktx 21.1.1
Provedor personalizado do App Check com.google.firebase:firebase-appcheck-ktx 16.0.2
Provedor de depuração do App Check com.google.firebase:firebase-appcheck-debug 16.0.2
Provedor SafetyNet do App Check com.google.firebase:firebase-appcheck-safetynet 16.0.2
API App Distribution com.google.firebase:firebase-appdistribution-api-ktx 16.0.0-beta04
Plug-in do App Distribution com.google.firebase:firebase-appdistribution-gradle 3.0.3
Authentication com.google.firebase:firebase-auth-ktx 21.0.8
Cloud Firestore com.google.firebase:firebase-firestore-ktx 24.3.1
SDK de cliente do Cloud Functions para Firebase com.google.firebase:firebase-functions-ktx 20.1.1
Cloud Messaging com.google.firebase:firebase-messaging-ktx 23.0.8
Cloud Storage com.google.firebase:firebase-storage-ktx 20.0.2
Crashlytics com.google.firebase:firebase-crashlytics-ktx 18.2.13
Crashlytics NDK com.google.firebase:firebase-crashlytics-ndk 18.2.13
Plug-in do Crashlytics com.google.firebase:firebase-crashlytics-gradle 2.9.2
Suporte para o módulo de recursos dinâmicos com.google.firebase:firebase-dynamic-module-support 16.0.0-beta03
Dynamic Links com.google.firebase:firebase-dynamic-links-ktx 21.0.2
Mensagens no app com.google.firebase:firebase-inappmessaging-ktx 20.1.3
(obrigatório)
Exibição de mensagens no app com.google.firebase:firebase-inappmessaging-display-ktx 20.1.3
(obrigatório)
Instalações do Firebase com.google.firebase:firebase-installations-ktx 17.0.3
API Firebase ML Model Downloader com.google.firebase:firebase-ml-modeldownloader-ktx 24.0.5
Monitoramento de desempenho com.google.firebase:firebase-perf-ktx 20.1.1
Plug-in do Monitoramento de desempenho com.google.firebase:perf-plugin 1.4.1
Realtime Database com.google.firebase:firebase-database-ktx 20.0.6
Configuração remota com.google.firebase:firebase-config-ktx 21.1.2
Plug-in do Google Play Services com.google.gms:google-services 4.3.14
Bibliotecas descontinuadas
Indexação de apps com.google.firebase:firebase-appindexing 20.0.0
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: