Adicionar o Firebase ao seu projeto do Android

Pré-requisitos

  • Um dispositivo que execute:
    • Android 4.1 ou versão posterior (API nível 14, Jelly Bean);
    • 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 o início rápido, anote o código do aplicativo do arquivo build.gradle, que geralmente fica na pasta app/ do módulo do seu project. 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 Assistente é a maneira mais simples de conectar seu app ao Firebase. O Assistente 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 Assistente

Para abrir o Firebase Assistente no Android Studio:

  • Clique em Ferramentas > Firebase para abrir a janela Assistente.
  • 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. Acesse o Console do Firebase.

  2. Clique em Adicionar projeto e selecione ou insira o Nome do projeto.

    • Se você tiver um projeto do Google associado ao seu aplicativo, selecione o projeto no menu suspenso Nome do projeto.
    • Se você não tiver um projeto do Google, insira o novo Nome do projeto.
  3. (Opcional) Edite o código do projeto.

    O Firebase atribui automaticamente um código exclusivo ao seu projeto. Ele é exibido em serviços do Firebase visíveis publicamente, por exemplo:

    • URL padrão do Realtime Database: your-project-id.firebaseio.com
    • Nome padrão do intervalo do Cloud Storage: your-project-id.appspot.com
    • Subdomínio padrão do Hosting: your-project-id.firebaseapp.com
  4. Siga as demais etapas de configuração no Console do Firebase e clique em Criar projeto, ou Adicionar Firebase, se estiver usando um projeto atual do Google.

O Firebase provisiona recursos automaticamente para seu projeto. O processo normalmente leva alguns minutos. Quando o processo for concluído, você será direcionado para a página de visão geral do seu projeto no Console do Firebase.

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 poderá ocorrer automaticamente. Basta fazer o download do arquivo de configuração.

  2. Quando solicitado, digite o nome do pacote do app. É importante inserir o nome do pacote usado por seu app. No entanto, essa configuração será feita apenas quando você adicionar um app ao projeto do Firebase.

  3. 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.

    2. Mova o arquivo de configuração para o mesmo diretório que o arquivo build.gradle no nível raiz.

  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 dos seus projetos, precisará realizar 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.2.0' // 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.7'

  // 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.7 Analytics
com.google.firebase:firebase-database:16.0.6 Realtime Database
com.google.firebase:firebase-firestore:18.0.1 Cloud Firestore
com.google.firebase:firebase-storage:16.0.5 Storage
com.crashlytics.sdk.android:crashlytics:2.9.9 Crashlytics
com.google.firebase:firebase-auth:16.1.0 Authentication
com.google.firebase:firebase-messaging:17.3.4 Cloud Messaging
com.google.firebase:firebase-config:16.3.0 Configuração remota
com.google.firebase:firebase-invites:16.1.0 Invites e Dynamic Links
com.google.firebase:firebase-ads:17.1.3 AdMob
com.google.firebase:firebase-appindexing:17.1.0 App Indexing
com.google.firebase:firebase-perf:16.2.3 Monitoramento de desempenho
com.google.firebase:firebase-functions:16.1.3 SDK de cliente do Cloud Functions para Firebase
com.google.firebase:firebase-ml-vision:19.0.2 Kit de ML (Vision)
com.google.firebase:firebase-ml-model-interpreter:17.0.3 Kit de ML (modelo personalizado)
com.google.firebase:firebase-ml-natural-language:18.1.1 Kit de ML (linguagem natural)
com.google.firebase:firebase-ml-natural-language-language-id-model:18.0.2 Kit de ML (modelo de código de linguagem natural)

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.