获取我们在 Firebase 峰会上发布的所有信息,了解 Firebase 可如何帮助您加快应用开发速度并满怀信心地运行应用。了解详情

Adicione o Firebase ao seu projeto Android

Pré-requisitos

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

  • Certifique-se de que seu projeto atenda a estes requisitos:

    • Segmenta API de nível 19 (KitKat) ou superior
    • Usa Android 4.4 ou superior
    • Usa Jetpack (AndroidX) , o que inclui atender a estes 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.
    Observe que os SDKs do Firebase com dependência do Google Play Services exigem que o dispositivo ou emulador tenha o Google Play Services instalado.

  • Faça login no Firebase usando sua conta do Google.

Se você ainda não tem um projeto Android e quer apenas experimentar um produto Firebase, pode baixar um de nossos exemplos de início rápido .


Você pode conectar seu aplicativo Android ao Firebase usando uma das seguintes opções:

  • Opção 1 : (recomendado) Use o fluxo de trabalho de configuração do Firebase console.
  • Opção 2 : Use o Android Studio Firebase Assistant (pode exigir configuração adicional).



Opção 1 : adicionar Firebase usando o Firebase console

Adicionar o Firebase ao seu aplicativo envolve tarefas no console do Firebase e em seu projeto Android aberto (por exemplo, você baixa os arquivos de configuração do Firebase do console e os move para o seu projeto Android).

Etapa 1 : criar um projeto do Firebase

Antes de adicionar o Firebase ao seu aplicativo Android, você precisa criar um projeto do Firebase para se conectar ao seu aplicativo Android. Acesse Entenda os projetos do Firebase para saber mais sobre os projetos do Firebase.

Etapa 2 : registre seu aplicativo no Firebase

Para usar o Firebase em seu aplicativo Android, você precisa registrar seu aplicativo com seu projeto Firebase. Registrar seu aplicativo geralmente é chamado de "adicionar" seu aplicativo ao seu 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 Adicionar aplicativo para iniciar o fluxo de trabalho de configuração.

  3. Digite o nome do pacote do seu aplicativo no campo de nome do pacote Android .

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

  5. Clique em Registrar aplicativo .

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

  1. Baixe e adicione o arquivo de configuração Firebase Android ( google-services.json ) ao seu aplicativo:

    1. Clique em Baixar google-services.json para obter o arquivo de configuração do Firebase Android.

    2. Mova seu arquivo de configuração para o diretório raiz do módulo (nível do aplicativo) do seu aplicativo.

  2. Para tornar os valores em seu arquivo de configuração google-services.json acessíveis aos SDKs do Firebase, você precisa do plug-in Gradle de serviços do Google ( google-services ).

    1. Em seu arquivo Gradle de nível raiz (nível de projeto) ( <project>/build.gradle ), adicione o plug-in de serviços do Google como uma dependência 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 aplicativo) (geralmente <project>/<app-module>/build.gradle ), adicione o plug-in de 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 aplicativo

  1. No arquivo Gradle do módulo (nível do aplicativo) (geralmente <project>/<app-module>/build.gradle ), adicione as dependências dos produtos Firebase que deseja usar em seu aplicativo. Recomendamos usar o Firebase Android BoM para controlar o controle de versão da biblioteca.

    Análise habilitada

    Java

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

    Kotlin+KTX

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

    Ao usar o Firebase Android BoM , seu aplicativo sempre usará versões compatíveis das bibliotecas do Firebase Android.

    Análise não habilitada

    Java

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

    Kotlin+KTX

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

    Ao usar o Firebase Android BoM , seu aplicativo sempre usará versões compatíveis das bibliotecas do Firebase Android.

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

É isso! Você pode avançar para verificar as próximas etapas recomendadas.

No entanto, se estiver com problemas para configurar, visite a seção de solução de problemas e perguntas frequentes do Android .



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

O Firebase Assistant registra seu aplicativo com um projeto Firebase e adiciona os arquivos, plug-ins e dependências necessários do Firebase ao seu projeto Android — tudo de dentro do Android Studio!

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

    • Windows / Linux: Ajuda > Verificar se há atualizações
    • macOS: Android Studio > Verificar atualizações
  2. Abra o Assistente do Firebase: Ferramentas > Firebase .

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

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

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

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

  5. No painel Assistente , siga as instruções de configuração restantes para o produto Firebase selecionado.

  6. Adicione quantos outros produtos Firebase quiser por meio do Firebase Assistant!

É isso! Certifique-se de verificar as próximas etapas recomendadas.

No entanto, se estiver com problemas para configurar, visite a seção de solução de problemas e perguntas frequentes do Android .



Bibliotecas disponíveis

Esta seção lista os produtos Firebase com suporte para Android e suas dependências do Gradle. Saiba mais sobre essas bibliotecas Android do Firebase:

Observe que, ao usar o Firebase Android BoM , você não especifica as versões individuais da biblioteca ao declarar as dependências da biblioteca Firebase em build.gradle .

Java

Serviço ou Produto Dependência Gradle Mais recentes
versão
Adicionar análises?
Firebase Android BoM
(lista de materiais)
com.google.firebase:firebase-bom

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

