Adicionar o Firebase ao projeto para Android

Pré-requisitos

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

• Certifique-se de que seu app para Android:

  • segmente o nível 16 da API (Jelly Bean) ou versões posteriores;
  • use o Gradle 4.1 ou versões posteriores.

• Configure um dispositivo ou emulador para executar seu aplicativo.

  • Emuladores precisam usar uma imagem de emulador no Google Play.

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

Se você ainda não tem um projeto de app Android, faça o download de um dos nossos exemplos de início rápido se quiser conhecer um produto do Firebase.

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 (requer 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 app para Android, é preciso criar um projeto para conectar ao aplicativo. Para mais informações, consulte Noções básicas sobre projetos do Firebase.

Etapa 2: registrar seu app com o Firebase

Depois de criar um projeto do Firebase, é possível adicionar seu app para Android a ele.

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 criação.

1. No centro da página de visão geral do projeto do Console do Firebase, clique no ícone do Android para iniciar o fluxo de trabalho de configuração.

   Se você já adicionou um aplicativo ao seu projeto do Firebase, clique em Adicionar app para exibir as opções da plataforma.

2. Insira o ID do aplicativo no campo Nome do pacote do Android.

   • Às vezes, um ID do aplicativo é chamado de nome do pacote.

   • Esse ID do aplicativo é encontrado no arquivo Gradle do seu módulo (nível do app), geralmente app/build.gradle (exemplo de ID: com.yourcompany.yourproject).

3. (Opcional) Insira outras informações do app conforme solicitado pelo fluxo de trabalho de configuração.

   O apelido é um identificador interno de conveniência e só é visível no Console do Firebase.

4. Clique em Registrar aplicativo.

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

1. Para adicionar o arquivo de configuração do Firebase para Android no 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).

      • É possível fazer o download do arquivo de configuração do Firebase para Android novamente a qualquer momento.
      • Verifique se não há caracteres adicionais no arquivo de configuração, como (2).

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

2. Para ativar os produtos do Firebase no seu app, adicione o plug-in google-services aos seus arquivos do Gradle.

   1. No nível raiz (nível do projeto) do seu arquivo Gradle (build.gradle), adicione regras para incluir o plug-in do Google Services. 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.2.0'  // Google Services plugin
        }
      }
      
      allprojects {
        // ...
      
        repositories {
          // Check that you have the following line (if not, add it):
          google()  // Google's Maven repository
          // ...
        }
      }
      

   2. No arquivo Gradle do seu módulo (nível do app) (geralmente app/build.gradle), adicione a seguinte linha no fim do arquivo.

      apply plugin: 'com.android.application'
      
      android {
        // ...
      }
      
      // Add the following line to the bottom of the file:
      apply plugin: 'com.google.gms.google-services'  // Google Play services Gradle plugin
      

Etapa 4: adicionar SDKs do Firebase ao seu app

É possível adicionar qualquer um dos produtos do Firebase compatíveis ao seu app para Android. Recomendamos começar com o SDK básico do Firebase (com.google.firebase:firebase-core), que oferece a funcionalidade do Google Analytics para Firebase.

1. No seu arquivo Gradle do módulo (nível do app) (geralmente app/build.gradle), adicione a dependência do SDK básico do Firebase:

   dependencies {
    // ...
    implementation 'com.google.firebase:firebase-core:17.0.0'
   
    // Getting a "Could not find" error? Make sure that you've added
    // Google's Maven repository to your root-level build.gradle file
   }
   

2. (Opcional) Adicione as dependências para as outras bibliotecas do Firebase que você pretende usar.

   Alguns SDKs do Firebase para Android oferecem uma biblioteca alternativa de extensões do Kotlin (em inglês).

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

4. Execute seu app para enviar ao Firebase a confirmação de que você integrou o Firebase com sucesso.

   Os registros do dispositivo exibirão a verificação do Firebase de que a inicialização foi concluída. Se você executou seu app em um emulador com acesso à rede, o Console do Firebase notifica que a conexão do aplicativo está completa.

Pronto. Você pode seguir para as próximas etapas.

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 e o código necessários ao seu projeto do Android. Tudo isso a partir do Android Studio.

Observe que a opção recomendada para conectar seu app ao Firebase é usar o fluxo de trabalho de configuração do Console do Firebase.

1. Abra seu projeto do Android no Android Studio.

2. Selecione Ferramentas > Firebase para abrir a janela do Assistente.

3. Expanda um dos produtos do Firebase listados (por exemplo, Analytics) e clique no link do tutorial fornecido, por exemplo, "Registrar um evento do Analytics".

4. Clique em Conectar ao Firebase para registrar seu app com um projeto existente ou novo e adicionar automaticamente os arquivos e códigos necessários a ele.

5. Verifique se as versões do plug-in e da biblioteca estão atualizadas:

   • No arquivo Gradle (build.gradle) do seu nível raiz (nível do projeto), verifique se a versão do plug-in do Google Services está atualizada (com.google.gms:google-services:4.2.0).

   • No arquivo Gradle (geralmente app/build.gradle) do seu módulo (nível do app), verifique se as versões da biblioteca do Firebase para Android estão atualizadas.

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

7. Defina suas configurações de compartilhamento de dados do Analytics nas Configurações do projeto do Console do Firebase.
   É necessário ativar o compartilhamento de dados do Google Analytics com outros produtos do Firebase para usar produtos como o Firebase Previsões ou o Teste A/B do Firebase.

8. Execute seu app para enviar ao Firebase a confirmação de que você integrou o Firebase com sucesso.

   Os registros do dispositivo exibirão a verificação do Firebase de que a inicialização foi concluída. Se você executou seu app em um emulador com acesso à rede, o Console do Firebase notifica que a conexão do aplicativo está completa.

Bibliotecas disponíveis

As seguintes bibliotecas do Android estão disponíveis para os vários produtos do Firebase.

Alguns SDKs do Firebase para Android oferecem uma biblioteca alternativa de extensões do Kotlin (em inglês).

Controle de versão da biblioteca com uma lista de materiais (BoM) do Firebase (experimental)

Para facilitar o gerenciamento da versão da biblioteca, importe uma lista de materiais (BoM, na sigla em inglês) do Firebase.

A seguir

Saiba mais sobre o Firebase:

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

• 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:

  • Defina alertas de faturamento.
  • Consulte a lista de verificação de lançamento do Firebase.

Adicione recursos 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.