Risoluzione dei problemi e domande frequenti per Android e Firebase

Ricevo un messaggio di errore che indica che la libreria ktx non è stata risolta o non è stato possibile trovarla.

Questo errore è probabilmente dovuto al fatto che utilizzi Firebase BoM e specifica un modulo KTX come dipendenza della libreria del prodotto.

A luglio 2025 abbiamo interrotto il rilascio di nuove versioni dei moduli KTX e abbiamo rimosso le librerie KTX da Firebase Android BoM (v34.0.0).

Se utilizzi le API KTX dei moduli KTX rilasciati in precedenza, ti consigliamo di eseguire la migrazione della tua app per utilizzare le API KTX dei moduli principali. Per maggiori dettagli, consulta le domande frequenti su questa iniziativa.

Devo fornire un SHA-1 quando aggiungo un'app per Android a un progetto Firebase?

Le informazioni SHA-1 sono richieste da Firebase Authentication (quando utilizzi Accedi con Google o Accedi con il numero di telefono) e Firebase Dynamic Links. Se non utilizzi queste funzionalità, non devi fornire un SHA-1.

Come faccio a risolvere l'errore "Un client OAuth2 esiste già in un altro progetto per questa combinazione di nome e chiave SHA-1 del pacchetto"?

Questo errore si verifica se rileviamo che un altro progetto Firebase o Google Cloud contiene un ID client OAuth 2.0 con il nome del pacchetto e la chiave SHA-1 che hai specificato. Scopri come risolvere questo errore.

Quando aggiungo Firebase al mio progetto Android, viene visualizzato l'errore "Impossibile trovare".

Questo errore in genere significa che nella tua app mancano uno o più riferimenti al repository Maven di Google. Assicurati di includere il repository Maven di Google (google()) nel file di configurazione Gradle.

• Se il tuo progetto utilizza la sintassi plugins, includila nella sezione plugins del file settings.gradle.kts o settings.gradle.
• Se il tuo progetto utilizza la sintassi buildscript, includila sia nelle sezioni buildscript che allprojects nel file build.gradle.kts o build.gradle a livello di progetto.

Dopo aver rilasciato la mia app, l'accesso con Google mostra l'errore "12500:". Come posso risolverlo?

Questo problema potrebbe verificarsi per due motivi: non hai fornito un'email di assistenza o ti manca una chiave SHA. Per correggere questo errore, assicurati che tutte le seguenti condizioni siano soddisfatte:

• Hai aggiunto un'email di assistenza alle Impostazioni generali del tuo progetto nella console Firebase.
• Hai aggiunto l'impronta digitale del certificato SHA-1 dal keystore di rilascio/produzione alla tua app Firebase per Android nella console Firebase (vai a settings Impostazioni progetto, scorri verso il basso fino a Le tue app e seleziona la tua app per Android).
• Hai aggiunto l'impronta digitale del certificato SHA-1 dalla Google Play Console alla tua app Firebase per Android nella console Firebase (vai a settings Impostazioni progetto, scorri verso il basso fino a Le tue app e seleziona la tua app per Android).

Come aggiungere plug-in Firebase a un progetto Android utilizzando la sintassi buildscript?

Firebase ha i seguenti plug-in Gradle:

Ecco come aggiungere un plug-in Firebase a un progetto Android che utilizza ancora la sintassi buildscript:

1. Nel file Gradle a livello di directory principale (a livello di progetto) (<project>/build.gradle.kts o <project>/build.gradle), aggiungi il plug-in come dipendenza utilizzando le coordinate 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. Nel file Gradle del modulo (a livello di app) (di solito <project>/<app-module>/build.gradle.kts o <project>/<app-module>/build.gradle), aggiungi il plug-in utilizzando il relativo ID plug-in:

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