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öhercompileSdkVersion
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.
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.
Firebase-Projekt erstellen
-
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.
-
-
Lesen Sie sich die Firebase-Nutzungsbedingungen durch und akzeptieren Sie sie.
-
Klicken Sie auf Weiter.
-
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.
-
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.
Rufen Sie die Firebase Console auf.
Klicken Sie in der Mitte der Projektübersicht auf das Symbol Android (
) oder App hinzufügen, um den Einrichtungsworkflow zu starten.Geben Sie den Paketnamen Ihrer App in das Feld Android-Paketname ein.
Was ist ein Paketname und wo finde ich ihn?
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.
Optional: Geben Sie weitere App-Informationen ein: App-Alias und SHA-1-Wert des Signaturzertifikats für die Fehlerbehebung.
Wie werden der App-Alias und das SHA-1-Signaturzertifikat für die Fehlerbehebung in Firebase verwendet?
App-Alias: Eine interne, praktische Kennung, die nur in der Firebase-Konsole angezeigt wird
SHA-1-Wert des Signaturzertifikats für die Fehlerbehebung: Für Firebase Authentication (bei Verwendung von Google Sign In oder Anmeldung per Telefonnummer) und Firebase Dynamic Links ist ein SHA-1-Hash erforderlich.
Klicken Sie auf App registrieren.
Schritt 3: Firebase-Konfigurationsdatei hinzufügen
Laden Sie die Firebase-Android-Konfigurationsdatei (
) herunter und fügen Sie sie Ihrer App hinzu:google-services.json Klicken Sie auf google-services.json herunterladen, um die Firebase-Android-Konfigurationsdatei abzurufen.
Verschieben Sie die Konfigurationsdatei in das Stammverzeichnis des Moduls (auf App-Ebene) Ihrer App.
Was müssen Sie über diese Konfigurationsdatei wissen?
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.
Wenn Sie die Werte in Ihrer
-Konfigurationsdatei für Firebase SDKs verfügbar machen möchten, benötigen Sie das Gradle-Plug-in für Google-Dienste (google-services.json google-services
).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 }
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
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.
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.
Erhalten Sie einen Buildfehler bezüglich der Unterstützung von „invoke-custom“ und der Aktivierung der Desugaring-Funktion? So beheben Sie das Problem:
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 derbuild.gradle.kts
- oderbuild.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.
- Fügen Sie die aufgeführte
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.
Ö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
Öffnen Sie den Firebase Assistant: Tools > Firebase.
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 ).Klicken Sie auf Connect to Firebase (Mit Firebase verbinden), um Ihr Android-Projekt mit Firebase zu verbinden.
Was macht dieser Workflow?
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 (
) Ihres Firebase-Projekts dem Modulverzeichnis (App-Ebene) Ihrer App hinzugefügt.google-services.json
Klicken Sie auf die Schaltfläche, um ein gewünschtes Firebase-Produkt hinzuzufügen, z. B.
Analytics zu Ihrer App hinzufügen .
Synchronisieren Sie die App, damit für alle Abhängigkeiten die erforderlichen Versionen vorliegen.
Folgen Sie im Bereich Assistent der restlichen Einrichtungsanleitung für das ausgewählte Firebase-Produkt.
Ü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:
Firebase Android SDK GitHub-Repository
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 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Firebase KTX-Module
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Firebase ML Kit-Bibliotheken
|
Nächste Schritte
Fügen Sie Ihrer App Firebase-Dienste hinzu:
Mit Analytics erhalten Sie Informationen zum Nutzerverhalten.
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:
Unter Firebase-Projekte verstehen finden Sie weitere Informationen zu Firebase-Projekten und Best Practices für Projekte.
Unter Weitere Informationen zu Android und Firebase finden Sie Antworten auf Fragen zu Konzepten, die Ihnen nicht vertraut sind oder speziell für die Firebase- und Android-Entwicklung gelten.
Sehen Sie sich Firebase-Beispiel-Apps an.
Im Firebase Android-Codelab können Sie praktische Erfahrungen sammeln.
Weitere Informationen finden Sie im Kurs Firebase in einem Wochenende.
Einführung Ihrer App vorbereiten:
- Richten Sie in der Google Cloud Console Budgetbenachrichtigungen für Ihr Projekt ein.
- Im Firebase-Dashboard Nutzung und Abrechnung können Sie sich ein Gesamtbild der Nutzung Ihres Projekts in mehreren Firebase-Diensten machen.
- Sehen Sie sich die Checkliste für die Einführung von Firebase an.
Sie haben Probleme mit Firebase und Ihrem Android-Projekt? Weitere Informationen zur Fehlerbehebung und FAQs zu Android