Fehlerbehebung und FAQs für Android und Firebase

Auf dieser Seite finden Sie Tipps und Informationen zur Fehlerbehebung für Android-spezifische Probleme, die bei der Verwendung von Firebase auftreten können.

Sie haben andere Probleme oder können das unten beschriebene Problem nicht sehen? Weitere Firebase- oder produktspezifische FAQs finden Sie in den allgemeinen Firebase-FAQs.

Eine aktuelle Liste der gemeldeten Probleme und Informationen zur Fehlerbehebung finden Sie auch im GitHub-Repository für das Firebase Android SDK. Wir empfehlen Ihnen, dort auch Ihre eigenen Probleme mit dem Firebase Android SDK zu melden.

Ich erhalte eine Fehlermeldung, dass die ktx-Bibliothek 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 Ihrer 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 KTX-APIs aus den Hauptmodulen verwendet werden. Weitere Informationen finden Sie in den FAQs zu dieser Initiative.

Muss ich einen SHA‑1-Fingerabdruck angeben, wenn ich einem Firebase-Projekt eine Android-App hinzufüge?

SHA-1-Informationen sind für Firebase Authentication (bei Verwendung von Google-Anmeldung oder Anmeldung mit Telefonnummer) und Firebase Dynamic Links erforderlich. Wenn Sie diese Funktionen nicht verwenden, müssen Sie keinen SHA‑1-Fingerabdruck angeben.

Wie behebe ich den Fehler „Für diesen Paketnamen und SHA-1 existiert bereits ein OAuth2-Client in einem anderen Projekt“?

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-Fingerabdruck enthält. Informationen zur Fehlerbehebung

Wenn ich meinem Android-Projekt Firebase hinzufüge, erhalte ich die Fehlermeldung „Could not find“.

Dieser Fehler bedeutet in der Regel, dass in Ihrer App mindestens eine Referenz zum Maven-Repository von Google fehlt. Fügen Sie das Maven-Repository von Google (google()) in Ihre Gradle-Konfigurationsdatei ein.

• Wenn in Ihrem Projekt die plugins-Syntax verwendet wird, fügen Sie sie im plugins-Abschnitt Ihrer settings.gradle.kts- oder settings.gradle-Datei ein.
• Wenn in Ihrem Projekt die buildscript-Syntax verwendet wird, fügen Sie sie in die Abschnitte buildscript und 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 zu „invoke-custom“-Unterstützung und zum Aktivieren von Desugaring.

Im Mai 2021 (Firebase BoM v28.0.0) hat Firebase das Desugaring für alle Android-Bibliotheken deaktiviert (siehe Versionshinweise).

Diese Änderung bedeutet, dass für Gradle-Builds, die das Android-Gradle-Plug-in (AGP) v4.2 oder früher verwenden, die Java 8-Unterstützung aktiviert werden muss. Andernfalls tritt beim Hinzufügen eines Firebase SDK in diesen Android-Projekten 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ührte compileOptions der Datei build.gradle.kts oder build.gradle auf App-Ebene hinzu.
• Erhöhen Sie minSdkVersion für Ihr Android-Projekt auf 26 oder höher.

Bei der Google-Anmeldung wird nach der Veröffentlichung meiner App der Fehler „12500:“ angezeigt. Wie kann ich das Problem beheben?

Dafür kann es zwei Gründe geben: Entweder haben Sie 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:

• Sie haben in der Firebase-Konsole eine Support-E‑Mail-Adresse zu den allgemeinen Einstellungen Ihres Projekts hinzugefügt.
• Sie haben den SHA-1-Zertifikatsfingerabdruck aus Ihrem Release-/Produktions-Keystore Ihrer Firebase-Android-App in der Firebase-Konsole hinzugefügt (rufen Sie Projekteinstellungen auf, scrollen Sie nach unten zu Ihre Apps und wählen Sie dann Ihre Android-App aus).
• Sie haben den SHA-1-Zertifikatsfingerabdruck aus der Google Play Console Ihrer Firebase-Android-App in der Firebase Console hinzugefügt (rufen Sie Projekteinstellungen auf, scrollen Sie nach unten zu Ihre Apps und wählen Sie dann Ihre Android-App aus).

Wie füge ich einem Android-Projekt Firebase-Plug-ins mit der buildscript-Syntax hinzu?

Tipp :Migrieren Sie von der buildscript- zur plugin-Syntax, damit Android Studio Code-Vervollständigungen und andere hilfreiche Vorschläge anbieten kann.

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.4.3	com.google.gms.google-services
App Distribution-Plug-in	com.google.firebase:firebase-appdistribution-gradle	5.1.1	com.google.firebase.appdistribution
Crashlytics-Plug-in	com.google.firebase:firebase-crashlytics-gradle	3.0.5	com.google.firebase.crashlytics
Performance Monitoring-Plug-in	com.google.firebase:perf-plugin	2.0.0	com.google.firebase.firebase-perf

So fügen Sie einem Android-Projekt, in dem noch die buildscript-Syntax verwendet wird, ein Firebase-Plug-in hinzu:

1. 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 zugehörigen 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
     }
   }
   

2. Fügen Sie in der Gradle-Datei des Moduls (auf App-Ebene) (in der Regel <project>/<app-module>/build.gradle.kts oder <project>/<app-module>/build.gradle) das Plug-in mit seiner 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'
       ...
   }