Pré-requisitos
Instale ou atualize o Android Studio para a versão mais recente.
Certifique-se de que seu projeto atenda a estes requisitos:
- Segmenta API de nível 19 (KitKat) ou superior
- Usa Android 4.4 ou superior
- Usa Jetpack (AndroidX) , o que inclui atender a estes 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.
Observe que os SDKs do Firebase com dependência do Google Play Services exigem que o dispositivo ou emulador tenha o Google Play Services instalado.Faça login no Firebase usando sua conta do Google.
Se você ainda não tem um projeto Android e quer apenas experimentar um produto Firebase, pode baixar um de nossos exemplos de início rápido .
Você pode conectar seu aplicativo Android ao Firebase usando uma das seguintes opções:
- Opção 1 : (recomendado) Use o fluxo de trabalho de configuração do Firebase console.
- Opção 2 : Use o Android Studio Firebase Assistant (pode exigir configuração adicional).
Opção 1 : adicionar Firebase usando o Firebase console
Adicionar o Firebase ao seu aplicativo envolve tarefas no console do Firebase e em seu projeto Android aberto (por exemplo, você baixa os arquivos de configuração do Firebase do console e os move para o seu projeto Android).
Etapa 1 : criar um projeto do Firebase
Antes de adicionar o Firebase ao seu aplicativo Android, você precisa criar um projeto do Firebase para se conectar ao seu aplicativo Android. Acesse Entenda os projetos do Firebase para saber mais sobre os projetos do Firebase.
Etapa 2 : registre seu aplicativo no Firebase
Para usar o Firebase em seu aplicativo Android, você precisa registrar seu aplicativo com seu projeto Firebase. Registrar seu aplicativo geralmente é chamado de "adicionar" seu aplicativo ao seu projeto.
Acesse o console do Firebase .
No centro da página de visão geral do projeto, clique no ícone do Android (
) ou Adicionar aplicativo para iniciar o fluxo de trabalho de configuração.Digite o nome do pacote do seu aplicativo no campo de nome do pacote Android .
Um nome de pacote identifica exclusivamente seu aplicativo no dispositivo e na Google Play Store.
Um nome de pacote geralmente é chamado de ID de aplicativo .
Encontre o nome do pacote do seu aplicativo no arquivo Gradle do módulo (nível do aplicativo), geralmente
app/build.gradle
(exemplo de nome do pacote:com.yourcompany.yourproject
).Esteja ciente de que o valor do nome do pacote diferencia maiúsculas de minúsculas e não pode ser alterado para este aplicativo Firebase para Android depois de registrado com seu projeto Firebase.
(Opcional) Insira outras informações do aplicativo: Apelido do aplicativo e Certificado de assinatura de depuração SHA-1 .
Apelido do aplicativo : um identificador de conveniência interno que só é visível para você no console do Firebase
Certificado de assinatura de depuração SHA-1 : um hash SHA-1 é exigido pelo Firebase Authentication (ao usar o Login do Google ou login com número de telefone ) e Firebase Dynamic Links .
Clique em Registrar aplicativo .
Etapa 3 : adicionar um arquivo de configuração do Firebase
Baixe e adicione o arquivo de configuração Firebase Android (
) ao seu aplicativo:google-services.json Clique em Baixar google-services.json para obter o arquivo de configuração do Firebase Android.
Mova seu arquivo de configuração para o diretório raiz do módulo (nível do aplicativo) do seu aplicativo.
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, visite Entenda os projetos do Firebase .
Você pode baixar o arquivo de configuração do Firebase novamente a qualquer momento.
Certifique-se de que o nome do arquivo de configuração não contenha caracteres adicionais, como
(2)
.
Para tornar os valores em seu arquivo de configuração
acessíveis aos SDKs do Firebase, você precisa do plug-in Gradle de serviços do Google (google-services.json google-services
).Em seu arquivo Gradle de nível raiz (nível de projeto) (
<project>/build.gradle
), adicione o plug-in de serviços do Google como uma dependência buildscript:buildscript { repositories { // Make sure that you have the following two repositories google() // Google's Maven repository mavenCentral() // Maven Central repository } dependencies { ... // Add the dependency for the Google services Gradle plugin classpath 'com.google.gms:google-services:4.3.15' } } allprojects { ... repositories { // Make sure that you have the following two repositories google() // Google's Maven repository mavenCentral() // Maven Central repository } }
No arquivo Gradle do módulo (nível do aplicativo) (geralmente
<project>/<app-module>/build.gradle
), adicione o plug-in de serviços do Google:plugins { id 'com.android.application' // Add the Google services Gradle plugin id 'com.google.gms.google-services' ... }
Etapa 4 : adicionar SDKs do Firebase ao seu aplicativo
No arquivo Gradle do módulo (nível do aplicativo) (geralmente
<project>/<app-module>/build.gradle
), adicione as dependências dos produtos Firebase que deseja usar em seu aplicativo. Recomendamos usar o Firebase Android BoM para controlar o controle de versão da biblioteca.Análise habilitada
Kotlin+KTX
dependencies { // ... // Import the Firebase BoM implementation platform('com.google.firebase:firebase-bom:31.2.0') // When using the BoM, you don't specify versions in Firebase library dependencies // Add the dependency for the Firebase SDK for Google Analytics implementation 'com.google.firebase:firebase-analytics-ktx' // TODO: Add the dependencies for any other Firebase products you want to use // See https://firebase.google.com/docs/android/setup#available-libraries // For example, add the dependencies for Firebase Authentication and Cloud Firestore implementation 'com.google.firebase:firebase-auth-ktx' implementation 'com.google.firebase:firebase-firestore-ktx' }
Java
dependencies { // ... // Import the Firebase BoM implementation platform('com.google.firebase:firebase-bom:31.2.0') // When using the BoM, you don't specify versions in Firebase library dependencies // Add the dependency for the Firebase SDK for Google Analytics implementation 'com.google.firebase:firebase-analytics' // TODO: Add the dependencies for any other Firebase products you want to use // See https://firebase.google.com/docs/android/setup#available-libraries // For example, add the dependencies for Firebase Authentication and Cloud Firestore implementation 'com.google.firebase:firebase-auth' implementation 'com.google.firebase:firebase-firestore' }
Ao usar o Firebase Android BoM , seu aplicativo sempre usará versões compatíveis das bibliotecas do Firebase Android.
Análise não habilitada
Kotlin+KTX
dependencies { // ... // Import the Firebase BoM implementation platform('com.google.firebase:firebase-bom:31.2.0') // When using the BoM, you don't specify versions in Firebase library dependencies // TODO: Add the dependencies for Firebase products you want to use // See https://firebase.google.com/docs/android/setup#available-libraries // For example, add the dependencies for Firebase Authentication and Cloud Firestore implementation 'com.google.firebase:firebase-auth-ktx' implementation 'com.google.firebase:firebase-firestore-ktx' }
Java
dependencies { // ... // Import the Firebase BoM implementation platform('com.google.firebase:firebase-bom:31.2.0') // When using the BoM, you don't specify versions in Firebase library dependencies // TODO: Add the dependencies for Firebase products you want to use // See https://firebase.google.com/docs/android/setup#available-libraries // For example, add the dependencies for Firebase Authentication and Cloud Firestore implementation 'com.google.firebase:firebase-auth' implementation 'com.google.firebase:firebase-firestore' }
Ao usar o Firebase Android BoM , seu aplicativo sempre usará versões compatíveis das bibliotecas do Firebase Android.
Depois de adicionar as dependências dos produtos que deseja usar, sincronize seu projeto Android com os arquivos Gradle.
Compilações Gradle que usam o plug-in Android Gradle (AGP) v4.2 ou anterior precisam habilitar o suporte a Java 8. Caso contrário, esses projetos Android apresentarão uma falha de compilação ao adicionar um Firebase SDK.
Para corrigir essa falha de compilação, você pode seguir uma das duas opções:
- Adicione as opções de compilação listadas da mensagem de erro ao arquivo
compileOptions
no nível dobuild.gradle
. - Aumente o
minSdkVersion
para seu projeto Android para 26 ou superior.
Saiba mais sobre esta falha de compilação nesta FAQ .
- Adicione as opções de compilação listadas da mensagem de erro ao arquivo
É isso! Você pode avançar para verificar as próximas etapas recomendadas.
No entanto, se estiver com problemas para configurar, visite a seção de solução de problemas e perguntas frequentes do Android .
Opção 2 : adicionar Firebase usando o Firebase Assistant
O Firebase Assistant registra seu aplicativo com um projeto Firebase e adiciona os arquivos, plug-ins e dependências necessários do Firebase ao seu projeto Android — tudo de dentro do Android Studio!
Abra seu projeto Android no Android Studio e verifique se está usando as versões mais recentes do Android Studio e do Firebase Assistant:
- Windows / Linux: Ajuda > Verificar se há atualizações
- macOS: Android Studio > Verificar atualizações
Abra o Assistente do Firebase: Ferramentas > Firebase .
No painel Assistente , escolha um produto Firebase para adicionar ao seu aplicativo. Expanda sua seção e clique no link do tutorial (por exemplo,
Analytics > Log an Analytics event ).Clique em Conectar ao Firebase para conectar seu projeto Android ao Firebase.
Este fluxo de trabalho cria automaticamente um novo aplicativo Firebase para Android usando o nome do pacote do seu aplicativo . Você pode criar esse novo aplicativo Firebase para Android em um projeto existente do Firebase ou em um novo projeto.
Aqui estão algumas dicas sobre como configurar seu projeto Firebase:
Confira nossas práticas recomendadas para adicionar aplicativos a um projeto do Firebase, incluindo como lidar com várias variantes.
Se você criar um novo projeto, recomendamos que você configure o Google Analytics para seu projeto, o que permite que você tenha uma ótima experiência usando muitos produtos Firebase.
Esse fluxo de trabalho também adiciona o arquivo de configuração do Android do seu projeto do Firebase (
) ao diretório do módulo (nível do aplicativo) do seu aplicativo.google-services.json
Clique no botão para adicionar um produto Firebase desejado (por exemplo,
Adicionar Analytics ao seu aplicativo ).
Sincronize seu aplicativo para garantir que todas as dependências tenham as versões necessárias.
No painel Assistente , siga as instruções de configuração restantes para o produto Firebase selecionado.
Adicione quantos outros produtos Firebase quiser por meio do Firebase Assistant!
É isso! Certifique-se de verificar as próximas etapas recomendadas.
No entanto, se estiver com problemas para configurar, visite a seção de solução de problemas e perguntas frequentes do Android .
Bibliotecas disponíveis
Esta seção lista os produtos Firebase com suporte para Android e suas dependências do Gradle. Saiba mais sobre essas bibliotecas Android do Firebase:
Documentação de referência ( Kotlin+KTX | Java )
Repositório GitHub do Firebase Android SDK
Observe que, ao usar o Firebase Android BoM , você não especifica as versões individuais da biblioteca ao declarar as dependências da biblioteca Firebase em build.gradle
.
Kotlin+KTX
Serviço ou Produto | Dependência Gradle | Mais recente versão | Adicionar análise? |
---|---|---|---|
Firebase Android BoM (lista de materiais) | com.google.firebase:firebase-bom A versão mais recente do Firebase BoM contém as versões mais recentes de cada biblioteca Firebase Android. Para saber quais versões de biblioteca são mapeadas para uma versão específica do BoM, revise as notas de versão dessa versão do BoM. | 31.2.0 | |
AdMob | com.google.android.gms:play-services-ads | 21.4.0 | |
Análise | com.google.firebase:firebase-analytics-ktx | 21.2.0 | |
Provedor personalizado do App Check | com.google.firebase:firebase-appcheck-ktx | 16.1.1 | |
Provedor de depuração do App Check | com.google.firebase:firebase-appcheck-debug | 16.1.1 | |
Provedor de Integridade do App Check Play | com.google.firebase:firebase-appcheck-playintegrity | 16.1.1 | |
Distribuição de aplicativos | com.google.firebase:firebase-appdistribution | 16.0.0-beta05 | |
API de distribuição de aplicativos | com.google.firebase:firebase-appdistribution-api-ktx | 16.0.0-beta05 | |
Plug-in de distribuição de aplicativos | com.google.firebase:firebase-appdistribution-gradle | 3.2.0 | |
Autenticação | com.google.firebase:firebase-auth-ktx | 21.1.0 | |
Cloud Firestore | com.google.firebase:firebase-firestore-ktx | 24.4.2 | |
Cloud Functions para Firebase Client SDK | com.google.firebase:firebase-functions-ktx | 20.2.2 | |
Mensagens na nuvem | com.google.firebase:firebase-messaging-ktx | 23.1.1 | |
Armazenamento na núvem | com.google.firebase:firebase-storage-ktx | 20.1.0 | |
Crashlytics | com.google.firebase:firebase-crashlytics-ktx | 18.3.3 | |
Crashlytics NDK | com.google.firebase:firebase-crashlytics-ndk | 18.3.3 | |
Plug-in do Crashlytics | com.google.firebase:firebase-crashlytics-gradle | 2.9.2 | |
Suporte ao módulo de recurso dinâmico | com.google.firebase:firebase-dynamic-module-support | 16.0.0-beta03 | |
Links dinâmicos | com.google.firebase:firebase-dynamic-links-ktx | 21.1.0 | |
Mensagens no aplicativo | com.google.firebase:firebase-inappmessaging-ktx | 20.3.0 | (requeridos) |
Exibição de mensagens no aplicativo | com.google.firebase:firebase-inappmessaging-display-ktx | 20.3.0 | (requeridos) |
Instalações do Firebase | com.google.firebase:firebase-installations-ktx | 17.1.0 | |
API do Firebase ML Model Downloader | com.google.firebase:firebase-ml-modeldownloader-ktx | 24.1.2 | |
Monitoramento de desempenho | com.google.firebase:firebase-perf-ktx | 20.3.1 | |
Plug-in de monitoramento de desempenho | com.google.firebase:perf-plugin | 1.4.2 | |
banco de dados em tempo real | com.google.firebase:firebase-database-ktx | 20.1.0 | |
Configuração Remota | com.google.firebase:firebase-config-ktx | 21.2.1 | |
Plug-in de serviços do Google Play | com.google.gms:google-services | 4.3.15 | |
Bibliotecas obsoletas | |||
App Check SafetyNet provedor | com.google.firebase:firebase-appcheck-safetynet | 16.1.1 | |
Indexação de aplicativos | com.google.firebase:firebase-appindexing | 20.0.0 | |
APIs de modelo personalizado do Firebase ML | com.google.firebase:firebase-ml-model-interpreter | 22.0.4 | |
APIs Firebase ML Vision | com.google.firebase:firebase-ml-vision | 24.1.0 | |
Firebase ML: modelo de rotulagem de imagens | com.google.firebase:firebase-ml-vision-image-label-model | 20.0.2 | |
Firebase ML: modelo de detecção e rastreamento de objetos | com.google.firebase:firebase-ml-vision-object-detection-model | 19.0.6 | |
Firebase ML: modelo de detecção facial | com.google.firebase:firebase-ml-vision-face-model | 20.0.2 | |
Firebase ML: modelo de leitura de código de barras | com.google.firebase:firebase-ml-vision-barcode-model | 16.1.2 | |
Firebase ML: API AutoML Vision Edge | com.google.firebase:firebase-ml-vision-automl | 18.0.6 | |
Firebase ML: APIs de linguagem natural | com.google.firebase:firebase-ml-natural-language | 22.0.1 | |
Firebase ML: modelo de identificação de linguagem | com.google.firebase:firebase-ml-natural-language-idioma-id-model | 20.0.8 | |
Firebase ML: modelo de tradução | com.google.firebase:firebase-ml-natural-language-translate-model | 20.0.9 | |
Firebase ML: modelo de resposta inteligente | com.google.firebase:firebase-ml-natural-language-smart-reply-model | 20.0.8 |
Java
Serviço ou Produto | Dependência Gradle | Mais recente versão | Adicionar análise? |
---|---|---|---|
Firebase Android BoM (lista de materiais) | com.google.firebase:firebase-bom A versão mais recente do Firebase BoM contém as versões mais recentes de cada biblioteca Firebase Android. Para saber quais versões de biblioteca são mapeadas para uma versão específica do BoM, revise as notas de versão dessa versão do BoM. | 31.2.0 | |
AdMob | com.google.android.gms:play-services-ads | 21.4.0 | |
Análise | com.google.firebase:firebase-analytics | 21.2.0 | |
Provedor personalizado do App Check | com.google.firebase:firebase-appcheck | 16.1.1 | |
Provedor de depuração do App Check | com.google.firebase:firebase-appcheck-debug | 16.1.1 | |
Provedor de Integridade do App Check Play | com.google.firebase:firebase-appcheck-playintegrity | 16.1.1 | |
Distribuição de aplicativos | com.google.firebase:firebase-appdistribution | 16.0.0-beta05 | |
API de distribuição de aplicativos | com.google.firebase:firebase-appdistribution-api | 16.0.0-beta05 | |
Plug-in de distribuição de aplicativos | com.google.firebase:firebase-appdistribution-gradle | 3.2.0 | |
Autenticação | com.google.firebase:firebase-auth | 21.1.0 | |
Cloud Firestore | com.google.firebase:firebase-firestore | 24.4.2 | |
Cloud Functions para Firebase Client SDK | com.google.firebase:firebase-functions | 20.2.2 | |
Mensagens na nuvem | com.google.firebase:firebase-messaging | 23.1.1 | |
Armazenamento na núvem | com.google.firebase:firebase-storage | 20.1.0 | |
Crashlytics | com.google.firebase:firebase-crashlytics | 18.3.3 | |
Crashlytics NDK | com.google.firebase:firebase-crashlytics-ndk | 18.3.3 | |
Plug-in do Crashlytics | com.google.firebase:firebase-crashlytics-gradle | 2.9.2 | |
Suporte ao módulo de recurso dinâmico | com.google.firebase:firebase-dynamic-module-support | 16.0.0-beta03 | |
Links dinâmicos | com.google.firebase:firebase-dynamic-links | 21.1.0 | |
Mensagens no aplicativo | com.google.firebase:firebase-inappmessaging | 20.3.0 | (requeridos) |
Exibição de mensagens no aplicativo | com.google.firebase:firebase-inappmessaging-display | 20.3.0 | (requeridos) |
Instalações do Firebase | com.google.firebase:firebase-installations | 17.1.0 | |
API do Firebase ML Model Downloader | com.google.firebase:firebase-ml-modeldownloader | 24.1.2 | |
Monitoramento de desempenho | com.google.firebase:firebase-perf | 20.3.1 | |
Plug-in de monitoramento de desempenho | com.google.firebase:perf-plugin | 1.4.2 | |
banco de dados em tempo real | com.google.firebase:firebase-database | 20.1.0 | |
Configuração Remota | com.google.firebase:firebase-config | 21.2.1 | |
Plug-in de serviços do Google Play | com.google.gms:google-services | 4.3.15 | |
Bibliotecas obsoletas | |||
App Check SafetyNet provedor | com.google.firebase:firebase-appcheck-safetynet | 16.1.1 | |
Indexação de aplicativos | com.google.firebase:firebase-appindexing | 20.0.0 | |
APIs de modelo personalizado do Firebase ML | com.google.firebase:firebase-ml-model-interpreter | 22.0.4 | |
APIs Firebase ML Vision | com.google.firebase:firebase-ml-vision | 24.1.0 | |
Firebase ML: modelo de rotulagem de imagens | com.google.firebase:firebase-ml-vision-image-label-model | 20.0.2 | |
Firebase ML: modelo de detecção e rastreamento de objetos | com.google.firebase:firebase-ml-vision-object-detection-model | 19.0.6 | |
Firebase ML: modelo de detecção facial | com.google.firebase:firebase-ml-vision-face-model | 20.0.2 | |
Firebase ML: modelo de leitura de código de barras | com.google.firebase:firebase-ml-vision-barcode-model | 16.1.2 | |
Firebase ML: API AutoML Vision Edge | com.google.firebase:firebase-ml-vision-automl | 18.0.6 | |
Firebase ML: APIs de linguagem natural | com.google.firebase:firebase-ml-natural-language | 22.0.1 | |
Firebase ML: modelo de identificação de linguagem | com.google.firebase:firebase-ml-natural-language-idioma-id-model | 20.0.8 | |
Firebase ML: modelo de tradução | com.google.firebase:firebase-ml-natural-language-translate-model | 20.0.9 | |
Firebase ML: modelo de resposta inteligente | com.google.firebase:firebase-ml-natural-language-smart-reply-model | 20.0.8 |
Próximos passos
Adicione serviços do Firebase ao seu aplicativo:
Obtenha informações sobre o comportamento do usuário com o Analytics .
Configure um fluxo de autenticação do usuário com Authentication .
Armazene dados, como informações do usuário, com Cloud Firestore ou Realtime Database .
Armazene arquivos, como fotos e vídeos, com Cloud Storage .
Acione o código de back-end executado em um ambiente seguro com o Cloud Functions .
Envie notificações com Cloud Messaging .
Descubra quando e por que seu aplicativo está travando com o Crashlytics .
Conheça o Firebase:
Acesse Entenda os projetos do Firebase para saber mais sobre os projetos do Firebase e as práticas recomendadas para projetos.
Acesse Saiba mais sobre o Android e o Firebase se tiver dúvidas sobre conceitos desconhecidos ou específicos do desenvolvimento do Firebase e do Android.
Explore exemplos de aplicativos do Firebase .
Obtenha experiência prática com o Firebase Android Codelab .
Aprenda mais com o Firebase em um curso de fim de semana.
Prepare-se para lançar seu aplicativo:
- Configure alertas de orçamento para seu projeto no Console do Google Cloud.
- Monitore o painel de uso e faturamento no console do Firebase para obter uma visão geral do uso do seu projeto em vários serviços do Firebase.
- Revise a lista de verificação de lançamento do Firebase .
Está tendo problemas com o Firebase e seu projeto Android? Visite a solução de problemas e perguntas frequentes do Android .