Fügen Sie Ihrem Android-Projekt Firebase hinzu

Voraussetzungen

• Installieren oder aktualisieren Sie Android Studio auf die neueste Version.

• Stellen Sie sicher, dass Ihr Projekt diese Anforderungen erfüllt:

  • Zielt auf API-Level 19 (KitKat) oder höher ab
  • Verwendet Android 4.4 oder höher
  • Verwendet Jetpack (AndroidX) , was die Erfüllung dieser Versionsanforderungen beinhaltet:
    • 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 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 bei Firebase an .

Wenn Sie noch kein Android-Projekt haben und einfach nur ein Firebase-Produkt ausprobieren möchten, können Sie eines unserer Schnellstart-Beispiele herunterladen.

Sie können Ihre Android-App mit einer der folgenden Optionen mit Firebase verbinden:

• Option 1 : (empfohlen) Verwenden Sie den Setup-Workflow der Firebase-Konsole.
• Option 2 : Verwenden Sie den Android Studio Firebase Assistant (möglicherweise ist eine zusätzliche Konfiguration erforderlich).

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

Das Hinzufügen von Firebase zu Ihrer App erfordert Aufgaben sowohl in der Firebase-Konsole als auch in Ihrem offenen 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 Firebase zu Ihrer Android-App 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 oft als „Hinzufügen“ Ihrer App zu Ihrem Projekt bezeichnet.

1. Gehen Sie zur Firebase-Konsole .

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

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

   Was ist ein Paketname und wo findet man ihn?

   • Ein Paketname identifiziert Ihre App eindeutig auf dem Gerät und im Google Play Store.

   • Ein Paketname wird oft 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 beim Wert des Paketnamens die Groß-/Kleinschreibung beachtet wird und er für diese Firebase-Android-App nicht geändert werden kann, nachdem sie bei Ihrem Firebase-Projekt registriert wurde.

4. (Optional) Geben Sie weitere App-Informationen ein: App-Spitzname und Debug-Signaturzertifikat SHA-1 .

   Wie werden der App-Spitzname und das Debug-Signaturzertifikat SHA-1 in Firebase verwendet?

   • App-Spitzname : Eine interne, praktische Kennung, die nur für Sie in der Firebase-Konsole sichtbar ist

   • Debug-Signaturzertifikat SHA-1 : Ein SHA-1-Hash ist für die Firebase-Authentifizierung (bei Verwendung von Google Sign-In oder Telefonnummer-Anmeldung ) und Firebase Dynamic Links erforderlich.

5. Klicken Sie auf App registrieren .

Schritt 3 : Fügen Sie eine Firebase-Konfigurationsdatei hinzu

1. Laden Sie die Firebase Android-Konfigurationsdatei ( google-services.json ) herunter und fügen Sie sie Ihrer App hinzu:

   1. Klicken Sie auf „Google-services.json herunterladen“, um Ihre Firebase-Android-Konfigurationsdatei zu erhalten.

   2. Verschieben Sie Ihre Konfigurationsdatei in das Stammverzeichnis des Moduls (App-Ebene) Ihrer App.

   Was müssen Sie über diese Konfigurationsdatei wissen?

   • 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 an den Namen der Konfigurationsdatei keine zusätzlichen Zeichen wie (2) angehängt werden.

2. Um die Werte in Ihrer google-services.json -Konfigurationsdatei für Firebase-SDKs zugänglich zu machen, benötigen Sie das Gradle-Plugin für Google-Dienste ( google-services ).

   1. Fügen Sie in Ihrer Gradle-Datei auf Stammebene (Projektebene) ( <project>/build.gradle.kts oder <project>/build.gradle ) das Google Services-Plugin als Abhängigkeit hinzu:

      Kotlin

      plugins {
        id("com.android.application") version "7.2.0" apply false
        // ...
      
        // Add the dependency for the Google services Gradle plugin
        id("com.google.gms.google-services") version "4.3.15" apply false
      }
      

      Groovy

      plugins {
        id 'com.android.application' version '7.2.0' apply false
        // ...
      
        // Add the dependency for the Google services Gradle plugin
        id 'com.google.gms.google-services' version '4.3.15' apply false
      }
      

   2. Fügen Sie in Ihrer Modul-Gradle-Datei (auf App-Ebene) (normalerweise <project>/<app-module>/build.gradle.kts oder <project>/<app-module>/build.gradle ) das Google Services-Plugin 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 : Fügen Sie Ihrer App Firebase-SDKs hinzu