31.1.0
AdMob com.google.android.gms:play-services-ads 21.3.0
Análise com.google.firebase:firebase-analytics 21.2.0
Provedor personalizado do App Check com.google.firebase:firebase-appcheck 16.1.0
Provedor de depuração do App Check com.google.firebase:firebase-appcheck-debug 16.1.0
Provedor de Integridade do App Check Play com.google.firebase:firebase-appcheck-playintegrity 16.1.0
App Check SafetyNet provedor com.google.firebase:firebase-appcheck-safetynet 16.1.0
Distribuição de aplicativos com.google.firebase:firebase-appdistribution 16.0.0-beta05
API de distribuição de aplicativos com.google.firebase:firebase-appdistribution-api 16.0.0-beta05
Plug-in de distribuição de aplicativos com.google.firebase:firebase-appdistribution-gradle 3.1.1
Autenticação com.google.firebase:firebase-auth 21.1.0
Cloud Firestore com.google.firebase:firebase-firestore 24.4.1
Cloud Functions para Firebase Client SDK com.google.firebase:firebase-functions 20.2.1
Mensagens na nuvem com.google.firebase:firebase-messaging 23.1.0
Armazenamento na núvem com.google.firebase:firebase-storage 20.1.0
Crashlytics com.google.firebase:firebase-crashlytics 18.3.2
Crashlytics NDK com.google.firebase:firebase-crashlytics-ndk 18.3.2
Plug-in do Crashlytics com.google.firebase:firebase-crashlytics-gradle 2.9.2
Suporte ao módulo de recurso dinâmico com.google.firebase:firebase-dynamic-module-support 16.0.0-beta03
Links dinâmicos com.google.firebase:firebase-dynamic-links 21.1.0
Mensagens no aplicativo com.google.firebase:firebase-inappmessaging 20.2.0
(requeridos)
Exibição de mensagens no aplicativo com.google.firebase:firebase-inappmessaging-display 20.2.0
(requeridos)
Instalações do Firebase com.google.firebase:firebase-installations 17.1.0
API do Firebase ML Model Downloader com.google.firebase:firebase-ml-modeldownloader 24.1.1
Monitoramento de desempenho com.google.firebase:firebase-perf 20.3.0
Plug-in de monitoramento de desempenho com.google.firebase:perf-plugin 1.4.2
banco de dados em tempo real com.google.firebase:firebase-database 20.1.0
Configuração Remota com.google.firebase:firebase-config 21.2.0
Plug-in de serviços do Google Play com.google.gms:google-services 4.3.14
Bibliotecas obsoletas
Indexação de aplicativos com.google.firebase:firebase-appindexing 20.0.0
APIs de modelo personalizado do Firebase ML com.google.firebase:firebase-ml-model-interpreter 22.0.4
APIs 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 detecção e rastreamento 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-idioma-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 Gradle Mais recentes
versão
Adicionar análises?
Firebase Android BoM
(lista de materiais)
com.google.firebase:firebase-bom

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

31.1.0
AdMob com.google.android.gms:play-services-ads 21.3.0
Análise com.google.firebase:firebase-analytics-ktx 21.2.0
Provedor personalizado do App Check com.google.firebase:firebase-appcheck-ktx 16.1.0
Provedor de depuração do App Check com.google.firebase:firebase-appcheck-debug 16.1.0
App Check SafetyNet provedor com.google.firebase:firebase-appcheck-safetynet 16.1.0
API de distribuição de aplicativos com.google.firebase:firebase-appdistribution-api-ktx 16.0.0-beta05
Plug-in de distribuição de aplicativos com.google.firebase:firebase-appdistribution-gradle 3.1.1
Autenticação com.google.firebase:firebase-auth-ktx 21.1.0
Cloud Firestore com.google.firebase:firebase-firestore-ktx 24.4.1
Cloud Functions para Firebase Client SDK com.google.firebase:firebase-functions-ktx 20.2.1
Mensagens na nuvem com.google.firebase:firebase-messaging-ktx 23.1.0
Armazenamento na núvem com.google.firebase:firebase-storage-ktx 20.1.0
Crashlytics com.google.firebase:firebase-crashlytics-ktx 18.3.2
Crashlytics NDK com.google.firebase:firebase-crashlytics-ndk 18.3.2
Plug-in do Crashlytics com.google.firebase:firebase-crashlytics-gradle 2.9.2
Suporte ao módulo de recurso dinâmico com.google.firebase:firebase-dynamic-module-support 16.0.0-beta03
Links dinâmicos com.google.firebase:firebase-dynamic-links-ktx 21.1.0
Mensagens no aplicativo com.google.firebase:firebase-inappmessaging-ktx 20.2.0
(requeridos)
Exibição de mensagens no aplicativo com.google.firebase:firebase-inappmessaging-display-ktx 20.2.0
(requeridos)
Instalações do Firebase com.google.firebase:firebase-installations-ktx 17.1.0
API do Firebase ML Model Downloader com.google.firebase:firebase-ml-modeldownloader-ktx 24.1.1
Monitoramento de desempenho com.google.firebase:firebase-perf-ktx 20.3.0
Plug-in de monitoramento de desempenho com.google.firebase:perf-plugin 1.4.2
banco de dados em tempo real com.google.firebase:firebase-database-ktx 20.1.0
Configuração Remota com.google.firebase:firebase-config-ktx 21.2.0
Plug-in de serviços do Google Play com.google.gms:google-services 4.3.14
Bibliotecas obsoletas
Indexação de aplicativos com.google.firebase:firebase-appindexing 20.0.0
APIs de modelo personalizado do Firebase ML com.google.firebase:firebase-ml-model-interpreter 22.0.4
APIs 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 detecção e rastreamento 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-idioma-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óximos passos

Adicione serviços do Firebase ao seu aplicativo:

Conheça o Firebase: