O Google tem o compromisso de promover a igualdade racial para as comunidades negras. Saiba como.

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:

    • Visa o nível 16 da API (Jelly Bean) ou versões mais recentes.
    • Usa o Gradle 4.1 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 quiser 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 para Android ao Firebase usando uma das seguintes opções:

  • 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 do 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. Para adicionar o arquivo de configuração do Firebase para Android ao app, siga estas etapas:

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

    2. Mova seu arquivo de configuração para o diretório de módulos do seu app.

  2. Para ativar os produtos do Firebase no app, adicione o plug-in google-services aos seus arquivos do Gradle.

    1. No arquivo do Gradle (build.gradle) no nível raiz, adicione regras para incluir o plug-in do Serviços do Google para Gradle. Verifique se você tem o repositório Maven do Google também.

      buildscript {
      
        repositories {
          // Check that you have the following line (if not, add it):
          google()  // Google's Maven repository
        }
      
        dependencies {
          // ...
      
          // Add the following line:
          classpath 'com.google.gms:google-services:4.3.10'  // Google Services plugin
        }
      }
      
      allprojects {
        // ...
      
        repositories {
          // Check that you have the following line (if not, add it):
          google()  // Google's Maven repository
          // ...
        }
      }
      
    2. No seu arquivo Gradle do módulo (nível do aplicativo) (geralmente app/build.gradle), aplique o plug-in Gradle do Google Services:

      apply plugin: 'com.android.application'
      // Add the following line:
      apply plugin: 'com.google.gms.google-services'  // Google Services plugin
      
      android {
        // ...
      }
      

