Firebase Ihrem 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. Bei einigen Produkten gelten möglicherweise strengere Anforderungen:

    • Die App ist auf API‑Level 21 (Lollipop) oder höher ausgerichtet.
    • Android 5.0 oder höher
    • Verwendet Jetpack (AndroidX), was die Einhaltung der folgenden Versionsanforderungen erfordert:
      • 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.
    Firebase-SDKs mit einer Abhängigkeit von Google Play-Diensten erfordern, dass auf dem Gerät oder Emulator Google Play-Dienste installiert sind.

  • 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 Schnellstartbeispiele herunterladen.


Sie haben folgende Möglichkeiten, Ihre Android-App mit Firebase zu verbinden:

  • Option 1: (empfohlen) Verwenden Sie den Workflow für die Einrichtung der Firebase-Konsole.
  • Option 2: Verwenden Sie den Firebase-Assistenten in Android Studio (möglicherweise ist eine zusätzliche Konfiguration erforderlich).


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

Wenn Sie Ihrer App Firebase hinzufügen, müssen Sie Aufgaben sowohl in der Firebase Console als auch in Ihrem geöffneten Android-Projekt 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.

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 auch als „Hinzufügen“ Ihrer App zu Ihrem Projekt bezeichnet.

  1. Rufen Sie die Firebase-Konsole auf.

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

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

  4. Optional: Geben Sie weitere App-Informationen ein: App-Nickname 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-Konfigurationsdatei (google-services.json) Ihrer App herunter und fügen Sie sie der Codebasis hinzu:

    1. Klicken Sie auf google-services.json herunterladen, um die Firebase-Konfigurationsdatei Ihrer App zu erhalten.

    2. Verschieben Sie die Konfigurationsdatei in das Modulstammverzeichnis (auf App-Ebene) Ihrer App.

  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 in der Gradle-Datei auf Stammebene (Projektebene) (<project>/build.gradle.kts oder <project>/build.gradle) das Google-Dienste-Plug-in als Abhängigkeit hinzu:

      Kotlin 

      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.3" apply false
}

      Groovy 

      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.3' 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:

      Kotlin 

      plugins {
  id("com.android.application")

  // Add the Google services Gradle plugin
  id("com.google.gms.google-services")
  // ...
}

      Groovy 

      plugins {
  id 'com.android.application'

  // Add the Google services Gradle plugin
  id 'com.google.gms.google-services'
  // ...
}

