Fügen Sie Ihrem Android-Projekt Firebase hinzu

Voraussetzungen

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 ( ) 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-Spitzname und Debug-Signaturzertifikat SHA-1 .

  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.

  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.3.0" apply false
        // ...
      
        // Add the dependency for the Google services Gradle plugin
        id("com.google.gms.google-services") version "4.4.0" 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.0' 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>/<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 Verwendung der Firebase Android BoM zur Steuerung der Bibliotheksversionierung.

    Analytics aktiviert

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

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

    Suchen Sie nach einem Kotlin-spezifischen Bibliotheksmodul? Ab Oktober 2023 (Firebase BoM 32.5.0) können sich sowohl Kotlin- als auch Java-Entwickler auf das Hauptbibliotheksmodul verlassen (Einzelheiten finden Sie in den FAQ zu dieser Initiative ).

    Analytics nicht aktiviert

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

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

    Suchen Sie nach einem Kotlin-spezifischen Bibliotheksmodul? Ab Oktober 2023 (Firebase BoM 32.5.0) können sich sowohl Kotlin- als auch Java-Entwickler auf das Hauptbibliotheksmodul verlassen (Einzelheiten finden Sie in den FAQ 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 Gradle-Dateien.

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.

    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:

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.

Dienstleistung oder Produkt Gradle-Abhängigkeit Neueste
Ausführung
Analytics hinzufügen?
Firebase Android Stückliste
(Stückliste)
com.google.firebase:firebase-bom

Die neueste Firebase-BoM-Version enthält die neuesten Versionen jeder Firebase-Android-Bibliothek. Um zu erfahren, welche Bibliotheksversionen einer bestimmten Stücklistenversion zugeordnet sind, lesen Sie die Versionshinweise für diese Stücklistenversion.

32.6.0
AdMob com.google.android.gms:play-services-ads 22.5.0
Analytik com.google.firebase:firebase-analytics 21.5.0
Benutzerdefinierter App-Check-Anbieter com.google.firebase:firebase-appcheck 17.1.1
App Check-Debug-Anbieter com.google.firebase:firebase-appcheck-debug 17.1.1
App Check Play Integrity-Anbieter com.google.firebase:firebase-appcheck-playintegrity 17.1.1
App-Verteilung com.google.firebase:firebase-appdistribution 16.0.0-beta11
App-Verteilungs-API com.google.firebase:firebase-appdistribution-api 16.0.0-beta11
App-Verteilungs-Plugin com.google.firebase:firebase-appdistribution-gradle 4.0.1
Authentifizierung com.google.firebase:firebase-auth 22.3.0
Cloud Firestore com.google.firebase:firebase-firestore 24.9.1
Cloud Functions für Firebase Client SDK com.google.firebase:firebase-functions 20.4.0
Cloud-Messaging com.google.firebase:firebase-messaging 23.3.1
Cloud-Speicher com.google.firebase:firebase-storage 20.3.0
Crashlytics com.google.firebase:firebase-crashlytics 18.6.0
Crashlytics NDK com.google.firebase:firebase-crashlytics-ndk 18.6.0
Crashlytics-Plugin com.google.firebase:firebase-crashlytics-gradle 2.9.9
Unterstützung für dynamische Funktionsmodule com.google.firebase:firebase-dynamic-module-support 16.0.0-beta03
Dynamische Links com.google.firebase:firebase-dynamic-links 21.2.0
In-App-Nachrichten com.google.firebase:firebase-inappmessaging 20.4.0
(erforderlich)
In-App-Messaging-Anzeige com.google.firebase:firebase-inappmessaging-display 20.4.0
(erforderlich)
Firebase-Installationen com.google.firebase:firebase-installations 17.2.0
Firebase ML-Modell-Downloader-API com.google.firebase:firebase-ml-modeldownloader 24.2.1
Leistungsüberwachung com.google.firebase:firebase-perf 20.5.1
Plugin zur Leistungsüberwachung com.google.firebase:perf-plugin 1.4.2
Echtzeitdatenbank com.google.firebase:firebase-database 20.3.0
Remote-Konfiguration com.google.firebase:firebase-config 21.6.0
Plugin für Google Play-Dienste com.google.gms:google-services 4.4.0
VERALTETE BIBLIOTHEKEN
App Check SafetyNet-Anbieter com.google.firebase:firebase-appcheck-safetynet 16.1.2
App-Indexierung com.google.firebase:firebase-appindexing 20.0.0

Firebase KTX-Module

Analytik com.google.firebase:firebase-analytics-ktx 21.5.0
Benutzerdefinierter App-Check-Anbieter com.google.firebase:firebase-appcheck-ktx 17.1.1
App-Verteilungs-API com.google.firebase:firebase-appdistribution-api-ktx 16.0.0-beta11
Authentifizierung com.google.firebase:firebase-auth-ktx 22.3.0
Cloud Firestore com.google.firebase:firebase-firestore-ktx 24.9.1
Cloud Functions für Firebase Client SDK com.google.firebase:firebase-functions-ktx 20.4.0
Cloud-Messaging com.google.firebase:firebase-messaging-ktx 23.3.1
Cloud-Speicher com.google.firebase:firebase-storage-ktx 20.3.0
Crashlytics com.google.firebase:firebase-crashlytics-ktx 18.6.0
Dynamische Links com.google.firebase:firebase-dynamic-links-ktx 21.2.0
In-App-Nachrichten com.google.firebase:firebase-inappmessaging-ktx 20.4.0
(erforderlich)
In-App-Messaging-Anzeige com.google.firebase:firebase-inappmessaging-display-ktx 20.4.0
(erforderlich)
Firebase-Installationen com.google.firebase:firebase-installations-ktx 17.2.0
Firebase ML-Modell-Downloader-API com.google.firebase:firebase-ml-modeldownloader-ktx 24.2.1
Leistungsüberwachung com.google.firebase:firebase-perf-ktx 20.5.1
Echtzeitdatenbank com.google.firebase:firebase-database-ktx 20.3.0
Remote-Konfiguration com.google.firebase:firebase-config-ktx 21.6.0

Firebase ML Kit-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-object-detection-model 19.0.6
Firebase ML: Gesichtserkennungsmodell 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: 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: Smart Reply-Modell com.google.firebase:firebase-ml-natural-Language-Smart-Reply-Model 20.0.8



Nächste Schritte

Fügen Sie Ihrer App Firebase-Dienste hinzu:

Erfahren Sie mehr über Firebase: