Adicione o Firebase ao seu projeto Android

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.

1. Acesse o console do Firebase .

2. No centro da página de visão geral do projeto, clique no ícone do Android ( plat_android ) ou Adicionar aplicativo para iniciar o fluxo de trabalho de configuração.

3. Digite o nome do pacote do seu aplicativo no campo de nome do pacote Android .

   O que é um nome de pacote e onde você o encontra?

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

4. (Opcional) Insira outras informações do aplicativo: Apelido do aplicativo e Certificado de assinatura de depuração SHA-1 .

   Como o apelido do aplicativo e o certificado de assinatura de depuração SHA-1 são usados ​​no Firebase?

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

5. Clique em Registrar aplicativo .

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

1. Baixe e adicione o arquivo de configuração Firebase Android ( google-services.json ) ao seu aplicativo:

   1. Clique em Baixar google-services.json para obter o arquivo de configuração do Firebase Android.

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

   O que você precisa saber sobre este arquivo de configuração?

   • 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) .

2. Para tornar os valores em seu arquivo de configuração google-services.json acessíveis aos SDKs do Firebase, você precisa do plug-in Gradle de serviços do Google ( google-services ).

   1. 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
        }
      }
      

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

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

2. Depois de adicionar as dependências dos produtos que deseja usar, sincronize seu projeto Android com os arquivos Gradle.

   Você está recebendo uma falha de compilação sobre o suporte personalizado de chamada e a ativação da simplificação? Veja como consertar isso.

   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 do build.gradle .
   • Aumente o minSdkVersion para seu projeto Android para 26 ou superior.

   Saiba mais sobre esta falha de compilação nesta FAQ .

É 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!

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

2. Abra o Assistente do Firebase: Ferramentas > Firebase .

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

   1. Clique em Conectar ao Firebase para conectar seu projeto Android ao Firebase.

      O que esse fluxo de trabalho faz?

      • 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 ( google-services.json ) ao diretório do módulo (nível do aplicativo) do seu aplicativo.

   2. Clique no botão para adicionar um produto Firebase desejado (por exemplo, Adicionar Analytics ao seu aplicativo ).

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

5. No painel Assistente , siga as instruções de configuração restantes para o produto Firebase selecionado.

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

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 cobrança 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 .