Schritt 4: Firebase SDKs in Ihre App einfü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 Firebase Android BoM zu verwenden, um die Versionierung der Bibliotheken zu steuern.

    Analytics aktiviert 

    dependencies {
  // ...

  // Import the Firebase BoM
  implementation(platform("com.google.firebase:firebase-bom:34.0.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.

    Analytics nicht aktiviert 

    dependencies {
  // ...

  // Import the Firebase BoM
  implementation(platform("com.google.firebase:firebase-bom:34.0.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.

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

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

Wenn Sie Probleme bei der Einrichtung haben, lesen Sie die Fehlerbehebung und FAQs für Android.


Option 2: Firebase mit dem Firebase Assistant hinzufügen

Mit dem Firebase Assistant können Sie Ihre App in einem Firebase-Projekt registrieren und die erforderlichen Firebase-Dateien, ‑Plug-ins und ‑Abhängigkeiten zu Ihrem Android-Projekt hinzufügen – 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 dem Firebase Assistant verwenden:

    • Windows / Linux: Hilfe > Nach Updates suchen
    • macOS: Android Studio > Check for Updates (Android Studio > Nach Updates suchen)

  2. Öffnen Sie den Firebase Assistant: Tools > Firebase.

  3. Wählen Sie im Bereich Assistant (Assistent) ein Firebase-Produkt aus, das Sie Ihrer App hinzufügen möchten. Maximieren Sie den entsprechenden Bereich und klicken Sie dann auf den Link zum Tutorial (z. B. Analytics > Log an Analytics event).

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

    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 Ihre App, damit für alle Abhängigkeiten die erforderlichen Versionen vorliegen.

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

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

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

Wenn Sie Probleme bei der Einrichtung haben, lesen Sie die Fehlerbehebung und FAQs für Android.


Verfügbare Bibliotheken

In diesem Abschnitt werden 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.

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

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

 34.0.0
AdMob com.google.android.gms:play-services-ads 24.4.0
Firebase AI Logic 1 com.google.firebase:firebase-ai 17.0.0
Analytics com.google.firebase:firebase-analytics 23.0.0
App Check Benutzerdefinierter Anbieter com.google.firebase:firebase-appcheck 19.0.0
App Check debug provider com.google.firebase:firebase-appcheck-debug 19.0.0
App Check Play Integrity-Anbieter com.google.firebase:firebase-appcheck-playintegrity 19.0.0
App Distribution com.google.firebase:firebase-appdistribution 16.0.0-beta16
App Distribution API com.google.firebase:firebase-appdistribution-api 16.0.0-beta16
App Distribution-Plug-in com.google.firebase:firebase-appdistribution-gradle 5.1.1
Authentication com.google.firebase:firebase-auth 24.0.0
Cloud Firestore com.google.firebase:firebase-firestore 26.0.0
Cloud Functions for Firebase Client SDK com.google.firebase:firebase-functions 22.0.0
Cloud Messaging com.google.firebase:firebase-messaging 25.0.0
Cloud Storage com.google.firebase:firebase-storage 22.0.0
Crashlytics com.google.firebase:firebase-crashlytics 20.0.0
Crashlytics NDK com.google.firebase:firebase-crashlytics-ndk 20.0.0
Crashlytics-Plug-in com.google.firebase:firebase-crashlytics-gradle 3.0.5
Data Connect com.google.firebase:firebase-dataconnect 17.0.0
Unterstützung von Modulen für dynamische Funktionen com.google.firebase:firebase-dynamic-module-support 16.0.0-beta04
Dynamic Links com.google.firebase:firebase-dynamic-links 22.1.0
In-App Messaging com.google.firebase:firebase-inappmessaging 22.0.0
(erforderlich)
In-App Messaging Display com.google.firebase:firebase-inappmessaging-display 22.0.0
(erforderlich)
Firebase-Installationen com.google.firebase:firebase-installations 19.0.0
Firebase ML Model Downloader API com.google.firebase:firebase-ml-modeldownloader 26.0.0
Performance Monitoring com.google.firebase:firebase-perf 22.0.0
Performance Monitoring-Plug-in com.google.firebase:perf-plugin 2.0.0
Realtime Database com.google.firebase:firebase-database 22.0.0
Remote Config com.google.firebase:firebase-config 23.0.0
Google Play-Dienste-Plug-in com.google.gms:google-services 4.4.3
EINGESTELLTE BIBLIOTHEKEN
App Check SafetyNet-Anbieter com.google.firebase:firebase-appcheck-safetynet 16.1.2
App Indexing com.google.firebase:firebase-appindexing 20.0.0

Firebase KTX-Module

Analytics com.google.firebase:firebase-analytics-ktx 22.5.0
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-beta15
Authentication com.google.firebase:firebase-auth-ktx 23.2.1
Cloud Firestore com.google.firebase:firebase-firestore-ktx 25.1.4
Cloud Functions for Firebase Client SDK com.google.firebase:firebase-functions-ktx 21.2.1
Cloud Messaging com.google.firebase:firebase-messaging-ktx 24.1.2
Cloud Storage com.google.firebase:firebase-storage-ktx 21.0.2
Crashlytics com.google.firebase:firebase-crashlytics-ktx 19.4.4
Dynamic Links com.google.firebase:firebase-dynamic-links-ktx 22.1.0
In-App Messaging com.google.firebase:firebase-inappmessaging-ktx 21.0.2
(erforderlich)
In-App Messaging Display com.google.firebase:firebase-inappmessaging-display-ktx 21.0.2
(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.5
Realtime Database com.google.firebase:firebase-database-ktx 21.0.0
Remote Config com.google.firebase:firebase-config-ktx 22.1.2

Firebase ML Kit-Bibliotheken

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: Image Labeling Model 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 zur Gesichtserkennung com.google.firebase:firebase-ml-vision-face-model 20.0.2
Firebase ML: Barcode Scanning Model 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: Language Identification Model com.google.firebase:firebase-ml-natural-language-language-id-model 20.0.8
Firebase ML: Translate Model com.google.firebase:firebase-ml-natural-language-translate-model 20.0.9
Firebase ML: Modell für die Funktion „Intelligente Antwort“ com.google.firebase:firebase-ml-natural-language-smart-reply-model 20.0.8

1 Firebase AI Logic hieß früher „Vertex AI in Firebase“ mit dem Paket com.google.firebase:firebase-vertexai.


Nächste Schritte

Firebase-Dienste zu Ihrer App hinzufügen:

Weitere Informationen zu Firebase