Adicionar o Firebase ao seu projeto do Android

Pré-requisitos

  • um dispositivo com Android 4.0 (Ice Cream Sandwich) ou uma versão mais recente e o Google Play Services 15.0.0 ou posterior
  • a versão mais recente do Android Studio

Se você ainda não tiver um projeto do Android Studio e quiser testar um recurso do Firebase, faça o download de um de nossos exemplos do guia de início rápido. Se você estiver usando um exemplo para início rápido, lembre-se de coletar o código do aplicativo do arquivo build.gradle, que geralmente fica na pasta app/, do módulo do seu projeto. Você precisará do nome desse pacote na próxima etapa.

Adicionar o Firebase ao app

Se você estiver usando o Android Studio versão 2.2 ou posterior, o Firebase Assistant é a maneira mais simples de conectar seu app ao Firebase. O Assistant pode conectar um projeto existente ou criar um novo para você com todas as dependências do Gradle necessárias.

Se você usar uma versão mais antiga do Android Studio ou tiver uma configuração de projeto mais complexa, ainda poderá adicionar manualmente o Firebase ao seu app.

Usar o Firebase Assistant

Para abrir o Firebase Assistant no Android Studio:

  • Clique em Ferramentas > Firebase para abrir a janela Assistant.
  • clique para expandir um dos recursos listados (por exemplo, Analytics) e clique no link do tutorial fornecido (por exemplo, "Registrar um evento do Analytics");
  • clique no botão Conectar ao Firebase para se conectar ao Firebase e adicionar o código necessário ao seu app.

Pronto! Você pode pular para as próximas etapas.

Adicionar o Firebase manualmente

Adicione o Firebase ao app. Para isso, serão necessários um projeto e um arquivo de configuração do Firebase para o app.

Para criar um projeto do Firebase:

  1. Crie um projeto no Firebase console se ainda não tiver um. Clique em Adicionar projeto. Se você já tiver um projeto do Google associado ao seu aplicativo para dispositivos móveis, selecione-o no menu suspenso Nome do projeto. Caso contrário, insira um nome de projeto para criar um novo.
  2. Opcional: edite o Código do projeto. Seu projeto recebe automaticamente um código exclusivo que é usado em recursos do Firebase visíveis publicamente, como URLs de bancos de dados e seu subdomínio do Firebase Hosting. Você pode alterá-lo agora se quiser usar um subdomínio específico.
  3. Siga as demais etapas de configuração e clique em Criar projeto, ou Adicionar Firebase se você estiver usando um projeto existente, para começar a provisionar recursos para o projeto. Isso costuma levar alguns minutos. Quando o processo for concluído, você será levado à visão geral do projeto.

Agora que você tem um projeto, adicione seu app para Android a ele:

  1. Clique em Adicionar o Firebase ao app para Android e siga as etapas de configuração. Se você estiver importando um projeto do Google, isso pode ocorrer automaticamente. Basta fazer o download do arquivo de configuração.
  2. Quando solicitado, digite o nome do pacote do seu app. É importante inserir o nome do pacote usado pelo seu app. Essa configuração só pode ser feita quando você adiciona um app ao seu projeto do Firebase.
  3. Durante o processo, você fará o download de um arquivo google-services.json. Você pode fazer o download desse arquivo novamente a qualquer momento.
  4. Depois de adicionar o código de inicialização, execute seu aplicativo para enviar ao Firebase console a confirmação de que você instalou o Firebase com sucesso.
Adicionar o SDK

Se você quiser integrar as bibliotecas do Firebase a um de seus projetos, precisará executar algumas tarefas básicas para preparar o projeto do Android Studio. Talvez você já tenha feito isso quando adicionou o Firebase ao seu app.

Primeiro, adicione regras ao seu arquivo build.gradle no nível raiz para incluir o plug-in google-services e o repositório Maven do Google:

buildscript {
    // ...
    dependencies {
        // ...
        classpath 'com.google.gms:google-services:4.0.1' // google-services plugin
    }
}

allprojects {
    // ...
    repositories {
        // ...
        google() // Google's Maven repository
    }
}

Em seguida, no arquivo Gradle do módulo (geralmente app/build.gradle), adicione a linha apply plugin na parte inferior do arquivo para ativar o plug-in do Gradle:

apply plugin: 'com.android.application'

android {
  // ...
}

dependencies {
  // ...
  implementation 'com.google.firebase:firebase-core:16.0.1'

  // Getting a "Could not find" error? Make sure you have
  // added the Google maven respository to your root build.gradle
}

// ADD THIS AT THE BOTTOM
apply plugin: 'com.google.gms.google-services'

Você também precisa adicionar as dependências dos SDKs do Firebase que quer usar. Recomendamos começar com com.google.firebase:firebase-core, que fornece a funcionalidade do Google Analytics para Firebase. Consulte a lista de bibliotecas disponíveis.

Bibliotecas disponíveis

As seguintes bibliotecas estão disponíveis para os diversos recursos do Firebase.

Linha de dependência do Gradle Serviço
com.google.firebase:firebase-core:16.0.1 Analytics
com.google.firebase:firebase-database:16.0.1 Realtime Database
com.google.firebase:firebase-firestore:17.0.1 Cloud Firestore
com.google.firebase:firebase-storage:16.0.1 Storage
com.google.firebase:firebase-crash:16.0.1 Crash reporting
com.google.firebase:firebase-auth:16.0.2 Authentication
com.google.firebase:firebase-messaging:17.0.0 Cloud Messaging
com.google.firebase:firebase-config:16.0.0 Configuração remota
com.google.firebase:firebase-invites:16.0.1 Firebase Invites e Dynamic Links
com.google.firebase:firebase-ads:15.0.1 AdMob
com.google.firebase:firebase-appindexing:16.0.1 Indexação de apps
com.google.firebase:firebase-perf:16.0.0 Monitoramento de Desempenho
com.google.firebase:firebase-functions:16.0.1 SDK de cliente do Cloud Functions para Firebase
com.google.firebase:firebase-ml-vision:16.0.0 Kit de aprendizado de máquina (visão)
com.google.firebase:firebase-ml-tensorflow:16.0.0 Kit de aprendizado de máquina (modelo personalizado)

Próximas etapas

Saiba mais sobre o Firebase:

Adicione recursos do Firebase ao seu app:

Enviar comentários sobre…

Precisa de ajuda? Acesse nossa página de suporte.