Voraussetzungen
Installieren oder aktualisieren Sie Android Studio auf die neueste Version.
Stellen Sie sicher, dass Ihr Projekt die folgenden Anforderungen erfüllt:
- Zielt auf API-Level 16 (Jelly Bean) oder höher ab
- Verwendet Gradle 4.1 oder höher
- Verwendet Jetpack (AndroidX) , einschließlich der Erfüllung dieser Versionsanforderungen:
-
com.android.tools.build:gradle
v3.2.1 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.
Beachten Sie, dass für Firebase-SDKs mit einer Abhängigkeit von Google Play-Diensten auf dem Gerät oder Emulator Google Play-Dienste installiert sein müssen.Melden Sie sich mit Ihrem Google-Konto bei 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 können Ihre Android-App mit einer der folgenden Optionen mit Firebase verbinden:
- Option 1 : (empfohlen) Verwenden Sie den Workflow zur Einrichtung der Firebase-Konsole.
- Option 2 : Verwenden Sie den Android Studio Firebase-Assistenten (möglicherweise ist eine zusätzliche Konfiguration erforderlich).
Option 1 : Fügen Sie Firebase über die Firebase-Konsole hinzu
Das Hinzufügen von Firebase zu Ihrer App umfasst Aufgaben sowohl in der Firebase-Konsole als auch in Ihrem geöffneten Android-Projekt (Sie laden beispielsweise Firebase-Konfigurationsdateien von der Konsole herunter und verschieben sie dann in Ihr Android-Projekt).
Schritt 1 : Erstellen Sie ein Firebase-Projekt
Bevor Sie Ihrer Android-App Firebase hinzufügen können, müssen Sie ein Firebase-Projekt erstellen, um eine Verbindung zu Ihrer Android-App herzustellen. Besuchen Sie Firebase-Projekte verstehen , um mehr über Firebase-Projekte zu erfahren.
Schritt 2 : Registrieren Sie Ihre App bei Firebase
Um Firebase in Ihrer Android-App verwenden zu können, müssen Sie Ihre App bei Ihrem Firebase-Projekt registrieren. Das Registrieren Ihrer App wird häufig als "Hinzufügen" Ihrer App zu Ihrem Projekt bezeichnet.
Gehen Sie zur Firebase-Konsole .
Klicken Sie in der Mitte der
das Android- Symbol ( ) oder App , um den Setup-Workflow zu starten.Geben Sie den Paketnamen Ihrer App in das Feld Android-Paketname ein.
Ein Paketname identifiziert Ihre App auf dem Gerät und im Google Play Store eindeutig.
Ein Paketname wird häufig als Anwendungs-ID bezeichnet .
Suchen Sie den Paketnamen Ihrer App in der Gradle-Datei Ihres Moduls (App-Ebene), normalerweise
app/build.gradle
(Beispielpaketname:com.yourcompany.yourproject
).Beachten Sie, dass der Wert des Paketnamens zwischen Groß- und Kleinschreibung unterscheidet und für diese Firebase-Android-App nicht geändert werden kann, nachdem sie bei Ihrem Firebase-Projekt registriert wurde.
(Optional) Geben Sie weitere App-Informationen ein: App-Kurzname und Debug-Signaturzertifikat SHA-1 .
App-Spitzname : Eine interne Komfortkennung, die nur in der Firebase-Konsole für Sie sichtbar ist
Debug-Signaturzertifikat SHA-1 : Für die Firebase-Authentifizierung (bei Verwendung der Google -Anmeldung oder der Anmeldung unter der Telefonnummer ) und für Firebase Dynamic Links ist ein SHA-1-Hash erforderlich.
Klicken Sie auf App registrieren .
Schritt 3 : Fügen Sie eine Firebase-Konfigurationsdatei hinzu
Fügen Sie Ihrer App die Firebase Android-Konfigurationsdatei hinzu:
Klicken Sie auf google-services.json herunterladen , um Ihre Firebase-Android-Konfigurationsdatei (
) abzurufen.google-services.json Verschieben Sie Ihre Konfigurationsdatei in das Modulverzeichnis (App-Ebene) Ihrer App.
Die Firebase-Konfigurationsdatei enthält eindeutige, aber nicht geheime Kennungen für Ihr Projekt. Weitere Informationen zu dieser Konfigurationsdatei finden Sie unter Grundlegendes zu Firebase-Projekten .
Sie können Ihre Firebase-Konfigurationsdatei jederzeit erneut herunterladen.
Stellen Sie sicher, dass der Name der Konfigurationsdatei nicht mit zusätzlichen Zeichen wie
(2)
.
Fügen Sie Ihren Gradle-Dateien das Google Services-Plugin hinzu , um Firebase-Produkte in Ihrer App zu aktivieren.
build.gradle
in Ihrer Gradle-Datei aufbuild.gradle
(Projektebene) (build.gradle
) Regeln hinzu, um das Gradle-Plugin von Google Services einzuschließen. Überprüfen Sie, ob Sie auch über das Maven-Repository von Google verfügen.buildscript { repositories { // Check that you have the following line (if not, add it): google() // Google's Maven repository } dependencies { // ... // Add the following line: classpath 'com.google.gms:google-services:4.3.5' // Google Services plugin } } allprojects { // ... repositories { // Check that you have the following line (if not, add it): google() // Google's Maven repository // ... } }
app/build.gradle
Gradle-Datei Ihres Moduls (App-Ebene) (normalerweiseapp/build.gradle
) das Google Services Gradle-Plugin an:apply plugin: 'com.android.application' // Add the following line: apply plugin: 'com.google.gms.google-services' // Google Services plugin android { // ... }
Schritt 4 : Fügen Sie Ihrer App Firebase-SDKs hinzu
Deklarieren Sie mithilfe der Firebase Android BoM die Abhängigkeiten für die Firebase-Produkte , die Sie in Ihrer App verwenden möchten. Deklarieren Sie sie in der Gradle-Datei Ihres Moduls (App-Ebene) (normalerweise
app/build.gradle
).Analytics aktiviert
Java
dependencies { // ... // Import the Firebase BoM implementation platform('com.google.firebase:firebase-bom:27.1.0') // When using the BoM, you don't specify versions in Firebase library dependencies // Declare the dependency for the Firebase SDK for Google Analytics implementation 'com.google.firebase:firebase-analytics' // Declare the dependencies for any other desired Firebase products // For example, declare the dependencies for Firebase Authentication and Cloud Firestore implementation 'com.google.firebase:firebase-auth' implementation 'com.google.firebase:firebase-firestore' }
Kotlin + KTX
dependencies { // ... // Import the Firebase BoM implementation platform('com.google.firebase:firebase-bom:27.1.0') // When using the BoM, you don't specify versions in Firebase library dependencies // Declare the dependency for the Firebase SDK for Google Analytics implementation 'com.google.firebase:firebase-analytics-ktx' // Declare the dependencies for any other desired Firebase products // For example, declare the dependencies for Firebase Authentication and Cloud Firestore implementation 'com.google.firebase:firebase-auth-ktx' implementation 'com.google.firebase:firebase-firestore-ktx' }
Bei Verwendung der Firebase Android BoM verwendet Ihre App immer kompatible Versionen der Firebase Android-Bibliotheken.
Analytics nicht aktiviert
Java
dependencies { // ... // Import the Firebase BoM implementation platform('com.google.firebase:firebase-bom:27.1.0') // When using the BoM, you don't specify versions in Firebase library dependencies // Declare the dependencies for the desired Firebase products // For example, declare the dependencies for Firebase Authentication and Cloud Firestore implementation 'com.google.firebase:firebase-auth' implementation 'com.google.firebase:firebase-firestore' }
Kotlin + KTX
dependencies { // ... // Import the Firebase BoM implementation platform('com.google.firebase:firebase-bom:27.1.0') // When using the BoM, you don't specify versions in Firebase library dependencies // Declare the dependencies for the desired Firebase products // For example, declare the dependencies for Firebase Authentication and Cloud Firestore implementation 'com.google.firebase:firebase-auth-ktx' implementation 'com.google.firebase:firebase-firestore-ktx' }
Bei Verwendung der Firebase Android BoM verwendet Ihre App immer kompatible Versionen der Firebase Android-Bibliotheken.
Synchronisieren Sie Ihre App, um sicherzustellen, dass alle Abhängigkeiten die erforderlichen Versionen haben.
Das ist es! Sie können fortfahren, um die empfohlenen nächsten Schritte zu überprüfen.
Option 2 : Fügen Sie Firebase mit dem Firebase-Assistenten hinzu
Der Firebase-Assistent registriert Ihre App bei einem Firebase-Projekt und fügt Ihrem Android-Projekt die erforderlichen Firebase-Dateien, Plugins und Abhängigkeiten hinzu - alles aus Android Studio heraus!
Öffnen Sie Ihr Android-Projekt in Android Studio und stellen Sie sicher, dass Sie die neuesten Versionen von Android Studio und den Firebase-Assistenten verwenden:
- Windows / Linux: Hilfe> Nach Updates suchen
- macOS: Android Studio> Nach Updates suchen
Öffnen Sie den Firebase-Assistenten: Extras> Firebase .
Wählen Sie im Assistentenbereich ein Firebase-Produkt aus, das Sie Ihrer App hinzufügen möchten. Erweitern Sie den Abschnitt und klicken Sie auf den Link zum Lernprogramm (z. B.
Analytics> Analytics-Ereignis protokollieren ).Klicken Sie auf Mit Firebase verbinden, um Ihr Android-Projekt mit Firebase zu verbinden.
Dieser Workflow erstellt automatisch eine neue Firebase-Android-App unter Verwendung des Paketnamens Ihrer App. Sie können diese neue Firebase-Android-App entweder in einem vorhandenen Firebase-Projekt oder in einem neuen Projekt erstellen.
Hier einige Tipps zum Einrichten Ihres Firebase-Projekts:
Besuchen Sie Firebase-Projekte verstehen , um mehr über bewährte Methoden und Überlegungen zum Hinzufügen von Apps zu einem Firebase-Projekt zu erfahren, einschließlich der Behandlung mehrerer Build-Varianten.
Wenn Sie ein neues Projekt erstellen, empfehlen wir dringend, Google Analytics für Ihr Projekt einzurichten, damit Sie mit vielen Firebase-Produkten eine optimale Erfahrung erzielen können.
Dieser Workflow fügt auch die Android-Konfigurationsdatei Ihres Firebase-Projekts (
) zum Modulverzeichnis (App-Ebene) Ihrer App hinzu.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 Ihre App, um sicherzustellen, dass alle Abhängigkeiten die erforderlichen Versionen haben.
Befolgen Sie im Assistentenbereich die verbleibenden Installationsanweisungen für Ihr ausgewähltes Firebase-Produkt.
Fügen Sie über den Firebase-Assistenten so viele andere Firebase-Produkte hinzu, wie Sie möchten!
Das ist es! Lesen Sie unbedingt die empfohlenen nächsten Schritte .
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:
Referenzdokumentation ( Java | Kotlin + KTX )
Firebase Android SDK GitHub Repo
Beachten Sie, dass Sie bei Verwendung der Firebase Android BoM keine einzelnen Bibliotheksversionen angeben, wenn Sie Firebase-Bibliotheksabhängigkeiten in build.gradle
.
Java
Service oder Produkt | Gradle-Abhängigkeit | Neueste Ausführung | Analytics hinzufügen? |
---|---|---|---|
Firebase Android BoM (Stückliste) | com.google.firebase: firebase-bom Die neueste Firebase BoM-Version enthält die neuesten Versionen jeder Firebase Android-Bibliothek. Lesen Sie die Versionshinweise für diese BoM-Version, um zu erfahren, welche Bibliotheksversionen einer bestimmten BoM-Version zugeordnet sind. | 27.1.0 | |
AdMob | com.google.android.gms: Play-Services-Anzeigen | 20.0.0 | |
Analytik | com.google.firebase: Firebase-Analyse | 18.0.3 | |
App-Indizierung | com.google.firebase: firebase-appindexing | 19.2.0 | |
Authentifizierung | com.google.firebase: firebase-auth | 20.0.4 | |
Cloud Firestore | com.google.firebase: firebase-firestore | 22.1.2 | |
Cloud-Funktionen für Firebase Client SDK | com.google.firebase: Firebase-Funktionen | 19.2.0 | |
Cloud Messaging | com.google.firebase: Firebase-Messaging | 21.1.0 | |
Cloud-Speicher | com.google.firebase: Firebase-Speicher | 19.2.2 | |
Crashlytics | com.google.firebase: firebase-crashlytics | 17.4.1 | |
Dynamische Links | com.google.firebase: firebase-dynamic-links | 19.1.1 | |
Firebase ML Model Downloader API | com.google.firebase: firebase-ml-modeldownloader | 23.0.1 | |
In-App-Messaging | com.google.firebase: firebase-inappmessaging | 19.1.5 | (erforderlich) |
In-App-Messaging-Anzeige | com.google.firebase: firebase-inappmessaging-display | 19.1.5 | (erforderlich) |
Leistungsüberwachung | com.google.firebase: firebase-perf | 19.1.1 | |
Echtzeitdatenbank | com.google.firebase: firebase-Datenbank | 19.7.0 | |
Remote-Konfiguration | com.google.firebase: firebase-config | 20.0.4 | |
Plugin für Google Play-Dienste | com.google.gms: google-services | 4.3.5 | |
Veraltete Bibliotheken | |||
Benutzerdefinierte Firebase ML-Modell-APIs | 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: Bildbeschriftungsmodell | com.google.firebase: firebase-ml-vision-image-label-model | 20.0.2 | |
Firebase ML: Objekterkennungs- und Verfolgungsmodell | com.google.firebase: firebase-ml-vision-objekterkennungsmodell | 19.0.6 | |
Firebase ML: Gesichtserkennungsmodell | com.google.firebase: firebase-ml-vision-face-model | 20.0.2 | |
Firebase ML: Barcode-Scan-Modell | com.google.firebase: firebase-ml-vision-barcode-modell | 16.1.2 | |
Firebase ML: AutoML Vision Edge-API | com.google.firebase: firebase-ml-vision-automl | 18.0.6 | |
Firebase ML: APIs in natürlicher Sprache | com.google.firebase: firebase-ml-natural-language | 22.0.1 | |
Firebase ML: Sprachidentifikationsmodell | 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: Intelligentes Antwortmodell | com.google.firebase: firebase-ml-natural-language-smart-reply-model | 20.0.8 |
Kotlin + KTX
Service oder Produkt | Gradle-Abhängigkeit | Neueste Ausführung | Analytics hinzufügen? |
---|---|---|---|
Firebase Android BoM (Stückliste) | com.google.firebase: firebase-bom Die neueste Firebase BoM-Version enthält die neuesten Versionen jeder Firebase Android-Bibliothek. Lesen Sie die Versionshinweise für diese BoM-Version, um zu erfahren, welche Bibliotheksversionen einer bestimmten BoM-Version zugeordnet sind. | 27.1.0 | |
AdMob | com.google.android.gms: Play-Services-Anzeigen | 20.0.0 | |
Analytik | com.google.firebase: firebase-analyse-ktx | 18.0.3 | |
App-Indizierung | com.google.firebase: firebase-appindexing | 19.2.0 | |
Authentifizierung | com.google.firebase: firebase-auth-ktx | 20.0.4 | |
Cloud Firestore | com.google.firebase: firebase-firestore-ktx | 22.1.2 | |
Cloud-Funktionen für Firebase Client SDK | com.google.firebase: firebase-functions-ktx | 19.2.0 | |
Cloud Messaging | com.google.firebase: firebase-messaging-ktx | 21.0.1 | |
Cloud-Speicher | com.google.firebase: firebase-storage-ktx | 19.2.2 | |
Crashlytics | com.google.firebase: firebase-crashlytics-ktx | 17.4.1 | |
Dynamische Links | com.google.firebase: firebase-dynamic-links-ktx | 19.1.1 | |
In-App-Messaging | com.google.firebase: firebase-inappmessaging-ktx | 19.1.5 | (erforderlich) |
In-App-Messaging-Anzeige | com.google.firebase: firebase-inappmessaging-display-ktx | 19.1.5 | (erforderlich) |
Leistungsüberwachung | com.google.firebase: firebase-perf-ktx | 19.1.1 | |
Echtzeitdatenbank | com.google.firebase: firebase-database-ktx | 19.7.0 | |
Remote-Konfiguration | com.google.firebase: firebase-config-ktx | 20.0.4 | |
Plugin für Google Play-Dienste | com.google.gms: google-services | 4.3.5 | |
Veraltete Bibliotheken | |||
Benutzerdefinierte Firebase ML-Modell-APIs | 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: Bildbeschriftungsmodell | com.google.firebase: firebase-ml-vision-image-label-model | 20.0.2 | |
Firebase ML: Objekterkennungs- und Verfolgungsmodell | com.google.firebase: firebase-ml-vision-objekterkennungsmodell | 19.0.6 | |
Firebase ML: Gesichtserkennungsmodell | com.google.firebase: firebase-ml-vision-face-model | 20.0.2 | |
Firebase ML: Barcode-Scan-Modell | com.google.firebase: firebase-ml-vision-barcode-modell | 16.1.2 | |
Firebase ML: AutoML Vision Edge-API | com.google.firebase: firebase-ml-vision-automl | 18.0.6 | |
Firebase ML: APIs in natürlicher Sprache | com.google.firebase: firebase-ml-natural-language | 22.0.1 | |
Firebase ML: Sprachidentifikationsmodell | 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: Intelligentes Antwortmodell | com.google.firebase: firebase-ml-natural-language-smart-reply-model | 20.0.8 |
Nächste Schritte
Fügen Sie Ihrer App Firebase-Dienste hinzu:
Erhalten Sie mit Analytics Einblicke in das Benutzerverhalten.
Richten Sie mit Authentifizierung einen Benutzerauthentifizierungsablauf ein.
Speichern Sie Daten wie Benutzerinformationen im Cloud Firestore oder in der Echtzeitdatenbank .
Speichern Sie Dateien wie Fotos und Videos mit Cloud Storage .
Lösen Sie Backend-Code aus, der in einer sicheren Umgebung mit Cloud-Funktionen ausgeführt wird .
Senden Sie Benachrichtigungen mit Cloud Messaging .
Finden Sie heraus, wann und warum Ihre App mit Crashlytics abstürzt.
Erfahren Sie mehr über Firebase:
Besuchen Sie Firebase-Projekte verstehen , um mehr über Firebase-Projekte und Best Practices für Projekte zu erfahren.
Besuchen Sie Weitere Informationen zu Android und Firebase, wenn Sie Fragen zu Konzepten haben, die für die Entwicklung von Firebase und Android nicht bekannt oder spezifisch sind.
Entdecken Sie Beispiel-Firebase-Apps .
Machen Sie praktische Erfahrungen mit dem Firebase Android Codelab .
Erfahren Sie mehr mit der Firebase in einem Wochenendkurs .
Bereiten Sie den Start Ihrer App vor:
- Richten Sie Budgetbenachrichtigungen für Ihr Projekt in der Google Cloud Console ein.
- Überwachen Sie das Dashboard für Nutzung und Abrechnung in der Firebase-Konsole, um ein Gesamtbild der Nutzung Ihres Projekts für mehrere Firebase-Dienste zu erhalten.
- Überprüfen Sie die Checkliste für den Firebase-Start .