Dépannage et questions fréquentes pour Android et Firebase
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Cette page propose des conseils et des solutions de dépannage pour les problèmes spécifiques à Android que vous pouvez rencontrer lorsque vous utilisez Firebase.
Vous rencontrez d'autres difficultés ou vous ne trouvez pas votre problème ci-dessous ? N'oubliez pas de consulter les questions fréquentes principales sur Firebase pour en savoir plus sur Firebase en général ou sur des produits spécifiques.
Vous pouvez également consulter le dépôt GitHub du SDK Firebase pour Android pour obtenir une liste à jour des problèmes signalés et des conseils de dépannage. Nous vous encourageons également à y signaler vos propres problèmes liés au SDK Firebase Android.
Je reçois un message d'erreur indiquant que la bibliothèque ktx
n'a pas pu être résolue ou est introuvable.
Cette erreur est probablement due au fait que vous utilisez Firebase BoM et que vous spécifiez un module KTX comme dépendance de votre bibliothèque de produits.
En juillet 2025, nous avons cessé de publier de nouvelles versions des modules KTX et nous avons supprimé les bibliothèques KTX de Firebase Android BoM (v34.0.0).
Si vous utilisez des API KTX provenant de modules KTX publiés précédemment, nous vous recommandons de migrer votre application pour qu'elle utilise les API KTX des modules principaux à la place. Pour en savoir plus, consultez les questions fréquentes sur cette initiative.
Comment résoudre l'erreur "Un client OAuth2 existe déjà pour ce nom de package et ce certificat SHA-1 dans un autre projet" ?
Cette erreur se produit si nous détectons qu'un autre projet Firebase ou Google Cloud contient un ID client OAuth 2.0 avec le nom de package et le SHA-1 que vous avez spécifiés. Découvrez comment résoudre cette erreur.
Lorsque j'ajoute Firebase à mon projet Android, le message d'erreur "Impossible de trouver" s'affiche.
Cette erreur signifie généralement que votre application ne contient pas une ou plusieurs références au dépôt Maven de Google. Veillez à inclure le dépôt Maven de Google (google()
) dans votre fichier de configuration Gradle.
- Si votre projet utilise la syntaxe
plugins
, incluez-la dans la section plugins
de votre fichier settings.gradle.kts
ou settings.gradle
.
- Si votre projet utilise la syntaxe
buildscript
, incluez-la dans les sections buildscript
et allprojects
de votre fichier build.gradle.kts
ou build.gradle
au niveau du projet.
Lorsque j'ajoute un SDK Firebase à mon projet Android, je reçois un message d'erreur concernant la prise en charge d'invoke-custom et l'activation de la désucrage.
En mai 2021 (Firebase BoM v28.0.0), Firebase a désactivé le desugaring pour toutes ses bibliothèques Android (voir les notes de version).
Cette modification signifie que les compilations Gradle qui utilisent le plug-in Android Gradle (AGP) version 4.2 ou antérieure doivent activer la compatibilité avec Java 8. Sinon, lorsque vous ajoutez un SDK Firebase, ces projets Android génèrent l'échec de compilation suivant :
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.
Pour corriger cet échec de compilation, vous avez deux options :
- Ajoutez le
compileOptions
listé dans le message d'erreur à votre fichier build.gradle.kts
ou build.gradle
au niveau de l'application.
- Augmentez le
minSdkVersion
de votre projet Android à 26 ou plus.
L'erreur "12500:" s'affiche dans Google Sign-in après la publication de mon application. Comment la corriger ?
Deux raisons peuvent expliquer ce problème : vous n'avez pas fourni d'adresse e-mail d'assistance ou il vous manque une clé SHA. Pour corriger cette erreur, assurez-vous que toutes les conditions suivantes sont remplies :
Comment ajouter des plug-ins Firebase à un projet Android à l'aide de la syntaxe buildscript
?
Firebase propose les plug-ins Gradle suivants :
Nom du plug-in |
Coordonnées Maven |
Dernière version |
ID du plug-in |
Plug-in des services Google Play |
com.google.gms:google-services |
4.4.3 |
com.google.gms.google-services |
Plug-in App Distribution |
com.google.firebase:firebase-appdistribution-gradle |
5.1.1 |
com.google.firebase.appdistribution |
Plug-in Crashlytics |
com.google.firebase:firebase-crashlytics-gradle |
3.0.5 |
com.google.firebase.crashlytics |
Plug-in Performance Monitoring |
com.google.firebase:perf-plugin |
2.0.0 |
com.google.firebase.firebase-perf |
Voici comment ajouter un plug-in Firebase à un projet Android qui utilise encore la syntaxe buildscript
:
Dans votre fichier Gradle au niveau racine (au niveau du projet) (<project>/build.gradle.kts
ou <project>/build.gradle
), ajoutez le plug-in en tant que dépendance à l'aide de ses coordonnées 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
}
}
Dans le fichier Gradle de votre module (au niveau de l'application) (généralement <project>/<app-module>/build.gradle.kts
ou <project>/<app-module>/build.gradle
), ajoutez le plug-in à l'aide de son ID de 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'
...
}