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 sowohl in der Firebase Console als auch in Ihrem geöffneten Android-Projekt Aufgaben ausführen. So laden Sie beispielsweise Firebase-Konfigurationsdateien aus der Konsole 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.3.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>Firebase Android BoM>Firebase Android BoM>Firebase Android BoM>Firebase Android BoM>Firebase Android BoM>Firebase Android BoM>Firebase Android BoM>Firebase Android BoM>Firebase Android BoM>Firebase Android BoM>Firebase Android BoM>Firebase Android BoM>Firebase Android BoM>Firebase Android BoM>Firebase Android BoM>Firebase Android BoM>Firebase Android BoM>Firebase Android BoM>�

    Analytics nicht aktiviert

    dependencies {
      // ...
    
      // Import the Firebase BoM
      implementation(platform("com.google.firebase:firebase-bom:34.3.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>Firebase Android BoM>Firebase Android BoM>Firebase Android BoM>Firebase Android BoM>Firebase Android BoM>Firebase Android BoM>Firebase Android BoM>Firebase Android BoM>Firebase Android BoM>Firebase Android BoM>Firebase Android BoM>Firebase Android BoM>Firebase Android BoM>Firebase Android BoM>Firebase Android BoM>Firebase Android BoM>Firebase Android BoM>Firebase Android BoM>�

  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 Assistant 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.3.0
AdMob com.google.android.gms:play-services-ads 24.6.0
Firebase AI Logic 1 com.google.firebase:firebase-ai 17.3.0
Analytics com.google.firebase:firebase-analytics 23.0.0
App Check Benutzerdefinierter Anbieter com.google.firebase:firebase-appcheck 19.0.1
App Check debug provider com.google.firebase:firebase-appcheck-debug 19.0.1
App Check Play Integrity-Anbieter com.google.firebase:firebase-appcheck-playintegrity 19.0.1
App Distribution com.google.firebase:firebase-appdistribution 16.0.0-beta17
App Distribution API com.google.firebase:firebase-appdistribution-api 16.0.0-beta17
App Distribution-Plug-in com.google.firebase:firebase-appdistribution-gradle 5.1.1
Authentication com.google.firebase:firebase-auth 24.0.1
Cloud Firestore com.google.firebase:firebase-firestore 26.0.1
Cloud Functions for Firebase Client SDK com.google.firebase:firebase-functions 22.0.1
Cloud Messaging com.google.firebase:firebase-messaging 25.0.1
Cloud Storage com.google.firebase:firebase-storage 22.0.1
Crashlytics com.google.firebase:firebase-crashlytics 20.0.2
Crashlytics NDK com.google.firebase:firebase-crashlytics-ndk 20.0.2
Crashlytics-Plug-in com.google.firebase:firebase-crashlytics-gradle 3.0.6
Data Connect com.google.firebase:firebase-dataconnect 17.0.1
Unterstützung von Modulen für dynamische Funktionen com.google.firebase:firebase-dynamic-module-support 16.0.0-beta04
In-App Messaging com.google.firebase:firebase-inappmessaging 22.0.1
(erforderlich)
In-App Messaging Display com.google.firebase:firebase-inappmessaging-display 22.0.1
(erforderlich)
Firebase-Installationen com.google.firebase:firebase-installations 19.0.1
Firebase ML Model Downloader API com.google.firebase:firebase-ml-modeldownloader 26.0.1
Performance Monitoring com.google.firebase:firebase-perf 22.0.2
Performance Monitoring-Plug-in com.google.firebase:perf-plugin 2.0.1
Realtime Database com.google.firebase:firebase-database 22.0.1
Remote Config com.google.firebase:firebase-config 23.0.1
Google Play-Dienste-Plug-in com.google.gms:google-services 4.4.3
VERALTETE ODER NICHT UNTERSTÜTZTE BIBLIOTHEKEN
App Indexing com.google.firebase:firebase-appindexing 20.0.0
Dynamic Links com.google.firebase:firebase-dynamic-links 22.1.0

Firebase KTX-Module werden nicht mehr unterstützt

Analytics Nicht verwenden; KTX-Modulbibliotheken werden nicht mehr unterstützt.
com.google.firebase:firebase-analytics-ktx
22.5.0
App Check Benutzerdefinierter Anbieter Nicht verwenden. KTX-Modulbibliotheken werden nicht mehr unterstützt.
com.google.firebase:firebase-appcheck-ktx
18.0.0
App Distribution API Nicht verwenden; KTX-Modulbibliotheken werden nicht mehr unterstützt.
com.google.firebase:firebase-appdistribution-api-ktx
16.0.0-beta15
Authentication Nicht verwenden; KTX-Modulbibliotheken werden nicht mehr unterstützt.
com.google.firebase:firebase-auth-ktx
23.2.1
Cloud Firestore Nicht verwenden; KTX-Modulbibliotheken werden nicht mehr unterstützt.
com.google.firebase:firebase-firestore-ktx
25.1.4
Cloud Functions for Firebase Client SDK Nicht verwenden; KTX-Modulbibliotheken werden nicht mehr unterstützt.
com.google.firebase:firebase-functions-ktx
21.2.1
Cloud Messaging Nicht verwenden; KTX-Modulbibliotheken werden nicht mehr unterstützt.
com.google.firebase:firebase-messaging-ktx
24.1.2
Cloud Storage Nicht verwenden; KTX-Modulbibliotheken werden nicht mehr unterstützt.
com.google.firebase:firebase-storage-ktx
21.0.2
Crashlytics Nicht verwenden. KTX-Modulbibliotheken werden nicht mehr unterstützt.
com.google.firebase:firebase-crashlytics-ktx
19.4.4
Dynamic Links Nicht verwenden; KTX-Modulbibliotheken werden nicht mehr unterstützt.
com.google.firebase:firebase-dynamic-links-ktx
22.1.0
In-App Messaging Nicht verwenden; KTX-Modulbibliotheken werden nicht mehr unterstützt.
com.google.firebase:firebase-inappmessaging-ktx
21.0.2
(erforderlich)
In-App Messaging Display Nicht verwenden; KTX-Modulbibliotheken werden nicht mehr unterstützt.
com.google.firebase:firebase-inappmessaging-display-ktx
21.0.2
(erforderlich)
Firebase-Installationen Nicht verwenden; KTX-Modulbibliotheken werden nicht mehr unterstützt.
com.google.firebase:firebase-installations-ktx
18.0.0
Firebase ML Model Downloader API Nicht verwenden; KTX-Modulbibliotheken werden nicht mehr unterstützt.
com.google.firebase:firebase-ml-modeldownloader-ktx
25.0.1
Performance Monitoring Nicht verwenden; KTX-Modulbibliotheken werden nicht mehr unterstützt.
com.google.firebase:firebase-perf-ktx
21.0.5
Realtime Database Nicht verwenden; KTX-Modulbibliotheken werden nicht mehr unterstützt.
com.google.firebase:firebase-database-ktx
21.0.0
Remote Config Nicht verwenden; KTX-Modulbibliotheken werden nicht mehr unterstützt.
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-Scanmodell 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 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

Firebase-Dienste zu Ihrer App hinzufügen:

  • Mit Gemini- und Imagen-Modellen auf generativer KI basierende Funktionen mit Firebase AI Logic erstellen.

  • Mit Analytics können Sie Einblicke in das Nutzerverhalten gewinnen.

  • Richten Sie einen Nutzerauthentifizierungsablauf mit Authentication ein.

  • Speichern Sie Daten wie Nutzerinformationen mit Cloud Firestore oder Realtime Database.

  • Mit Cloud Storage können Sie Dateien wie Fotos und Videos speichern.

  • Mit Cloud Functions können Sie Back-End-Code auslösen, der in einer sicheren Umgebung ausgeführt wird.

  • Benachrichtigungen mit Cloud Messaging senden

  • Mit Crashlytics können Sie herausfinden, wann und warum Ihre App abstürzt.

Weitere Informationen zu Firebase