Fehlerbehebung und FAQs für Android und Firebase

Ich erhalte eine Fehlermeldung, dass die ktx-Bibliothek nicht aufgelöst oder nicht gefunden wurde.

Dieser Fehler tritt wahrscheinlich auf, weil Sie die Firebase BoM und ein KTX-Modul als Abhängigkeit für die 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 (Version 34.0.0) entfernt.

Wenn Sie KTX-APIs aus zuvor veröffentlichten KTX-Modulen verwenden, empfehlen wir Ihnen, Ihre App so zu migrieren, dass stattdessen KTX-APIs aus den Hauptmodulen verwendet werden. Weitere Informationen finden Sie in den FAQs zu dieser Initiative.

Muss ich beim Hinzufügen einer Android-App zu einem Firebase Projekt einen SHA-1-Schlüssel angeben?

SHA-1-Informationen sind für Firebase Authentication erforderlich (bei der Verwendung der Google-Anmeldung oder der Anmeldung mit Telefonnummer) und für Firebase Dynamic Links. Wenn Sie diese Funktionen nicht verwenden, müssen Sie keinen SHA-1-Schlüssel 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-Schlüssel enthält. Informationen zum Beheben dieses Fehlers .

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 eine oder mehrere Verweise auf das Maven-Repository von Google fehlen. Fügen Sie das Maven-Repository von Google (google()) in Ihre Gradle-Konfigurationsdatei ein.

• Wenn Ihr Projekt die plugins-Syntax verwendet, fügen Sie sie im Abschnitt plugins in der Datei settings.gradle.kts oder settings.gradle ein.
• Wenn Ihr Projekt die buildscript-Syntax verwendet, fügen Sie sie in der Datei build.gradle.kts oder build.gradle auf Projektebene in den Abschnitten buildscript und allprojects ein.

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

Dafür gibt es zwei mögliche Gründe: Sie haben keine E-Mail-Adresse für den Support angegeben oder es fehlt ein SHA-Schlüssel. Damit dieser Fehler nicht auftritt, müssen alle folgenden Bedingungen erfüllt sein:

• Sie haben in der Firebase Console in den allgemeinen Einstellungen Ihres Projekts eine E-Mail-Adresse für den Support hinzugefügt.
• Sie haben in der Firebase Console den SHA-1-Zertifikatfingerabdruck aus Ihrem Release-/Produktions-Keystore Ihrer Firebase Android-App hinzugefügt. Rufen Sie dazu die settings Projekteinstellungen auf, scrollen Sie zu Ihre Apps und wählen Sie Ihre Android-App aus.
• Sie haben in derFirebase Console denSHA-1-Zertifikat-Fingerabdruck aus der Google Play Console Ihrer Firebase Android-App hinzugefügt. Rufen Sie dazu diesettings Projekteinstellungen auf, scrollen Sie zuIhre Apps und wählen Sie Ihre Android-App aus.

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

Firebase hat die folgenden Gradle-Plug-ins:

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

1. Fügen Sie in der Gradle-Datei auf Stammebene (Projektebene) (<project>/build.gradle.kts oder <project>/build.gradle) das Plug‑in mit seinen Maven-Koordinaten als Abhängigkeit 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 auf Modulebene (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'
       ...
   }
   

Welche Open-Source-Hinweise muss ich in meine App aufnehmen?

Das Firebase Android SDK enthält eine Hilfs-Activity zum Anzeigen von Lizenzinformationen.