Pré-requisitos

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

• Certifique-se de que seu projeto atenda aos seguintes requisitos (alguns produtos podem ter requisitos mais rigorosos):

  • Visa o nível 23 da API (Marshmallow) ou mais recente.
  • Usa o Android 6.0 ou versões mais recentes
  • Usa o Jetpack (AndroidX), que inclui o cumprimento dos seguintes requisitos de versão:
    • com.android.tools.build:gradle v7.3.0 ou mais recente
    • compileSdkVersion 28 ou posterior

• 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 do 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: (recomendado) usar o Fluxo de trabalho de configuração do console do Firebase.
• 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 a partir do console e os move para o projeto do Android).

Etapa 1: criar um projeto do Firebase

Antes de adicionar o Firebase ao app Android, é preciso criar um projeto do Firebase para então conectá-lo ao app. Acesse Noções básicas sobre projetos do Firebase para saber mais.

Ver instruções para criar um Projeto do Firebase

Ainda não conhece o Firebase ou o Cloud?

Siga estas etapas se você não conhece o Firebase ou o Google Cloud.
Você também pode seguir estas etapas se quiser criar um projeto do Firebase totalmente novo (e o projeto Google Cloud subjacente).

1. Faça login no console do Firebase.
2. Clique no botão para criar um Projeto do Firebase.

3. No campo de texto, insira um nome do projeto.

   Se você faz parte de uma organização Google Cloud, pode selecionar em qual pasta criar o projeto.

4. Se solicitado, leia e aceite os Termos do Firebase e clique em Continuar.
5. (Opcional) Ative a assistência de IA no console do Firebase (chamada de "Gemini no Firebase"), que pode ajudar você a começar e simplificar seu processo de desenvolvimento.

6. (Opcional) Configure o Google Analytics para o projeto, o que permite uma experiência ideal ao usar estes produtos do Firebase: Firebase A/B Testing, Cloud Messaging, Crashlytics, In-App Messaging e Remote Config (incluindo a Personalização).

   Selecione uma conta do Google Analytics ou crie uma nova. Se você criar uma nova conta, selecione seu local do relatório do Analytics e aceite as configurações de compartilhamento de dados pessoais e os termos do Google Analytics no projeto.

7. Clique em Criar projeto.

O Firebase cria seu projeto, provisiona alguns recursos iniciais e ativa APIs importantes. Quando o processo for concluído, vamos direcionar você para a página de visão geral do projeto do Firebase no Console do Firebase.

Projeto do Cloud atual

Siga estas etapas se quiser começar a usar o Firebase com um projeto Google Cloud atual. Saiba mais e resolva problemas relacionados a como adicionar o Firebase a um projeto do Google Cloud.

1. Faça login no console do Firebase com a conta que dá acesso ao projeto Google Cloud.
2. Clique no botão para criar um Projeto do Firebase.
3. Na parte de baixo da página, clique em Adicionar o Firebase ao projeto do Google Cloud.
4. No campo de texto, comece a digitar o nome do projeto e selecione-o na lista exibida.
5. Clique em Abrir projeto.
6. Se solicitado, leia e aceite os Termos do Firebase e clique em Continuar.
7. (Opcional) Ative a assistência de IA no console do Firebase (chamada de "Gemini no Firebase"), que pode ajudar você a começar e simplificar seu processo de desenvolvimento.

8. (Opcional) Configure o Google Analytics para o projeto, o que permite uma experiência ideal ao usar estes produtos do Firebase: Firebase A/B Testing, Cloud Messaging, Crashlytics, In-App Messaging e Remote Config (incluindo a Personalização).

   Selecione uma conta do Google Analytics ou crie uma nova. Se você criar uma nova conta, selecione seu local do relatório do Analytics e aceite as configurações de compartilhamento de dados pessoais e os termos do Google Analytics no projeto.

9. Clique em Adicionar Firebase:

