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:

    • Está dirigido ao nível 16 da API (Jelly Bean) ou versões posteriores.
    • Usa o Gradle 4.1 ou versões posteriores.
    • Usa o Jetpack (AndroidX), que inclui o cumprimento dos seguintes requisitos de versão:
      • com.android.tools.build:gradle v3.2.1 ou posterior
      • compileSdkVersion 28 ou posterior
  • Configure um dispositivo físico ou use um emulador para executar seu aplicativo.
    Os emuladores precisam usar uma imagem de emulador com o Google Play.

  • Faça login no Firebase usando 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 um dos nossos exemplos nos guias de início rápido.


Você pode 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 para então conectá-lo ao seu aplicativo. Visite Noções básicas sobre projetos do Firebase para saber mais.

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 aplicativo 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 seu 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 Google Services 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.4'  // 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. Declare-as no arquivo Gradle do módulo (nível do app) (geralmente app/build.gradle).

    Analytics ativado

    Java

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

    Ao usar 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:25.12.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'
    }
    
    // Getting a "Could not find" error? Make sure that you've added
    // Google's Maven repository to your root-level build.gradle file
    

    Kotlin+KTX

    dependencies {
      // ...
    
      // Import the Firebase BoM
      implementation platform('com.google.firebase:firebase-bom:25.12.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'
    }
    
    // Getting a "Could not find" error? Make sure that you've added
    // Google's Maven repository to your root-level build.gradle file
    

    Ao usar 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.



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 a partir do Android Studio.

  1. Abra o projeto do Android no Android Studio e acesse o Firebase Assistente:

    1. Acesse Arquivo > Verificar se há atualizações para garantir que você esteja usando as versões mais recentes do Android Studio e do Firebase Assistente.

    2. Acesse Ferramentas > Firebase para abrir o painel Assistente.

  2. Escolha um produto do Firebase para adicionar ao seu app. Expanda a seção e clique no link do tutorial (por exemplo, Analytics > Registrar 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).

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

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

  5. Adicione quantos outros produtos do Firebase quiser usando o Firebase Assistente.

Pronto. Confira as próximas etapas recomendadas.



Bibliotecas disponíveis

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

Observe que, ao usar o 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 mapeadas para uma versão específica da BoM, revise as notas da versão dessa BoM.

25.12.0
AdMob com.google.android.gms:play-services-ads 19.4.0
Análise com.google.firebase:firebase-analytics 17.6.0
Indexação de apps com.google.firebase:firebase-appindexing 19.1.0
Authentication com.google.firebase:firebase-auth 19.4.0
Cloud Firestore com.google.firebase:firebase-firestore 21.7.1
SDK de cliente do Cloud Functions para Firebase com.google.firebase:firebase-functions 19.1.0
Cloud Messaging com.google.firebase:firebase-messaging 20.3.0
Cloud Storage com.google.firebase:firebase-storage 19.2.0
Crashlytics com.google.firebase:firebase-crashlytics 17.2.2
Dynamic Links com.google.firebase:firebase-dynamic-links 19.1.1
APIs do Firebase ML Vision com.google.firebase:firebase-ml-vision 24.1.0
APIs do modelo personalizado do Firebase ML com.google.firebase:firebase-ml-model-interpreter 22.0.4
Mensagens no app com.google.firebase:firebase-inappmessaging 19.1.1
(obrigatório)
Exibição de mensagens no app com.google.firebase:firebase-inappmessaging-display 19.1.1
(obrigatório)
Monitoramento de desempenho com.google.firebase:firebase-perf 19.0.9
Realtime Database com.google.firebase:firebase-database 19.5.0
Configuração remota com.google.firebase:firebase-config 19.2.0
Plug-in do Google Play Services com.google.gms:google-services 4.3.4
Bibliotecas suspensas
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 reconhecimento 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 mapeadas para uma versão específica da BoM, revise as notas da versão dessa BoM.

25.12.0
AdMob com.google.android.gms:play-services-ads 19.4.0
Analytics com.google.firebase:firebase-analytics-ktx 17.6.0
Indexação de apps com.google.firebase:firebase-appindexing 19.1.0
Authentication com.google.firebase:firebase-auth-ktx 19.4.0
Cloud Firestore com.google.firebase:firebase-firestore-ktx 21.7.1
SDK de cliente do Cloud Functions para Firebase com.google.firebase:firebase-functions-ktx 19.1.0
Cloud Messaging com.google.firebase:firebase-messaging-ktx 20.3.0
Cloud Storage com.google.firebase:firebase-storage-ktx 19.2.0
Crashlytics com.google.firebase:firebase-crashlytics-ktx 17.2.2
Dynamic Links com.google.firebase:firebase-dynamic-links-ktx 19.1.1
APIs do Firebase ML Vision com.google.firebase:firebase-ml-vision 24.1.0
APIs do modelo personalizado do Firebase ML com.google.firebase:firebase-ml-model-interpreter 22.0.4
Mensagens no app com.google.firebase:firebase-inappmessaging-ktx 19.1.1
(obrigatório)
Exibição de mensagens no app com.google.firebase:firebase-inappmessaging-display-ktx 19.1.1
(obrigatório)
Monitoramento de desempenho com.google.firebase:firebase-perf-ktx 19.0.9
Realtime Database com.google.firebase:firebase-database-ktx 19.5.0
Configuração remota com.google.firebase:firebase-config-ktx 19.2.0
Plug-in do Google Play Services com.google.gms:google-services 4.3.4
Bibliotecas suspensas
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 reconhecimento 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: