欢迎参加我们将于 2022 年 10 月 18 日举办的 Firebase 峰会(线上线下同时进行),了解 Firebase 如何帮助您加快应用开发速度、满怀信心地发布应用并在之后需要时轻松地扩大应用规模。立即报名

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-Ebene 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 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-Assistenten (möglicherweise ist eine zusätzliche Konfiguration erforderlich).



Option 1 : Fügen Sie Firebase mithilfe der 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 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 zu verwenden, 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 Setup-Workflow 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 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 Download google-services.json , um Ihre Firebase-Android-Konfigurationsdatei abzurufen.

    2. Verschieben Sie Ihre Konfigurationsdatei in das Stammverzeichnis des Moduls (auf 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-Plug-in für Google-Dienste ( google-services ).

    1. Fügen Sie in Ihrer Gradle -Datei auf Stammebene (Projektebene) ( <project>/build.gradle ) das Plug-in für Google-Dienste als Buildscript-Abhängigkeit hinzu:

      buildscript {
      
          repositories {
            // Make sure that you have the following two repositories
            google()  // Google's Maven repository
            mavenCentral()  // Maven Central repository
          }
      
          dependencies {
            ...
      
            // Add the dependency for the Google services Gradle plugin
            classpath 'com.google.gms:google-services:4.3.14'
          }
      }
      
      allprojects {
        ...
      
        repositories {
          // Make sure that you have the following two repositories
          google()  // Google's Maven repository
          mavenCentral()  // Maven Central repository
        }
      }
      
    2. Fügen Sie in Ihrer Modul-Gradle-Datei (auf App-Ebene) (normalerweise <project>/<app-module>/build.gradle ) das Plug-in für Google-Dienste hinzu:

      plugins {
          id 'com.android.application'
      
          // Add the Google services Gradle plugin
          id 'com.google.gms.google-services'
          ...
      }
      

Schritt 4 : Fügen Sie Firebase SDKs zu Ihrer App hinzu

  1. Fügen Sie in Ihrer Modul-Gradle-Datei (auf App-Ebene) (normalerweise <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

    Java

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

    Kotlin+KTX

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

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

    Analytics nicht aktiviert

    Java

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

    Kotlin+KTX

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

    Durch die Verwendung der Firebase Android BoM verwendet Ihre App immer kompatible Versionen von 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.

Das ist es! Sie können direkt zu den empfohlenen nächsten Schritten springen .

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



Option 2 : Fügen Sie Firebase mit dem Firebase-Assistenten hinzu

Der Firebase-Assistent registriert Ihre App bei einem Firebase-Projekt und fügt die erforderlichen Firebase-Dateien, Plugins und Abhängigkeiten zu Ihrem Android-Projekt hinzu – alles aus Android Studio heraus!

  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-Assistenten 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 > 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 die erforderlichen Versionen haben.

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

  6. Fügen Sie über den Firebase-Assistenten so viele andere Firebase-Produkte hinzu, wie Sie möchten!

Das ist es! Sehen 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 build.gradle .

Java

Dienstleistung 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. Um zu erfahren, welche Bibliotheksversionen einer bestimmten BoM-Version zugeordnet sind, lesen Sie die Versionshinweise für diese BoM-Version.

30.5.0
AdMob com.google.android.gms:play-services-ads 21.2.0
Analytik com.google.firebase:firebase-analytics 21.1.1
App Check benutzerdefinierter Anbieter com.google.firebase:firebase-appcheck 16.0.2
App Check Debug-Anbieter com.google.firebase:firebase-appcheck-debug 16.0.2
App Check Play-Integritätsanbieter com.google.firebase:firebase-appcheck-playintegrity 16.0.2
App Überprüfen Sie den SafetyNet-Anbieter com.google.firebase:firebase-appcheck-safetynet 16.0.2
App-Verteilung com.google.firebase:firebase-appdistribution 16.0.0-beta04
App-Verteilungs-API com.google.firebase:firebase-appdistribution-api 16.0.0-beta04
App-Distribution-Plugin com.google.firebase:firebase-appdistribution-gradle 3.0.3
Authentifizierung com.google.firebase:firebase-auth 21.0.8
Cloud-Firestore com.google.firebase:firebase-firestore 24.3.1
Cloud-Funktionen für das Firebase-Client-SDK com.google.firebase:firebase-Funktionen 20.1.1
Cloud-Messaging com.google.firebase:firebase-messaging 23.0.8
Cloud-Speicher com.google.firebase:firebase-storage 20.0.2
Crashlytics com.google.firebase:firebase-crashlytics 18.2.13
Crashlytics NDK com.google.firebase:firebase-crashlytics-ndk 18.2.13
Crashlytics-Plugin com.google.firebase:firebase-crashlytics-gradle 2.9.2
Unterstützung für dynamische Feature-Module com.google.firebase:firebase-dynamic-module-support 16.0.0-beta03
Dynamische Links com.google.firebase:firebase-dynamische-links 21.0.2
In-App-Messaging com.google.firebase:firebase-inappmessaging 20.1.3
(erforderlich)
In-App-Nachrichtenanzeige com.google.firebase:firebase-inappmessaging-display 20.1.3
(erforderlich)
Firebase-Installationen com.google.firebase:firebase-installations 17.0.3
Firebase ML-Modell-Downloader-API com.google.firebase:firebase-ml-modeldownloader 24.0.5
Leistungsüberwachung com.google.firebase:firebase-perf 20.1.1
Leistungsüberwachungs-Plugin com.google.firebase:perf-plugin 1.4.1
Echtzeit-Datenbank com.google.firebase:Firebase-Datenbank 20.0.6
Remote-Konfig com.google.firebase:firebase-config 21.1.2
Plug-in für Google Play-Dienste com.google.gms:google-services 4.3.14
Veraltete Bibliotheken
App-Indizierung com.google.firebase:firebase-appindexing 20.0.0
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: Bildkennzeichnungsmodell com.google.firebase:firebase-ml-vision-image-label-model 20.0.2
Firebase ML: Modell zur Objekterkennung und -verfolgung 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-Scanning-Modell 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: Natürliche Sprach-APIs com.google.firebase:firebase-ml-natürliche-sprache 22.0.1
Firebase ML: Spracherkennungsmodell 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

Dienstleistung 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. Um zu erfahren, welche Bibliotheksversionen einer bestimmten BoM-Version zugeordnet sind, lesen Sie die Versionshinweise für diese BoM-Version.

30.5.0
AdMob com.google.android.gms:play-services-ads 21.2.0
Analytik com.google.firebase:firebase-analytics-ktx 21.1.1
App Check benutzerdefinierter Anbieter com.google.firebase:firebase-appcheck-ktx 16.0.2
App Check Debug-Anbieter com.google.firebase:firebase-appcheck-debug 16.0.2
App Überprüfen Sie den SafetyNet-Anbieter com.google.firebase:firebase-appcheck-safetynet 16.0.2
App-Verteilungs-API com.google.firebase:firebase-appdistribution-api-ktx 16.0.0-beta04
App-Distribution-Plugin com.google.firebase:firebase-appdistribution-gradle 3.0.3
Authentifizierung com.google.firebase:firebase-auth-ktx 21.0.8
Cloud-Firestore com.google.firebase:firebase-firestore-ktx 24.3.1
Cloud-Funktionen für das Firebase-Client-SDK com.google.firebase:firebase-functions-ktx 20.1.1
Cloud-Messaging com.google.firebase:firebase-messaging-ktx 23.0.8
Cloud-Speicher com.google.firebase:firebase-storage-ktx 20.0.2
Crashlytics com.google.firebase:firebase-crashlytics-ktx 18.2.13
Crashlytics NDK com.google.firebase:firebase-crashlytics-ndk 18.2.13
Crashlytics-Plugin com.google.firebase:firebase-crashlytics-gradle 2.9.2
Unterstützung für dynamische Feature-Module com.google.firebase:firebase-dynamic-module-support 16.0.0-beta03
Dynamische Links com.google.firebase:firebase-dynamische-links-ktx 21.0.2
In-App-Messaging com.google.firebase:firebase-inappmessaging-ktx 20.1.3
(erforderlich)
In-App-Nachrichtenanzeige com.google.firebase:firebase-inappmessaging-display-ktx 20.1.3
(erforderlich)
Firebase-Installationen com.google.firebase:firebase-installations-ktx 17.0.3
Firebase ML-Modell-Downloader-API com.google.firebase:firebase-ml-modeldownloader-ktx 24.0.5
Leistungsüberwachung com.google.firebase:firebase-perf-ktx 20.1.1
Leistungsüberwachungs-Plugin com.google.firebase:perf-plugin 1.4.1
Echtzeit-Datenbank com.google.firebase:firebase-database-ktx 20.0.6
Remote-Konfig com.google.firebase:firebase-config-ktx 21.1.2
Plug-in für Google Play-Dienste com.google.gms:google-services 4.3.14
Veraltete Bibliotheken
App-Indizierung com.google.firebase:firebase-appindexing 20.0.0
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: Bildkennzeichnungsmodell com.google.firebase:firebase-ml-vision-image-label-model 20.0.2
Firebase ML: Modell zur Objekterkennung und -verfolgung 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-Scanning-Modell 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: Natürliche Sprach-APIs com.google.firebase:firebase-ml-natürliche-sprache 22.0.1
Firebase ML: Spracherkennungsmodell 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:

Erfahren Sie mehr über Firebase: