Risoluzione dei problemi e domande frequenti per Android e Firebase

Questa pagina offre suggerimenti e risoluzione dei problemi specifici per Android che potresti riscontrare durante l'utilizzo di Firebase.

Hai altre sfide o non vedi il tuo problema descritto di seguito? Assicurati di consultare le domande frequenti principali di Firebase per altre domande frequenti su Firebase o specifiche per prodotto.

Puoi anche consultare il repository GitHub dell'SDK Firebase per Android per un elenco aggiornato dei problemi segnalati e della risoluzione dei problemi. Ti invitiamo a segnalare anche lì i problemi relativi all'SDK Firebase per Android.

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 di prodotti.

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.

Quando aggiungo un SDK Firebase al mio progetto Android, ricevo un errore relativo al supporto di invoke-custom e all'attivazione della rimozione dello zucchero sintattico.

A maggio 2021 (Firebase BoM v28.0.0), Firebase ha disattivato il desugaring per tutte le sue librerie Android (vedi le note di rilascio).

Questa modifica comporta che le build Gradle che utilizzano il plug-in Android per Gradle (AGP) v4.2 o versioni precedenti devono abilitare il supporto di Java 8. In caso contrario, quando aggiungi un SDK Firebase, questi progetti Android generano il seguente errore di compilazione:

D8: Invoke-customs are only supported starting with Android O (--min-api 26)
Caused by: com.android.builder.dexing.DexArchiveBuilderException: Error while dexing.
The dependency contains Java 8 bytecode. Please enable desugaring by adding the following to build.gradle
android {
    compileOptions {
        sourceCompatibility 1.8
        targetCompatibility 1.8
    }
}
See https://developer.android.com/studio/write/java8-support.html for details.
Alternatively, increase the minSdkVersion to 26 or above.

Per risolvere questo errore di compilazione, puoi seguire una delle due opzioni seguenti:

• Aggiungi l'compileOptions elencato nel messaggio di errore al file a livello di app build.gradle.kts o build.gradle.
• Aumenta il minSdkVersion per il tuo progetto Android a 26 o un valore superiore.

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

Questo problema potrebbe verificarsi per due motivi: non hai fornito un'email di assistenza o 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 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 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?

Suggerimento :valuta la possibilità di eseguire la migrazione dalla sintassi buildscript a quella plugin, in quanto ciò consente ad Android Studio di completare il codice e fornire altri suggerimenti utili.

Firebase ha i seguenti plug-in Gradle:

Nome plug-in	Coordinate Maven	Versione più recente	ID plug-in
Plug-in Google Play Services	com.google.gms:google-services	4.4.3	com.google.gms.google-services
App Distribution plugin	com.google.firebase:firebase-appdistribution-gradle	5.1.1	com.google.firebase.appdistribution
Crashlytics plugin	com.google.firebase:firebase-crashlytics-gradle	3.0.6	com.google.firebase.crashlytics
Performance Monitoring plugin	com.google.firebase:perf-plugin	2.0.1	com.google.firebase.firebase-perf

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