Adicionar o Firebase ao seu projeto do Android

Pr-requisitos

Um dispositivo com Android 4.0 (Ice Cream Sandwich) ou uma verso mais recente, e o Google Play Services 11.0.4 ou posterior.

O SDK do Google Play Services do Repositrio do Google, disponvel no Gerenciador de SDK do Android
(https://developer.android.com/studio/intro/update.html?hl=pt-br#sdk-manager).

A verso mais recente do Android Studio (http://developer.android.com/sdk?hl=pt-br) (1.5 ou superior).

Se voc ainda no tiver um projeto do Android Studio e quiser testar um recurso do Firebase, faa o download de um de nossos exemplos para
incio rpido (https://firebase.google.com/docs/samples/?hl=pt-br). Se voc estiver usando um exemplo para incio rpido, lembre-se de coletar o cdigo do
aplicativo do arquivo build.gradle, que geralmente fica na pasta app/, do mdulo do seu projeto. Voc precisar do nome desse pacote na prxima
etapa.

Observao: se voc estiver fazendo upgrade de uma verso 2.X do SDK do Firebase, consulte nosso guia de upgrade para Android
(https://firebase.google.com/support/guides/firebase-android?hl=pt-br) para comear.

Adicionar o Firebase ao seu app

Se voc tiver a verso mais recente do Android Studio (verso 2.2 ou posterior), recomendamos o uso do Firebase Assistant
(//developer.android.com/studio/write/firebase.html?hl=pt-br) para conectar seu app ao Firebase. Com o Firebase Assistant, voc pode conectar seu projeto
existente ou criar um novo e instalar automaticamente qualquer dependncia de gradle.

Se voc usar uma verso mais antiga do Android Studio ou tiver uma configurao de projeto mais complexa, ainda pode adicionar manualmente o
Firebase ao seu app (#manually_add_firebase).

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 boto Conectar ao Firebase para se conectar ao Firebase e adicionar o cdigo necessrio ao seu app.

Pronto! Voc pode pular para as prximas etapas (#next_steps).

Adicionar o Firebase manualmente

Se voc preferir no usar o Firebase Assistant, ainda pode adicionar o Firebase ao seu app por meio do Firebase console.

Para adicionar o Firebase ao seu app, voc precisar de um projeto e um arquivo de configurao do Firebase.

1. Se voc ainda no tem um projeto, crie um no Firebase console (//console.firebase.google.com/?hl=pt-br). Clique em Importar projeto do Google
se voc j tem um desses projetos associados ao seu app para dispositivos mveis. Caso contrrio, clique em Criar novo projeto.
 2. Clique em Adicionar o Firebase ao seu aplicativo Android e siga as etapas de configurao. Se voc estiver importando um projeto do
Google, isso pode ocorrer automaticamente. Basta fazer o download do arquivo de configurao
(http://support.google.com/firebase/answer/7015592?hl=pt-br).

3. Quando solicitado, digite o nome do pacote do seu app. importante inserir o nome do pacote usado pelo seu app. Essa configurao s pode
ser feita quando voc adiciona um app ao seu projeto do Firebase.
4. Por ltimo, voc far o download de um arquivo google-services.json. Voc pode fazer o download dele
(http://support.google.com/firebase/answer/7015592?hl=pt-br) novamente a qualquer momento.

5. Se voc ainda no fez isso, copie-o para a pasta do mdulo do seu projeto, que geralmente app/.

Observao: se voc tiver muitas variantes de verso com diferentes nomes de pacote definidos, adicione cada app ao seu projeto no Firebase console.

Adicionar o SDK

Se voc deseja integrar as bibliotecas do Firebase a um de seus projetos, precisa executar algumas tarefas bsicas 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 nvel raiz para incluir o plug-in google-services:

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

Em seguida, no arquivo Gradle do mdulo (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 {
// ...
compile 'com.google.firebase:firebase-core:11.0.4'

// Getting a "Could not find" error? Make sure you have

// the latest Google Repository in the Android SDK manager
}

// ADD THIS AT THE BOTTOM

apply plugin: 'com.google.gms.google-services'

Voc tambm precisa adicionar as dependncias dos SDKs do Firebase que deseja usar. Recomendamos que voc comece com
com.google.firebase:firebase-core, que fornece a funcionalidade do Google Analytics para Firebase. Consulte a lista de bibliotecas disponveis
(https://firebase.google.com/docs/android/setup?hl=pt-br#available_libraries).

Observao: para saber mais sobre o que o plug-in do Gradle faz, consulte o guia do plug-in do Gradle do Google Services
(https://developers.google.com/android/guides/google-services-plugin?hl=pt-br).

Bibliotecas disponveis

As seguintes bibliotecas esto disponveis para os diversos recursos do Firebase.

Linha de dependncia do Gradle Servio

com.google.firebase:firebase-core:11.0.4 Analytics

com.google.firebase:firebase-database:11.0.4 Realtime Database

com.google.firebase:firebase-storage:11.0.4 Storage
Linha de dependncia do Gradle Servio

com.google.firebase:firebase-crash:11.0.4 Crash Reporting

com.google.firebase:firebase-auth:11.0.4 Authentication

com.google.firebase:firebase-messaging:11.0.4 Cloud Messaging

com.google.firebase:firebase-config:11.0.4 Configurao remota

com.google.firebase:firebase-invites:11.0.4 Invites e Dynamic Links

com.google.firebase:firebase-ads:11.0.4 AdMob

com.google.firebase:firebase-appindexing:11.0.4 Indexao de apps

com.google.firebase:firebase-perf:11.0.4 Monitoramento de Desempenho

Observao: com.google.firebase:firebase-core um alias recomendado para a biblioteca com.google.firebase:firebase-analytics.

Prximas etapas

Saiba mais sobre o Firebase:

Explore os aplicativos de amostra do Firebase (https://firebase.google.com/docs/samples?hl=pt-br).

Aprenda a usar o Firebase Android Codelab (https://codelabs.developers.google.com/codelabs/firebase-android/?hl=pt-br) na prtica.

Saiba mais com o curso Firebase em um fim de semana (https://www.udacity.com/course/ud0352).

Adicione recursos do Firebase ao seu app:

Receba insights sobre o comportamento dos usurios com o Analytics (https://firebase.google.com/docs/analytics/?hl=pt-br).

Configure a autenticao dos usurios com o Authentication (https://firebase.google.com/docs/auth/?hl=pt-br).

Armazene informaes do usurio com o Realtime Database (https://firebase.google.com/docs/database/?hl=pt-br) ou dados de blob com o Cloud
Storage (https://firebase.google.com/docs/storage/?hl=pt-br).

Envie notificaes aos usurios com o Cloud Messaging (https://firebase.google.com/docs/cloud-messaging/?hl=pt-br).

Descubra quando e por que seu app apresenta falhas com o Crash Reporting (https://firebase.google.com/docs/crash/?hl=pt-br).

Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 3.0 License (http://creativecommons.org/licenses/by/3.0/), and code
samples are licensed under the Apache 2.0 License (http://www.apache.org/licenses/LICENSE-2.0). For details, see our Site Policies
(https://developers.google.com/terms/site-policies?hl=pt-br). Java is a registered trademark of Oracle and/or its affiliates.

Last updated Outubro 5, 2017.