Auf dieser Seite finden Sie Tipps und Informationen zur Fehlerbehebung bei Android-spezifischen Problemen, die bei der Verwendung von Firebase auftreten können.
Sie haben andere Probleme oder können das unten beschriebene Problem nicht sehen? Weitere allgemeine oder produktspezifische FAQs finden Sie in den Firebase-FAQs.
Im GitHub-Repository für das Firebase Android SDK finden Sie eine aktuelle Liste der gemeldeten Probleme und Informationen zur Fehlerbehebung. Wir empfehlen Ihnen, dort auch Ihre eigenen Probleme im Zusammenhang mit dem Firebase Android SDK zu melden.
Ich erhalte die Fehlermeldung, dass die Bibliothek ktx nicht aufgelöst oder nicht gefunden werden konnte.
Dieser Fehler tritt wahrscheinlich auf, weil Sie Firebase BoM verwenden und ein KTX-Modul als Abhängigkeit der Produktbibliothek angeben.
Im Juli 2025 haben wir die Veröffentlichung neuer Versionen der KTX-Module eingestellt und die KTX-Bibliotheken aus der Firebase Android BoM (v34.0.0) entfernt.
Wenn Sie KTX APIs aus zuvor veröffentlichten KTX-Modulen verwenden, empfehlen wir, Ihre App so zu migrieren, dass stattdessen KTX APIs aus den Hauptmodulen verwendet werden. Weitere Informationen finden Sie in den FAQs zu dieser Initiative.
Wie behebe ich den Fehler „An OAuth2 client already exists for this package name and SHA-1 in another project“?
Dieser Fehler tritt auf, wenn wir feststellen, dass ein anderes Firebase- oder Google Cloud-Projekt eine OAuth 2.0-Client-ID mit dem von Ihnen angegebenen Paketnamen und SHA-1 enthält. Informationen zum Beheben dieses Fehlers
Wenn ich meinem Android-Projekt Firebase hinzufüge, erhalte ich die Fehlermeldung „Nicht gefunden“.
Dieser Fehler bedeutet in der Regel, dass in Ihrer App mindestens ein Verweis auf das Maven-Repository von Google fehlt. Achten Sie darauf, das Maven-Repository von Google (google()) in Ihre Gradle-Konfigurationsdatei aufzunehmen.
- Wenn Ihr Projekt die
plugins-Syntax verwendet, fügen Sie sie im Abschnitt plugins in Ihrer settings.gradle.kts- oder settings.gradle-Datei ein.
- Wenn Ihr Projekt die
buildscript-Syntax verwendet, fügen Sie sie sowohl in den Abschnitt buildscript als auch in den Abschnitt allprojects in der Datei build.gradle.kts oder build.gradle auf Projektebene ein.
Wenn ich meinem Android-Projekt ein Firebase SDK hinzufüge, erhalte ich eine Fehlermeldung zur Unterstützung von „invoke-custom“ und zur Aktivierung der Entzuckerung.
Im Mai 2021 (Firebase BoM v28.0.0) hat Firebase die Entzuckerung für alle Android-Bibliotheken deaktiviert (siehe Versionshinweise).
Diese Änderung bedeutet, dass für Gradle-Builds, die das Android Gradle-Plug-in (AGP) Version 4.2 oder früher verwenden, die Java 8-Unterstützung aktiviert werden muss. Andernfalls tritt beim Hinzufügen eines Firebase SDK der folgende Build-Fehler auf:
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.
Sie haben zwei Möglichkeiten, diesen Build-Fehler zu beheben:
- Fügen Sie die in der Fehlermeldung aufgeführten
compileOptions der build.gradle.kts- oder build.gradle-Datei auf Anwendungsebene hinzu.
- Erhöhen Sie die
minSdkVersion für Ihr Android-Projekt auf 26 oder höher.
Nach der Veröffentlichung meiner App wird bei der Google-Anmeldung der Fehler „12500:“ angezeigt. Wie kann ich das Problem beheben?
Dafür gibt es zwei mögliche Gründe: Sie haben keine Support-E-Mail-Adresse angegeben oder es fehlt ein SHA-Schlüssel. Damit dieser Fehler behoben werden kann, müssen alle der folgenden Bedingungen erfüllt sein:
Wie füge ich einem Android-Projekt Firebase-Plug-ins mit der buildscript-Syntax hinzu?
Firebase bietet die folgenden Gradle-Plug-ins:
| Plug‑in-Name |
Maven-Koordinaten |
Aktuelle Version |
Plug‑in-ID |
| Google Play-Dienste-Plug-in |
com.google.gms:google-services |
4.5.0 |
com.google.gms.google-services |
| App Distribution-Plug-in |
com.google.firebase:firebase-appdistribution-gradle |
5.3.1 |
com.google.firebase.appdistribution |
| Crashlytics-Plug-in |
com.google.firebase:firebase-crashlytics-gradle |
3.0.8 |
com.google.firebase.crashlytics |
| Performance Monitoring-Plug-in |
com.google.firebase:perf-plugin |
2.0.2 |
com.google.firebase.firebase-perf |
So fügen Sie einem Android-Projekt, das noch die buildscript-Syntax verwendet, ein Firebase-Plug-in hinzu:
Fügen Sie das Plug-in in der Gradle-Datei auf Stammebene (Projektebene) (<project>/build.gradle.kts oder <project>/build.gradle) als Abhängigkeit mit den Maven-Koordinaten hinzu:
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
}
}
Fügen Sie das Plug-in in der Gradle-Datei Ihres Moduls (auf App-Ebene) (normalerweise <project>/<app-module>/build.gradle.kts oder <project>/<app-module>/build.gradle) mit der Plug-in-ID hinzu:
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'
...
}
Welche Open-Source-Hinweise sollte ich in meine App aufnehmen?
Das Firebase Android SDK enthält ein Hilfsprogramm Activity zum Anzeigen von Lizenzinformationen.