O Firebase adiciona o Firebase ao seu projeto atual. Quando o processo for concluído, vamos direcionar você para a página de visão geral do projeto do Firebase no Console 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.

   O que é um nome de pacote e onde ele pode ser encontrado?

   • Um nome de pacote identifica seu app de forma exclusiva no dispositivo e na Google Play Store.

   • Um nome de pacote é frequentemente chamado de ID do aplicativo.

   • Encontre o nome do pacote do app no arquivo Gradle do módulo (nível do app), geralmente app/build.gradle (exemplo de nome do pacote: com.yourcompany.yourproject).

   • Saiba que o valor do nome do pacote diferencia maiúsculas de minúsculas e não pode ser alterado no app Android do Firebase depois de ser registrado no projeto.

4. (Opcional) Digite um Apelido do app, que é um identificador interno de conveniência visível apenas para você no console do Firebase.

5. Clique em Registrar app.

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

1. Faça o download e adicione o arquivo de configuração do Firebase ( google-services.json ) do app à base de código:

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

   2. Mova esse arquivo para o diretório raiz do módulo (nível do app) do seu aplicativo.

   O que é preciso saber sobre esse arquivo de configuração?

   • O arquivo de configuração do Firebase contém identificadores exclusivos, mas não secretos, para seu projeto e app. Para saber mais sobre esse arquivo, acesse Noções básicas sobre projetos do Firebase.

   • É possível fazer o download do arquivo de configuração do Firebase novamente a qualquer momento.

   • Verifique se outros caracteres, como (2), não foram adicionados ao final do nome do arquivo de configuração.

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

      Groovy

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

   Analytics ativado

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

   Com o Firebase Android BoM, seu app sempre vai usar versões compatíveis das bibliotecas do Firebase para Android.

   Analytics não ativado

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

   Com o Firebase Android BoM, seu app sempre vai usar versões compatíveis das bibliotecas do Firebase para Android.

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

   Você está recebendo uma falha de build sobre o suporte a invoke-custom e sobre a ativação da simplificação? Veja como corrigir isso.

   Builds do Gradle que usam o Plug-in do Android para Gradle (AGP) v4.2 ou anterior precisam dar suporte a Java 8. Caso contrário, esses projetos Android receberão uma falha de compilação ao adicionar um SDK do Firebase.

   Para corrigir essa falha de build, use uma destas duas opções:

   • Adicione o compileOptions listado da mensagem de erro ao seu arquivo build.gradle.kts oi build.gradle no nível do app.
   • Aumente a minSdk do seu projeto Android para 26 ou mais.

   Saiba mais sobre essa falha de build nestas Perguntas frequentes.

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.

      O que esse fluxo de trabalho faz?

      • Este fluxo de trabalho cria um novo app do Firebase para Android automaticamente usando o nome do pacote do seu app. É possível criar esse novo app Android no Firebase em um projeto existente ou no novo projeto.

        Veja algumas dicas para configurar seu projeto do Firebase:

        • Confira nossas práticas recomendadas para adicionar apps a um projeto do Firebase, incluindo como lidar com diversas variantes.

        • Se você criar um novo projeto, recomendamos configurar o Google Analytics para ele, o que permite uma experiência ideal com muitos produtos do Firebase.

      • Esse fluxo de trabalho também adiciona o arquivo de configuração do Android do projeto do Firebase ( google-services.json ) ao diretório do módulo (nível do app).

   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:

• Documentação de referência (Kotlin | Java)

• Repositório do GitHub (em inglês) do SDK do Firebase para Android

Ao usar o Firebase Android BoM, você não especifica versões individuais da biblioteca ao declarar dependências da biblioteca do Firebase no arquivo de configuração do build do Gradle.

Serviço ou produto	Dependência do Gradle	Versão mais recente	Adicionar Analytics?
Firebase Android BoM (Bill of Materials)	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 do BoM, consulte as notas da versão do BoM.	34.11.0
AdMob	com.google.android.gms:play-services-ads	25.1.0
Firebase AI Logic 1	com.google.firebase:firebase-ai	17.10.1
Firebase AI Logic On-Device	com.google.firebase:firebase-ai-ondevice	16.0.0-beta01
Firebase AI KSP	com.google.firebase:firebase-ai-ksp-processor	16.0.1
Analytics	com.google.firebase:firebase-analytics	23.2.0
Provedor personalizado do App Check	com.google.firebase:firebase-appcheck	19.0.2
Provedor de depuração do App Check	com.google.firebase:firebase-appcheck-debug	19.0.2
Provedor da Play Integrity para App Check	com.google.firebase:firebase-appcheck-playintegrity	19.0.2
App Distribution	com.google.firebase:firebase-appdistribution	16.0.0-beta17
API do App Distribution	com.google.firebase:firebase-appdistribution-api	16.0.0-beta17
Plug-in do App Distribution	com.google.firebase:firebase-appdistribution-gradle	5.2.1
Authentication	com.google.firebase:firebase-auth	24.0.1
Cloud Firestore	com.google.firebase:firebase-firestore	26.1.2
Cloud Functions for Firebase Client SDK	com.google.firebase:firebase-functions	22.1.0
Cloud Messaging	com.google.firebase:firebase-messaging	25.0.1
Cloud Storage	com.google.firebase:firebase-storage	22.0.1
Crashlytics	com.google.firebase:firebase-crashlytics	20.0.4
NDK do Crashlytics	com.google.firebase:firebase-crashlytics-ndk	20.0.4
Plug-in do Crashlytics	com.google.firebase:firebase-crashlytics-gradle	3.0.6
Data Connect	com.google.firebase:firebase-dataconnect	17.2.0
Suporte para o módulo de recurso dinâmico	com.google.firebase:firebase-dynamic-module-support	16.0.0-beta04
In-App Messaging	com.google.firebase:firebase-inappmessaging	22.0.2	(obrigatório)
Display do In-App Messaging	com.google.firebase:firebase-inappmessaging-display	22.0.2	(obrigatório)
Firebase Instalações	com.google.firebase:firebase-installations	19.1.0
API Model Downloader do Firebase ML	com.google.firebase:firebase-ml-modeldownloader	26.0.1
Performance Monitoring	com.google.firebase:firebase-perf	22.0.4
Plug-in do Performance Monitoring	com.google.firebase:perf-plugin	2.0.2
Firebase Phone Number Verification	com.google.firebase:firebase-pnv	16.0.0
Realtime Database	com.google.firebase:firebase-database	22.0.1
Remote Config	com.google.firebase:firebase-config	23.0.1
Plug-in do Google Play Services	com.google.gms:google-services	4.4.4
BIBLIOTECAS DESCONTINUADAS OU SEM SUPORTE
Dynamic Links	com.google.firebase:firebase-dynamic-links	22.1.0
Módulos KTX do Firebase: não são mais compatíveis Analytics Não use. As bibliotecas de módulos KTX não são mais compatíveis. com.google.firebase:firebase-analytics-ktx 22.5.0 Provedor personalizado do App Check Não use. As bibliotecas de módulos KTX não são mais compatíveis. com.google.firebase:firebase-appcheck-ktx 18.0.0 API do App Distribution Não use. As bibliotecas de módulos KTX não são mais compatíveis. com.google.firebase:firebase-appdistribution-api-ktx 16.0.0-beta15 Authentication Não use. As bibliotecas de módulos KTX não são mais compatíveis. com.google.firebase:firebase-auth-ktx 23.2.1 Cloud Firestore Não use. As bibliotecas de módulos KTX não são mais compatíveis. com.google.firebase:firebase-firestore-ktx 25.1.4 Cloud Functions for Firebase Client SDK Não use. As bibliotecas de módulos KTX não são mais compatíveis. com.google.firebase:firebase-functions-ktx 21.2.1 Cloud Messaging Não use. As bibliotecas de módulos KTX não são mais compatíveis. com.google.firebase:firebase-messaging-ktx 24.1.2 Cloud Storage Não use. As bibliotecas de módulos KTX não são mais compatíveis. com.google.firebase:firebase-storage-ktx 21.0.2 Crashlytics Não use. As bibliotecas de módulos KTX não são mais compatíveis. com.google.firebase:firebase-crashlytics-ktx 19.4.4 Dynamic Links Não use. As bibliotecas de módulos KTX não são mais compatíveis. com.google.firebase:firebase-dynamic-links-ktx 22.1.0 In-App Messaging Não use. As bibliotecas de módulos KTX não são mais compatíveis. com.google.firebase:firebase-inappmessaging-ktx 21.0.2 (obrigatório) Display do In-App Messaging Não use. As bibliotecas de módulos KTX não são mais compatíveis. com.google.firebase:firebase-inappmessaging-display-ktx 21.0.2 (obrigatório) Firebase Instalações Não use. As bibliotecas de módulos KTX não são mais compatíveis. com.google.firebase:firebase-installations-ktx 18.0.0 API Model Downloader do Firebase ML Não use. As bibliotecas de módulos KTX não são mais compatíveis. com.google.firebase:firebase-ml-modeldownloader-ktx 25.0.1 Performance Monitoring Não use. As bibliotecas de módulos KTX não são mais compatíveis. com.google.firebase:firebase-perf-ktx 21.0.5 Realtime Database Não use. As bibliotecas de módulos KTX não são mais compatíveis. com.google.firebase:firebase-database-ktx 21.0.0 Remote Config Não use. As bibliotecas de módulos KTX não são mais compatíveis. com.google.firebase:firebase-config-ktx 22.1.2
Bibliotecas do Kit de ML do Firebase Firebase ML APIs de modelo personalizado com.google.firebase:firebase-ml-model-interpreter 22.0.4 APIs Vision do Firebase ML com.google.firebase:firebase-ml-vision 24.1.0 Firebase ML: modelo de identificador 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 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-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

