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.

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 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 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 auf das 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 zur Aktivierung 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) in Version 4.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.4	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.6	com.google.firebase.crashlytics
Performance Monitoring-Plug-in	com.google.firebase:perf-plugin	2.0.1	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'
       ...
   }