Etapa 4: adicionar SDKs do Firebase ao seu app

  1. Com a BoM do Firebase para Android, declare as dependências dos produtos do Firebase que você quer usar no seu app. Faça isso no arquivo do Gradle do módulo (nível do app), que geralmente é app/build.gradle.

    Analytics ativado

    Java

    dependencies {
      // ...
    
      // Import the Firebase BoM
      implementation platform('com.google.firebase:firebase-bom:28.4.0')
    
      // When using the BoM, you don't specify versions in Firebase library dependencies
    
      // Declare the dependency for the Firebase SDK for Google Analytics
      implementation 'com.google.firebase:firebase-analytics'
    
      // Declare the dependencies for any other desired Firebase products
      // For example, declare 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:28.4.0')
    
      // When using the BoM, you don't specify versions in Firebase library dependencies
    
      // Declare the dependency for the Firebase SDK for Google Analytics
      implementation 'com.google.firebase:firebase-analytics-ktx'
    
      // Declare the dependencies for any other desired Firebase products
      // For example, declare 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 usará versões compatíveis das bibliotecas do Firebase para Android.

    Analytics não ativado

    Java

    dependencies {
      // ...
    
      // Import the Firebase BoM
      implementation platform('com.google.firebase:firebase-bom:28.4.0')
    
      // When using the BoM, you don't specify versions in Firebase library dependencies
    
      // Declare the dependencies for the desired Firebase products
      // For example, declare 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:28.4.0')
    
      // When using the BoM, you don't specify versions in Firebase library dependencies
    
      // Declare the dependencies for the desired Firebase products
      // For example, declare 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 usará versões compatíveis das bibliotecas do Firebase para Android.

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

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 os arquivos, plug-ins e dependências necessários ao seu projeto do Android. 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 da biblioteca 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 da biblioteca são associadas a uma versão específica da BoM, consulte as notas da versão dela.

28.4.0
AdMob com.google.android.gms:play-services-ads 20.3.0
Analytics com.google.firebase:firebase-analytics 19.0.1
Provedor personalizado do App Check com.google.firebase:firebase-appcheck 16.0.0-beta02
Provedor de depuração do App Check com.google.firebase:firebase-appcheck-debug 16.0.0-beta02
Provedor SafetyNet do App Check com.google.firebase:firebase-appcheck-safetynet 16.0.0-beta02
Plug-in do App Distribution com.google.firebase:firebase-appdistribution-gradle 2.1.3
Indexação de apps com.google.firebase:firebase-appindexing 20.0.0
Authentication com.google.firebase:firebase-auth 21.0.1
Cloud Firestore com.google.firebase:firebase-firestore 23.0.3
SDK de cliente do Cloud Functions para Firebase com.google.firebase:firebase-functions 20.0.0
Cloud Messaging com.google.firebase:firebase-messaging 22.0.0
Cloud Storage com.google.firebase:firebase-storage 20.0.0
Crashlytics com.google.firebase:firebase-crashlytics 18.2.1
Crashlytics NDK com.google.firebase:firebase-crashlytics-ndk 18.2.1
Plug-in do Crashlytics com.google.firebase:firebase-crashlytics-gradle 2.7.1
Suporte para o módulo de recursos dinâmicos com.google.firebase:firebase-dynamic-module-support 16.0.0-beta01
Dynamic Links com.google.firebase:firebase-dynamic-links 20.1.1
Mensagens no app com.google.firebase:firebase-inappmessaging 20.1.0
(obrigatório)
Exibição de mensagens no app com.google.firebase:firebase-inappmessaging-display 20.1.0
(obrigatório)
Instalações do Firebase com.google.firebase:firebase-installations 17.0.0
API Firebase ML Model Downloader com.google.firebase:firebase-ml-modeldownloader 24.0.0
Monitoramento de desempenho com.google.firebase:firebase-perf 20.0.2
Plug-in do Monitoramento de desempenho com.google.firebase:perf-plugin 1.4.0
Realtime Database com.google.firebase:firebase-database 20.0.1
Configuração remota com.google.firebase:firebase-config 21.0.1
Plug-in do Google Play Services com.google.gms:google-services 4.3.10
Bibliotecas suspensas
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 da biblioteca são associadas a uma versão específica da BoM, consulte as notas da versão dela.

28.4.0
AdMob com.google.android.gms:play-services-ads 20.3.0
Analytics com.google.firebase:firebase-analytics-ktx 19.0.1
Provedor personalizado do App Check com.google.firebase:firebase-appcheck 16.0.0-beta02
Provedor de depuração do App Check com.google.firebase:firebase-appcheck-debug 16.0.0-beta02
Provedor SafetyNet do App Check com.google.firebase:firebase-appcheck-safetynet 16.0.0-beta02
Plug-in do App Distribution com.google.firebase:firebase-appdistribution-gradle 2.1.3
Indexação de apps com.google.firebase:firebase-appindexing 20.0.0
Authentication com.google.firebase:firebase-auth-ktx 21.0.1
Cloud Firestore com.google.firebase:firebase-firestore-ktx 23.0.3
SDK de cliente do Cloud Functions para Firebase com.google.firebase:firebase-functions-ktx 20.0.0
Cloud Messaging com.google.firebase:firebase-messaging-ktx 22.0.0
Cloud Storage com.google.firebase:firebase-storage-ktx 20.0.0
Crashlytics com.google.firebase:firebase-crashlytics-ktx 18.2.1
Crashlytics NDK com.google.firebase:firebase-crashlytics-ndk 18.2.1
Plug-in do Crashlytics com.google.firebase:firebase-crashlytics-gradle 2.7.1
Suporte para o módulo de recursos dinâmicos com.google.firebase:firebase-dynamic-module-support 16.0.0-beta01
Dynamic Links com.google.firebase:firebase-dynamic-links-ktx 20.1.1
Mensagens no app com.google.firebase:firebase-inappmessaging-ktx 20.1.0
(obrigatório)
Exibição de mensagens no app com.google.firebase:firebase-inappmessaging-display-ktx 20.1.0
(obrigatório)
Instalações do Firebase com.google.firebase:firebase-installations-ktx 17.0.0
API Firebase ML Model Downloader com.google.firebase:firebase-ml-modeldownloader-ktx 24.0.0
Monitoramento de desempenho com.google.firebase:firebase-perf-ktx 20.0.2
Plug-in do Monitoramento de desempenho com.google.firebase:perf-plugin 1.4.0
Realtime Database com.google.firebase:firebase-database-ktx 20.0.1
Configuração remota com.google.firebase:firebase-config-ktx 21.0.1
Plug-in do Google Play Services com.google.gms:google-services 4.3.10
Bibliotecas suspensas
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: