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. Beachten Sie, dass für einige Produkte strengere Anforderungen gelten können:

    • Auf API-Level 21 (Lollipop) oder höher ausgerichtet
    • Android 5.0 oder höher verwendet
    • Sie verwenden Jetpack (AndroidX) und erfüllen dabei 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 können beispielsweise Firebase-Konfigurationsdateien aus der Console herunterladen und dann in Ihr Android-Projekt verschieben.

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 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.

  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-Konfigurationsdatei (google-services.json) Ihrer App herunter und fügen Sie sie Ihrer Codebasis hinzu:

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

    2. Verschieben Sie die Konfigurationsdatei in das Stammverzeichnis des Moduls (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 das Google-Dienste-Plug-in als Abhängigkeit in die Gradle-Datei auf Stammebene (Projektebene) (<project>/build.gradle.kts oder <project>/build.gradle) ein:

      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 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.

    Analytics aktiviert 

    dependencies {
  // ...

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

    Analytics nicht aktiviert 

    dependencies {
  // ...

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

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 bei 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 Hilfe 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.

    2. Klicken Sie auf die Schaltfläche, um ein gewünschtes Firebase-Produkt hinzuzufügen, z. B. Analytics zur 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.16.0
AdMob com.google.android.gms:play-services-ads 24.4.0
Firebase AI Logic 1 com.google.firebase:firebase-ai 16.2.0
Analytics com.google.firebase:firebase-analytics 22.5.0
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-beta15
App Distribution API com.google.firebase:firebase-appdistribution-api 16.0.0-beta15
App Distribution-Plug-in com.google.firebase:firebase-appdistribution-gradle 5.1.1
Authentication com.google.firebase:firebase-auth 23.2.1
Cloud Firestore com.google.firebase:firebase-firestore 25.1.4
Cloud Functions for Firebase Client SDK com.google.firebase:firebase-functions 21.2.1
Cloud Messaging com.google.firebase:firebase-messaging 24.1.2
Cloud Storage com.google.firebase:firebase-storage 21.0.2
Crashlytics com.google.firebase:firebase-crashlytics 19.4.4
Crashlytics NDK com.google.firebase:firebase-crashlytics-ndk 19.4.4
Crashlytics-Plug-in com.google.firebase:firebase-crashlytics-gradle 3.0.4
Data Connect com.google.firebase:firebase-dataconnect 16.0.3
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.2
(erforderlich)
In-App Messaging Display com.google.firebase:firebase-inappmessaging-display 21.0.2
(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.5
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.1.2
Google Play-Dienste-Plug-in com.google.gms:google-services 4.4.3
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

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: 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: Spracherkennungsmodell 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

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


Nächste Schritte

Fügen Sie Ihrer App Firebase-Dienste hinzu:

Weitere Informationen zu Firebase: