Firebase zu meinem Android-Projekt hinzufügen

Vorbereitung

  • Installieren Sie Android Studio oder aktualisieren Sie es auf die neueste Version.

  • Ihr Projekt muss die folgenden Anforderungen erfüllen. Beachten Sie, dass für einige Produkte strengere Anforderungen gelten können:

    • Ausrichtung auf API-Level 21 (Lollipop) oder höher
    • Android 5.0 oder höher verwendet
    • Sie verwenden Jetpack (AndroidX) und erfüllen die folgenden Versionsanforderungen:
      • com.android.tools.build:gradle v7.3.0 oder höher
      • compileSdkVersion 28 oder höher
  • Richten Sie ein physisches Gerät ein oder verwenden Sie einen Emulator, um Ihre App auszuführen.
    Für Firebase SDKs mit Abhängigkeit von Google Play-Diensten müssen auf dem Gerät oder Emulator Google Play-Dienste installiert sein.

  • Melden Sie sich mit Ihrem Google-Konto in Firebase an.

Wenn Sie noch kein Android-Projekt haben und nur ein Firebase-Produkt ausprobieren möchten, können Sie eines unserer Beispiele für den Schnellstart herunterladen.


Sie können Ihre Android-App mit Firebase über eine der folgenden Optionen verknüpfen:

  • Option 1: (empfohlen) Mit dem Einrichtungsworkflow für die Firebase-Konsole
  • Option 2: Firebase Assistant in Android Studio verwenden (erfordert möglicherweise zusätzliche Konfiguration).



Option 1: Firebase über die Firebase-Konsole hinzufügen

Wenn Sie Firebase Ihrer App hinzufügen, müssen Sie sowohl in der Firebase Console als auch in Ihrem geöffneten Android-Projekt Aufgaben ausführen. Sie laden beispielsweise Firebase-Konfigurationsdateien aus der Console herunter und verschieben sie dann in Ihr Android-Projekt.

Schritt 1: Firebase-Projekt erstellen

Bevor Sie Firebase zu Ihrer Android-App hinzufügen können, müssen Sie ein Firebase-Projekt erstellen, um eine Verbindung zu Ihrer Android-App herzustellen. Weitere Informationen zu Firebase-Projekten finden Sie unter Firebase-Projekte.

  1. Klicken Sie in der Firebase Console auf Projekt hinzufügen.

    • Wenn Sie einem vorhandenen Google Cloud-Projekt Firebase-Ressourcen hinzufügen möchten, geben Sie den Projektnamen ein oder wählen Sie ihn aus dem Drop-down-Menü aus.

    • Geben Sie den gewünschten Projektnamen ein, um ein neues Projekt zu erstellen. Optional können Sie auch die Projekt-ID bearbeiten, die unter dem Projektnamen angezeigt wird.

  2. Lesen Sie sich die Firebase-Nutzungsbedingungen durch und akzeptieren Sie sie.

  3. Klicken Sie auf Weiter.

  4. Optional: Richten Sie Google Analytics für Ihr Projekt ein, um die folgenden Firebase-Produkte optimal nutzen zu können:

    Wählen Sie entweder ein vorhandenes Google Analytics-Konto aus oder erstellen Sie ein neues Konto.

    Wenn Sie ein neues Konto erstellen, wählen Sie Ihren AnalyticsSpeicherort für Berichte aus und akzeptieren Sie dann die Datenfreigabeeinstellungen und Google Analytics-Nutzungsbedingungen für Ihr Projekt.

  5. Klicken Sie auf Projekt erstellen (oder auf Firebase hinzufügen, wenn Sie ein vorhandenes Google Cloud-Projekt verwenden).

Firebase stellt automatisch Ressourcen für Ihr Firebase-Projekt bereit. Nach Abschluss des Vorgangs werden Sie zur Übersichtsseite für Ihr Firebase-Projekt in der Firebase Console weitergeleitet.

Schritt 2: App bei Firebase registrieren

Wenn Sie Firebase in Ihrer Android-App verwenden möchten, müssen Sie Ihre App in Ihrem Firebase-Projekt registrieren. Die Registrierung Ihrer App wird oft als „Hinzufügen“ der App zu Ihrem Projekt bezeichnet.

  1. Rufen Sie die Firebase Console auf.

  2. Klicken Sie in der Mitte der Projektübersicht auf das Symbol Android () oder App hinzufügen, um den Einrichtungsworkflow zu starten.

  3. Geben Sie den Paketnamen Ihrer App in das Feld Android-Paketname ein.

    • Anhand des Paketnamens wird Ihre App auf dem Gerät und im Google Play Store eindeutig identifiziert.

    • Ein Paketname wird oft als Anwendungs-ID bezeichnet.

    • Suchen Sie in der Gradle-Datei Ihres Moduls (auf App-Ebene, in der Regel app/build.gradle) nach dem Paketnamen Ihrer App. Beispiel für einen Paketnamen: com.yourcompany.yourproject.

    • Beachten Sie, dass der Paketname bei Groß- und Kleinschreibung unterscheidet und für diese Firebase-Android-App nicht mehr geändert werden kann, nachdem sie in Ihrem Firebase-Projekt registriert wurde.

  4. Optional: Geben Sie weitere App-Informationen ein: App-Alias und SHA-1-Wert des Signaturzertifikats für die Fehlerbehebung.

  5. Klicken Sie auf App registrieren.

Schritt 3: Firebase-Konfigurationsdatei hinzufügen

  1. Laden Sie die Firebase-Android-Konfigurationsdatei (google-services.json) herunter und fügen Sie sie Ihrer App hinzu:

    1. Klicken Sie auf google-services.json herunterladen, um die Firebase-Android-Konfigurationsdatei abzurufen.

    2. Verschieben Sie die Konfigurationsdatei in das Stammverzeichnis des Moduls (auf App-Ebene) Ihrer App.

    • Die Firebase-Konfigurationsdatei enthält eindeutige, aber nicht verborgene Kennungen für Ihr Projekt. Weitere Informationen zu dieser Konfigurationsdatei finden Sie unter Firebase-Projekte.

    • Sie können Ihre Firebase-Konfigurationsdatei jederzeit wieder herunterladen.

    • Achten Sie darauf, dass der Name der Konfigurationsdatei keine zusätzlichen Zeichen wie z. B. (2) enthält.

  2. Wenn Sie die Werte in Ihrer google-services.json-Konfigurationsdatei für Firebase SDKs verfügbar machen möchten, benötigen Sie das Gradle-Plug-in für Google-Dienste (google-services).

    1. Fügen Sie das Google-Dienste-Plug-in als Abhängigkeit in die Gradle-Datei auf Stammebene (Projektebene) (<project>/build.gradle.kts oder <project>/build.gradle) ein:

      plugins {
        id("com.android.application") version "7.3.0" apply false
        // ...
      
        // Add the dependency for the Google services Gradle plugin
        id("com.google.gms.google-services") version "4.4.2" apply false
      }
      plugins {
        id 'com.android.application' version '7.3.0' apply false
        // ...
      
        // Add the dependency for the Google services Gradle plugin
        id 'com.google.gms.google-services' version '4.4.2' apply false
      }
    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 Google-Dienste-Plug-in hinzu:

      plugins {
        id("com.android.application")
      
        // Add the Google services Gradle plugin
        id("com.google.gms.google-services")
        // ...
      }
      plugins {
        id 'com.android.application'
      
        // Add the Google services Gradle plugin
        id 'com.google.gms.google-services'
        // ...
      }

Schritt 4: Firebase SDKs zur App hinzufügen

  1. 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) die Abhängigkeiten für die Firebase-Produkte hinzu, die Sie in Ihrer App verwenden möchten. Wir empfehlen, die Bibliotheksversionierung mit Firebase Android BoM zu steuern.

    dependencies {
      // ...
    
      // Import the Firebase BoM
      implementation(platform("com.google.firebase:firebase-bom:33.7.0"))
    
      // When using the BoM, you don't specify versions in Firebase library dependencies
    
      // Add the dependency for the Firebase SDK for Google Analytics
      implementation("com.google.firebase:firebase-analytics")
    
      // TODO: Add the dependencies for any other Firebase products you want to use
      // See https://firebase.google.com/docs/android/setup#available-libraries
      // For example, add the dependencies for Firebase Authentication and Cloud Firestore
      implementation("com.google.firebase:firebase-auth")
      implementation("com.google.firebase:firebase-firestore")
    }

    Mit der Firebase Android BoM haben Sie immer eine kompatible Version der Firebase Android-Bibliotheken in Ihrer App.

    Sie suchen nach einem Kotlin-spezifischen Bibliotheksmodul? Ab Oktober 2023 (Firebase BoM 32.5.0) können sowohl Kotlin- als auch Java-Entwickler das Hauptbibliotheksmodul verwenden. Weitere Informationen finden Sie in den häufig gestellten Fragen zu dieser Initiative.

    dependencies {
      // ...
    
      // Import the Firebase BoM
      implementation(platform("com.google.firebase:firebase-bom:33.7.0"))
    
      // When using the BoM, you don't specify versions in Firebase library dependencies
    
      // TODO: Add the dependencies for Firebase products you want to use
      // See https://firebase.google.com/docs/android/setup#available-libraries
      // For example, add the dependencies for Firebase Authentication and Cloud Firestore
      implementation("com.google.firebase:firebase-auth")
      implementation("com.google.firebase:firebase-firestore")
    }

    Mit der Firebase Android BoM haben Sie immer eine kompatible Version der Firebase Android-Bibliotheken in Ihrer App.

    Sie suchen nach einem Kotlin-spezifischen Bibliotheksmodul? Ab Oktober 2023 (Firebase BoM 32.5.0) können sowohl Kotlin- als auch Java-Entwickler das Hauptbibliotheksmodul verwenden. Weitere Informationen finden Sie in den häufig gestellten Fragen zu dieser Initiative.

  2. Nachdem Sie die Abhängigkeiten für die Produkte hinzugefügt haben, die Sie verwenden möchten, synchronisieren Sie Ihr Android-Projekt mit den Gradle-Dateien.

    Für Gradle-Builds, bei denen das Android Gradle-Plug-in (AGP) 4.2 oder niedriger verwendet wird, muss die Java 8-Unterstützung aktiviert werden. Andernfalls kommt es bei diesen Android-Projekten beim Hinzufügen eines Firebase SDK zu einem Build-Fehler.

    Sie haben zwei Möglichkeiten, diesen Buildfehler zu beheben:

    • Fügen Sie die aufgeführte compileOptions aus der Fehlermeldung der build.gradle.kts- oder build.gradle-Datei auf App-Ebene hinzu.
    • Erhöhen Sie die minSdk für Ihr Android-Projekt auf mindestens 26.

    Weitere Informationen zu diesem Build-Fehler finden Sie in diesen FAQs.

Geschafft! Sie können auch direkt zu den empfohlenen nächsten Schritten springen.

Wenn bei der Einrichtung Probleme auftreten, findest du unter Fehlerbehebung und FAQs für Android weitere Informationen.



Option 2: Firebase über den Firebase Assistant hinzufügen

