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.

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 Platform (GCP), poderá selecioná-lo no menu suspenso para adicionar recursos do Firebase.

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

   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 seu projeto, permitindo que você tenha uma experiência ideal ao usar qualquer um dos seguintes produtos do Firebase:

   Firebase Crashlytics Firebase Previsões

   Firebase Cloud Messaging Mensagens no app do 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.
   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 GCP).

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 seu 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 aplicativo 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 de conveniência 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 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 você precisa 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 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.

      O que esse fluxo de trabalho faz?

      • Este fluxo de trabalho cria automaticamente um novo app do Firebase para Android 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 versões.

        • 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).

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:

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

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

---

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.

• Descubra quando e por que seu app apresenta falhas com o Crashlytics.

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 específicos ou específicos para o desenvolvimento do Firebase e do Android.

• Conheça os aplicativos de amostra do Firebase (em inglês).

• Aprenda a usar o Firebase Android Codelab (em inglês) na prática.

• Saiba mais com o curso Firebase em um fim de semana (em inglês).

• Prepare-se para lançar seu aplicativo:

  • Configure alertas de orçamento para seu projeto no console do GCP.
  • Monitore seu Painel de uso e faturamento no Console do Firebase.
  • Consulte a lista de verificação de lançamento do Firebase.