^{1 Firebase AI Logic antes se chamava "Vertex AI in Firebase" com o pacote com.google.firebase:firebase-vertexai.}

---

Próximas etapas

Adicione serviços do Firebase ao seu app:

• Crie recursos de IA generativa com modelos Gemini e Imagen usando Firebase AI Logic.

• Receba insights sobre o comportamento dos usuários com o Analytics.

• Configure um fluxo de autenticação do usuário com o Authentication.

• Armazene dados, como informações do usuário, usando o Cloud Firestore ou o Realtime Database.

• Armazene arquivos, como fotos e vídeos, usando Cloud Storage.

• Acione o código de back-end que é executado em um ambiente seguro com o Cloud Functions.

• Envie notificações com Cloud Messaging.

• Use o Crashlytics e descubra quando e por que seu app apresenta falhas.

Saiba mais sobre o Firebase:

• Para ver projetos do Firebase e práticas recomendadas, consulte Noções básicas sobre projetos do Firebase.

• Acesse Saiba mais sobre o Android e o Firebase se tiver dúvidas sobre conceitos que não são muito conhecidos ou que são específicos do desenvolvimento no Firebase e no Android.

• Conheça os apps de exemplo do Firebase.

• Aprenda a usar o Firebase Android Codelab na prática.

• Saiba mais com o curso Firebase em um fim de semana.

• Prepare-se para lançar seu aplicativo:

  • Configure os alertas de orçamento para seu projeto no console Google Cloud.
  • Monitore o painel Uso e faturamento no console do Firebase para ter uma visão geral do uso do projeto em vários serviços do Firebase.
  • Consulte a lista de verificação de lançamento do Firebase.

• Problemas com o Firebase e o projeto do Android? Consulte a Solução de problemas e perguntas frequentes sobre o Android.