Der Firebase Assistant registriert Ihre App in einem Firebase-Projekt und fügt Ihrem Android-Projekt die erforderlichen Firebase-Dateien, ‑Plug-ins und ‑Abhängigkeiten hinzu – und das alles direkt in Android Studio.

  1. Öffnen Sie Ihr Android-Projekt in Android Studio und prüfen Sie, ob Sie die neuesten Versionen von Android Studio und des Firebase Assistant verwenden:

    • Windows / Linux: Hilfe > Nach Updates suchen
    • macOS: Android Studio > Nach Updates suchen
  2. Öffnen Sie den Firebase Assistant: Tools > Firebase.

  3. Wählen Sie im Bereich Assistant ein Firebase-Produkt aus, das Sie Ihrer App hinzufügen möchten. Maximieren Sie den Bereich und klicken Sie dann auf den Link zur Anleitung (z. B. Analytics > Analytics-Ereignis erfassen).

    1. Klicken Sie auf Connect to Firebase (Mit Firebase verbinden), um Ihr Android-Projekt mit Firebase zu verbinden.

      • Mit diesem Workflow wird automatisch eine neue Firebase-Android-App mit dem Paketnamen Ihrer App erstellt. Sie können diese neue Firebase-Android-App entweder in einem vorhandenen Firebase-Projekt oder in einem neuen Projekt erstellen.

        Hier einige Tipps zur Einrichtung Ihres Firebase-Projekts:

        • In unseren Best Practices erfahren Sie, wie Sie Apps einem Firebase-Projekt hinzufügen, einschließlich der Verarbeitung mehrerer Varianten.

        • Wenn Sie ein neues Projekt erstellen, empfehlen wir Ihnen dringend, Google Analytics für Ihr Projekt einzurichten. So können Sie viele Firebase-Produkte optimal nutzen.

      • Mit diesem Workflow wird auch die Android-Konfigurationsdatei (google-services.json) Ihres Firebase-Projekts dem Modulverzeichnis (App-Ebene) Ihrer App hinzugefügt.

    2. Klicken Sie auf die Schaltfläche, um ein gewünschtes Firebase-Produkt hinzuzufügen, z. B. Analytics zu Ihrer App hinzufügen.

  4. Synchronisieren Sie die App, damit für alle Abhängigkeiten die erforderlichen Versionen vorliegen.

  5. Folgen Sie im Bereich Assistent der restlichen Einrichtungsanleitung für das ausgewählte Firebase-Produkt.

  6. Über den Firebase Assistant können Sie beliebig viele weitere Firebase-Produkte hinzufügen.

Geschafft! Sehen Sie sich die empfohlenen nächsten Schritte an.

Wenn bei der Einrichtung Probleme auftreten, findest du unter Fehlerbehebung und FAQs für Android weitere Informationen.



Verfügbare Bibliotheken

In diesem Abschnitt sind die für Android unterstützten Firebase-Produkte und ihre Gradle-Abhängigkeiten aufgeführt. Weitere Informationen zu diesen Firebase-Android-Bibliotheken:

Wenn Sie Firebase Android BoM verwenden, geben Sie keine einzelnen Bibliotheksversionen an, wenn Sie Firebase-Bibliotheksabhängigkeiten in Ihrer Gradle-Build-Konfigurationsdatei deklarieren.

Dienstleistung oder Produkt Gradle-Abhängigkeit Aktuelle
-Version
Analytics hinzufügen?
Firebase Android BoM
(Bill of Materials)
com.google.firebase:firebase-bom

Die neueste Firebase BoM-Version enthält die neuesten Versionen aller Firebase-Android-Bibliotheken. Welche Bibliotheksversionen einer bestimmten BoM-Version zugeordnet sind, erfahren Sie in den Releasehinweisen für diese BoM-Version.