1. Fügen Sie in Ihrer Modul-Gradle-Datei (auf App-Ebene) (normalerweise <project>/build.gradle.kts oder <project>/build.gradle ) die Abhängigkeiten für die Firebase-Produkte hinzu, die Sie in Ihrer App verwenden möchten. Wir empfehlen die Verwendung der Firebase Android BoM zur Steuerung der Bibliotheksversionierung.

   Analytics aktiviert

   Kotlin+KTX

   dependencies {
     // ...
   
     // Import the Firebase BoM
     implementation(platform("com.google.firebase:firebase-bom:32.3.1"))
   
     // 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-ktx")
   
     // 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-ktx")
     implementation("com.google.firebase:firebase-firestore-ktx")
   }
   

   Java

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

   Durch die Verwendung der Firebase Android BoM verwendet Ihre App immer kompatible Versionen der Firebase Android-Bibliotheken.

   Analytics nicht aktiviert

   Kotlin+KTX

   dependencies {
     // ...
   
     // Import the Firebase BoM
     implementation(platform("com.google.firebase:firebase-bom:32.3.1"))
   
     // 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-ktx")
     implementation("com.google.firebase:firebase-firestore-ktx")
   }
   

   Java

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

   Durch die Verwendung der Firebase Android BoM verwendet Ihre App immer kompatible Versionen der Firebase Android-Bibliotheken.

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.

   Erhalten Sie einen Build-Fehler bezüglich der Invoke-Custom-Unterstützung und der Aktivierung des Desugarings? Hier erfahren Sie, wie Sie das Problem beheben können.

   Gradle-Builds, die das Android Gradle-Plugin (AGP) v4.2 oder früher verwenden, müssen die Java 8-Unterstützung aktivieren. Andernfalls kommt es bei diesen Android-Projekten zu einem Buildfehler, wenn ein Firebase SDK hinzugefügt wird.

   Um diesen Build-Fehler zu beheben, können Sie eine von zwei Optionen wählen:

   • Fügen Sie die aufgelisteten compileOptions aus der Fehlermeldung zu Ihrer build.gradle.kts oder build.gradle -Datei auf App-Ebene hinzu.
   • Erhöhen Sie den minSdk für Ihr Android-Projekt auf 26 oder höher.

   Erfahren Sie mehr über diesen Build-Fehler in dieser FAQ .

Das ist es! Sie können weitermachen und sich die empfohlenen nächsten Schritte ansehen.

Wenn Sie jedoch Probleme bei der Einrichtung haben, besuchen Sie die Android-Fehlerbehebung und FAQ .

Option 2 : Firebase mit dem Firebase-Assistenten hinzufügen

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 in Android Studio!

1. Öffnen Sie Ihr Android-Projekt in Android Studio und stellen Sie dann sicher, dass Sie die neuesten Versionen von Android Studio und dem Firebase Assistant verwenden:

   • Windows/Linux: Hilfe > Nach Updates suchen
   • macOS: Android Studio > Nach Updates suchen

2. Öffnen Sie den Firebase-Assistenten: Extras > Firebase .

3. Wählen Sie im Assistentenbereich ein Firebase-Produkt aus, das Sie Ihrer App hinzufügen möchten. Erweitern Sie den Abschnitt und klicken Sie dann auf den Tutorial-Link (z. B. Analytics > Ein Analytics-Ereignis protokollieren ).

   1. Klicken Sie auf „Mit Firebase verbinden“ , um Ihr Android-Projekt mit Firebase zu verbinden.

      Was macht dieser Workflow?

      • 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 einem neuen Projekt erstellen.

        Hier sind einige Tipps zum Einrichten Ihres Firebase-Projekts:

        • Sehen Sie sich unsere Best Practices zum Hinzufügen von Apps zu einem Firebase-Projekt an, einschließlich der Handhabung mehrerer Varianten.

        • Wenn Sie ein neues Projekt erstellen, empfehlen wir Ihnen dringend, Google Analytics für Ihr Projekt einzurichten, damit Sie viele Firebase-Produkte optimal nutzen können.

      • Dieser Workflow fügt auch die Android-Konfigurationsdatei Ihres Firebase-Projekts ( google-services.json ) zum Modulverzeichnis (App-Ebene) Ihrer App hinzu.

   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, um sicherzustellen, dass alle Abhängigkeiten über die erforderlichen Versionen verfügen.

5. Befolgen Sie im Assistentenbereich die restlichen Einrichtungsanweisungen für Ihr ausgewähltes Firebase-Produkt.

6. Fügen Sie über den Firebase-Assistenten beliebig viele weitere Firebase-Produkte hinzu!

Das ist es! Schauen Sie sich unbedingt die empfohlenen nächsten Schritte an.

Wenn Sie jedoch Probleme bei der Einrichtung haben, besuchen Sie die Android-Fehlerbehebung und FAQ .

Verfügbare Bibliotheken

In diesem Abschnitt werden die für Android unterstützten Firebase-Produkte und ihre Gradle-Abhängigkeiten aufgeführt. Erfahren Sie mehr über diese Firebase-Android-Bibliotheken:

• Referenzdokumentation ( Kotlin+KTX | Java )

• 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 Ihrer Gradle-Build-Konfigurationsdatei deklarieren.

Nächste Schritte

Fügen Sie Ihrer App Firebase-Dienste hinzu:

• Gewinnen Sie Einblicke in das Nutzerverhalten mit Analytics .

• Richten Sie mit Authentication einen Benutzerauthentifizierungsablauf ein.

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

• Speichern Sie Dateien wie Fotos und Videos mit Cloud Storage .

• Lösen Sie Back-End-Code aus, der in einer sicheren Umgebung mit Cloud Functions ausgeführt wird.

• Senden Sie Benachrichtigungen mit Cloud Messaging .

• Finden Sie mit Crashlytics heraus, wann und warum Ihre App 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 Erfahren Sie mehr über Android und Firebase, wenn Sie Fragen zu Konzepten haben, die Ihnen unbekannt oder spezifisch für die Firebase- und Android-Entwicklung sind.

• Entdecken Sie Beispiel-Firebase-Apps .

• Sammeln Sie praktische Erfahrungen mit dem Firebase Android Codelab .

• Erfahren Sie mehr über die 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 Nutzungs- und Abrechnungs- Dashboard in der Firebase-Konsole, um einen Gesamtüberblick über die Nutzung Ihres Projekts über mehrere Firebase-Dienste hinweg zu erhalten.
  • Sehen Sie sich die Checkliste für den Firebase-Start an.

• Haben Sie Probleme mit Firebase und Ihrem Android-Projekt? Besuchen Sie die Android-Fehlerbehebung und FAQ .