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 aos requisitos a seguir:

  • Visa o nível 16 da API (Jelly Bean) ou versões posteriores.
  • Usa o Android 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 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.

Criar um projeto do Firebase

1. No Console do Firebase, clique em Adicionar projeto e depois selecione ou insira o Nome do projeto.

   Se você tiver um projeto do Google Cloud, poderá selecioná-lo no menu suspenso para adicionar recursos do Firebase.

2. (Opcional) Se você estiver criando um novo projeto, poderá editar o ID do projeto.

   O Firebase atribui automaticamente um ID exclusivo ao seu projeto. Consulte Noções básicas sobre projetos do Firebase para entender melhor como o Firebase usa o ID do projeto.

3. Clique em Continuar.

4. (Opcional) Configure o Google Analytics para o seu projeto, permitindo que você tenha uma ótima experiência ao usar qualquer um dos seguintes produtos do Firebase:

   Firebase Crashlytics Firebase Previsões

   Firebase Cloud Messaging Mensagens no app Firebase

   Configuração remota do Firebase Teste A/B do Firebase

   Quando solicitado, selecione para usar uma Conta do Google Analytics ou criar uma nova conta.
   Se você decidir criar uma nova conta, selecione seu local de relatórios do Analytics e aceite as configurações de compartilhamento de dados e os termos do Google Analytics relacionados ao seu projeto.

5. Clique em Criar projeto (ou Adicionar Firebase, se você estiver usando um projeto do Google Cloud).

O Firebase provisiona recursos automaticamente para seu projeto. Quando o processo for concluído, você será direcionado para a página de visão geral do projeto 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 (plat_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.

   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 do Firebase para Android depois de ser registrado no projeto.

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

   Como o apelido do app e o certificado de assinatura SHA-1 de depuração são usados no Firebase?

   • Apelido do app: um identificador interno conveniente que só é visível para você no Console do Firebase.

   • Certificado de assinatura SHA-1 de depuração: um hash SHA-1 é exigido pelo Firebase Authentication (ao usar o Login do Google ou o login com número de telefone) e pelo Firebase Dynamic Links.

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.

   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. Para saber mais sobre esse arquivo de configuração, 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 o nome do arquivo de configuração não está anexado com caracteres adicionais, como (2).

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.1')
   
     // 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.1')
   
     // 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.1')
   
     // 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.1')
   
     // 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.

   Ocorre uma falha de build com respeito à compatibilidade entre invocação-personalização e a ativação da simplificação? Saiba como corrigir isso.

   Builds do Gradle que usam o Plug-in do Android para Gradle (AGP) v4.2 ou anterior precisam ativar a compatibilidade com Java 8. Caso contrário, esses projetos Android receberão uma falha de build 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 no nível do app.
   • Aumente o minSdkVersion 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 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.

      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:

        • Consulte Noções básicas sobre projetos do Firebase para ver práticas recomendadas e informações sobre como adicionar apps a um projeto, incluindo como lidar com diversas variantes de build.

        • Se você criar um novo projeto, é altamente recomendável configurar o Google Analytics para o projeto, 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. Veja mais informações sobre estas bibliotecas do Firebase para Android:

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

• Repositório do GitHub do SDK 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.

---

Próximas etapas

Adicione serviços do Firebase ao seu app:

• 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, com o Cloud Storage.

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

• Envie notificações com o 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 específicos para o desenvolvimento do Firebase e do Android.

• Conheça os aplicativos de amostra 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 alertas de orçamento para o projeto no Console do 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.