Solução de problemas e perguntas frequentes sobre o Android e o Firebase

Estou recebendo um erro informando que a biblioteca ktx não pôde ser resolvida ou não foi encontrada.

Esse erro provavelmente ocorre porque você está usando o Firebase BoM e especificando um módulo KTX como dependência da biblioteca de produtos.

Em julho de 2025, paramos de lançar novas versões dos módulos KTX e removemos as bibliotecas KTX do Firebase Android BoM (v34.0.0).

Se você usa APIs KTX dos módulos KTX lançados, recomendamos migrar seu app para usar as APIs KTX dos módulos principais em seu lugar. Para mais detalhes, consulte as Perguntas frequentes sobre esta iniciativa.

Preciso fornecer um SHA-1 ao adicionar um app Android a um projeto do Firebase?

As informações de SHA-1 são exigidas pelo Firebase Authentication (ao usar o Login do Google ou o login com número de telefone) e pelo Firebase Dynamic Links. Se você não usa esses recursos, não precisa fornecer um SHA-1.

Como resolver este erro: "Já existe um cliente OAuth2 com esse nome de pacote e SHA-1 em outro projeto"?

Isso ocorre quando detectamos outro projeto do Firebase ou do Google Cloud que contém um ID do cliente OAuth 2.0 com o nome de pacote e SHA-1 especificados. Saiba como resolver esse erro.

Quando adiciono o Firebase ao meu Projeto do Android, recebo a mensagem de erro "Não foi possível encontrar".

Esse erro geralmente significa que o app não tem uma ou mais referências ao repositório Maven do Google. Inclua o repositório Maven do Google (google()) no arquivo de configuração do Gradle.

• Se o projeto estiver usando a sintaxe plugins, inclua-a na seção plugins do arquivo settings.gradle.kts ou settings.gradle.
• Se o projeto estiver usando a sintaxe buildscript, inclua-a nas seções buildscript e allprojects no build.gradle.kts ou build.gradle para envolvidos no projeto.

O Login do Google mostra o erro "12500:" depois de lançar meu app. Como faço para corrigir isso?

Há dois possíveis motivos para isso acontecer: você não forneceu um e-mail de suporte ou está faltando uma chave SHA. Para corrigir esse erro, verfique se todas estas condições foram atendidas.

• Você adicionou um e-mail de suporte às Configurações gerais do projeto no console do Firebase.
• Você adicionou a impressão digital do certificado SHA-1 do seu keystore de produção/versão ao seu app Android do Firebase no Console do Firebase (acesse settings Configurações do projeto, role para baixo até Seus apps e selecione seu app Android).
• Você adicionou a impressão digital do certificado SHA-1 do console doGoogle Play ao seu app Android do Firebase no console do Firebase (acesse settings Configurações do projeto, role a tela para baixo até Seus apps e selecione seu app Android).

Como adicionar plug-ins do Firebase a um projeto Android usando a sintaxe buildscript?

O Firebase tem os seguintes plug-ins do Gradle:

Confira como adicionar um plug-in do Firebase a um projeto do Android que ainda usa a sintaxe buildscript:

1. No arquivo Gradle no nível raiz (para envolvidos no projeto) (<project>/build.gradle.kts ou <project>/build.gradle), adicione o plug-in como uma dependência usando as coordenadas do Maven:

   Kotlin

   buildscript {
   
       repositories {
         // Make sure that you have the following two repositories
         google()  // Google's Maven repository
         mavenCentral()  // Maven Central repository
       }
   
       dependencies {
         ...
   
         // Add the Maven coordinates and latest version of the plugin
         classpath ("PLUGIN_MAVEN_COORDINATES:PLUGIN_VERSION")
       }
   }
   
   allprojects {
     ...
   
     repositories {
       // Make sure that you have the following two repositories
       google()  // Google's Maven repository
       mavenCentral()  // Maven Central repository
     }
   }
   

   Groovy

   buildscript {
   
       repositories {
         // Make sure that you have the following two repositories
         google()  // Google's Maven repository
         mavenCentral()  // Maven Central repository
       }
   
       dependencies {
         ...
   
         // Add the Maven coordinates and latest version of the plugin
         classpath 'PLUGIN_MAVEN_COORDINATES:PLUGIN_VERSION'
       }
   }
   
   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 app) (geralmente <project>/<app-module>/build.gradle.kts ou <project>/<app-module>/build.gradle), adicione o plug-in usando o ID dele:

   Kotlin

   plugins {
       id("com.android.application")
   
       // Add the ID of the plugin
       id("FIREBASE_PLUGIN_ID")
       ...
   }
   

   Groovy

   plugins {
       id 'com.android.application'
   
       // Add the ID of the plugin
       id 'FIREBASE_PLUGIN_ID'
       ...
   }