33.7.0
AdMob com.google.android.gms:play-services-ads 23.6.0
Analytics com.google.firebase:firebase-analytics 22.1.2
App Check benutzerdefinierter Anbieter com.google.firebase:firebase-appcheck 18.0.0
App Check-Debuganbieter com.google.firebase:firebase-appcheck-debug 18.0.0
App Check Play Integrity-Anbieter com.google.firebase:firebase-appcheck-playintegrity 18.0.0
App Distribution com.google.firebase:firebase-appdistribution 16.0.0-beta14
App Distribution API com.google.firebase:firebase-appdistribution-api 16.0.0-beta14
App Distribution-Plug-in com.google.firebase:firebase-appdistribution-gradle 5.0.0
Authentication com.google.firebase:firebase-auth 23.1.0
Cloud Firestore com.google.firebase:firebase-firestore 25.1.1
Cloud Functions for Firebase Client SDK com.google.firebase:firebase-functions 21.1.0
Cloud Messaging com.google.firebase:firebase-messaging 24.1.0
Cloud Storage com.google.firebase:firebase-storage 21.0.1
Crashlytics com.google.firebase:firebase-crashlytics 19.3.0
Crashlytics NDK com.google.firebase:firebase-crashlytics-ndk 19.3.0
Crashlytics-Plug-in com.google.firebase:firebase-crashlytics-gradle 3.0.2
Unterstützung für dynamische Funktionsmodule com.google.firebase:firebase-dynamic-module-support 16.0.0-beta03
Dynamic Links com.google.firebase:firebase-dynamic-links 22.1.0
In-App Messaging com.google.firebase:firebase-inappmessaging 21.0.1
(erforderlich)
In-App Messaging Display com.google.firebase:firebase-inappmessaging-display 21.0.1
(erforderlich)
Firebase Installationen com.google.firebase:firebase-installations 18.0.0
Firebase ML Model Downloader API com.google.firebase:firebase-ml-modeldownloader 25.0.1
Performance Monitoring com.google.firebase:firebase-perf 21.0.3
Performance Monitoring-Plug-in com.google.firebase:perf-plugin 1.4.2
Realtime Database com.google.firebase:firebase-database 21.0.0
Remote Config com.google.firebase:firebase-config 22.0.1
Vertex AI in Firebase com.google.firebase:firebase-vertexai 16.0.2
Google Play-Dienste-Plug-in com.google.gms:google-services 4.4.2
NICHT MEHR UNTERSTÜTZTE BIBLIOTHEKEN
App Check SafetyNet-Anbieter com.google.firebase:firebase-appcheck-safetynet 16.1.2
App Indexing com.google.firebase:firebase-appindexing 20.0.0
Analytics com.google.firebase:firebase-analytics-ktx 22.1.2
App Check benutzerdefinierter Anbieter com.google.firebase:firebase-appcheck-ktx 18.0.0
App Distribution API com.google.firebase:firebase-appdistribution-api-ktx 16.0.0-beta14
Authentication com.google.firebase:firebase-auth-ktx 23.1.0
Cloud Firestore com.google.firebase:firebase-firestore-ktx 25.1.1
Cloud Functions for Firebase Client SDK com.google.firebase:firebase-functions-ktx 21.1.0
Cloud Messaging com.google.firebase:firebase-messaging-ktx 24.1.0
Cloud Storage com.google.firebase:firebase-storage-ktx 21.0.1
Crashlytics com.google.firebase:firebase-crashlytics-ktx 19.3.0
Dynamic Links com.google.firebase:firebase-dynamic-links-ktx 22.1.0
In-App Messaging com.google.firebase:firebase-inappmessaging-ktx 21.0.1
(erforderlich)
In-App Messaging Display com.google.firebase:firebase-inappmessaging-display-ktx 21.0.1
(erforderlich)
Firebase Installationen com.google.firebase:firebase-installations-ktx 18.0.0
Firebase ML Model Downloader API com.google.firebase:firebase-ml-modeldownloader-ktx 25.0.1
Performance Monitoring com.google.firebase:firebase-perf-ktx 21.0.3
Realtime Database com.google.firebase:firebase-database-ktx 21.0.0
Remote Config com.google.firebase:firebase-config-ktx 22.0.1
Firebase ML APIs für benutzerdefinierte Modelle com.google.firebase:firebase-ml-model-interpreter 22.0.4
Firebase ML Vision APIs com.google.firebase:firebase-ml-vision 24.1.0
Firebase ML: Modell für das Bildlabeln com.google.firebase:firebase-ml-vision-image-label-model 20.0.2
Firebase ML: Modell für Objekterkennung und -tracking com.google.firebase:firebase-ml-vision-object-detection-model 19.0.6
Firebase ML: Modell für die Gesichtserkennung com.google.firebase:firebase-ml-vision-face-model 20.0.2
Firebase ML: Barcode-Scan-Modell com.google.firebase:firebase-ml-vision-barcode-model 16.1.2
Firebase ML: AutoML Vision Edge API com.google.firebase:firebase-ml-vision-automl 18.0.6
Firebase ML: Natural Language APIs com.google.firebase:firebase-ml-natural-language 22.0.1
Firebase ML: Modell zur Spracherkennung com.google.firebase:firebase-ml-natural-language-language-id-model 20.0.8
Firebase ML: Modell übersetzen com.google.firebase:firebase-ml-natural-language-translate-model 20.0.9
Firebase ML: Modell für intelligente Antworten com.google.firebase:firebase-ml-natural-language-smart-reply-model 20.0.8



Nächste Schritte

Fügen Sie Ihrer App Firebase-Dienste hinzu:

Weitere Informationen zu Firebase: