Check out what’s new from Firebase@ Google I/O 2021, and join our alpha program for early access to the new Remote Config personalization feature. Learn more

Firebase zu Ihrem Android-Projekt hinzufügen

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 16 (Jelly Bean) oder höher
    • Verwendet Gradle 4.1 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 die 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 Einrichtungsworkflow der Firebase-Konsole.
  • Option 2 : Verwenden Sie den Android Studio Firebase Assistant (erfordert möglicherweise zusätzliche Konfiguration).



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

Das Hinzufügen von Firebase zu Ihrer App umfasst Aufgaben sowohl in der Firebase-Konsole als auch in Ihrem geöffneten Android-Projekt (beispielsweise laden Sie 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 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. Rufen Sie die Firebase-Konsole auf .

  2. Klicken Sie in der Mitte der das Android- Symbol ( ) oder auf App , 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 : Hinzufügen einer Firebase-Konfigurationsdatei

  1. Fügen Sie Ihrer App die Firebase Android-Konfigurationsdatei hinzu:

    1. Klicken Sie auf google-services.json herunterladen , um Ihre Firebase Android-Konfigurationsdatei ( google-services.json ) abzurufen.

    2. Verschieben Sie Ihre Konfigurationsdatei in das Modulverzeichnis (App-Ebene) Ihrer App.

  2. Um Firebase-Produkte in Ihrer App zu aktivieren, fügen Sie das Google-Services-Plug-in zu Ihren Gradle-Dateien hinzu.

    1. build.gradle in Ihrer Gradle-Datei auf build.gradle (Projektebene) ( build.gradle ) Regeln hinzu, um das Gradle- build.gradle in 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.8'  // Google Services plugin
        }
      }
      
      allprojects {
        // ...
      
        repositories {
          // Check that you have the following line (if not, add it):
          google()  // Google's Maven repository
          // ...
        }
      }
      
    2. app/build.gradle Gradle-Datei Ihres Moduls (App-Ebene) (normalerweise app/build.gradle ) das Google Services-Gradle-Plug-in an:

      apply plugin: 'com.android.application'
      // Add the following line:
      apply plugin: 'com.google.gms.google-services'  // Google Services plugin
      
      android {
        // ...
      }
      

Schritt 4 : Firebase SDKs zu Ihrer App hinzufügen

  1. 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:28.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:28.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'
    }
    

    Wenn Sie Firebase Android BoM verwenden , 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:28.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:28.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'
    }
    

    Wenn Sie Firebase Android BoM verwenden , verwendet Ihre App immer kompatible Versionen der Firebase Android-Bibliotheken.

  2. Synchronisieren Sie Ihre App, um sicherzustellen, dass alle Abhängigkeiten über die erforderlichen Versionen verfügen.

Das ist es! Sie können die empfohlenen nächsten Schritte überspringen.

Wenn Sie jedoch Probleme mit der Einrichtung haben, besuchen Sie die Android-Fehlerbehebung und häufig gestellte Fragen .



Option 2 : Firebase mithilfe des Firebase-Assistenten hinzufügen

Der Firebase Assistant 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!

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

    • Windows / Linux: Hilfe > Nach Updates suchen
    • macOS: Android Studio > Nach Updates suchen
  2. Öffnen Sie den Firebase-Assistenten: Tools > Firebase .

  3. Wählen Sie im Assistentenbereich ein Firebase-Produkt aus, das Sie Ihrer App hinzufügen möchten. Erweitern Sie den entsprechenden 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 über die erforderlichen Versionen verfügen.

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

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

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

Wenn Sie jedoch Probleme mit der Einrichtung haben, besuchen Sie die Android-Fehlerbehebung und häufig gestellte Fragen .



Verfügbare Bibliotheken

In diesem Abschnitt werden die für Android unterstützten Firebase-Produkte und ihre Gradle-Abhängigkeiten aufgelistet. Weitere Informationen zu diesen 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 Stücklistenversion zugeordnet sind, lesen Sie die Versionshinweise für diese Stücklistenversion.

28.1.0
AdMob com.google.android.gms:play-services-ads 20.2.0
Analytik com.google.firebase:firebase-analytics 19.0.0
App-Verteilungs-Plugin com.google.firebase:firebase-appdistribution-gradle 2.1.2
App-Indexierung com.google.firebase:firebase-appindexing 20.0.0
Authentifizierung com.google.firebase:firebase-auth 21.0.1
Cloud Firestore com.google.firebase:firebase-firestore 23.0.1
Cloud Functions for Firebase Client SDK com.google.firebase:firebase-Funktionen 20.0.0
Cloud-Messaging com.google.firebase:firebase-messaging 22.0.0
Cloud-Speicher com.google.firebase:firebase-storage 20.0.0
Crashlytics com.google.firebase:firebase-crashlytics 18.0.1
Crashlytics NDK com.google.firebase:firebase-crashlytics-ndk 18.0.1
Crashlytics-Plugin com.google.firebase:firebase-crashlytics-gradle 2.7.0
Unterstützung für dynamische Funktionsmodule com.google.firebase:firebase-dynamic-module-support 16.0.0-beta01
Dynamische Links com.google.firebase:firebase-dynamic-links 20.1.0
In-App-Messaging com.google.firebase:firebase-inappmessaging 20.0.0
(erforderlich)
In-App-Messaging-Anzeige com.google.firebase:firebase-inappmessaging-display 20.0.0
(erforderlich)
Firebase-Installationen com.google.firebase:firebase-installationen 17.0.0
Firebase ML-Modell-Downloader-API com.google.firebase:firebase-ml-modeldownloader 24.0.0
Leistungsüberwachung com.google.firebase:firebase-perf 20.0.1
Leistungsüberwachungs-Plugin com.google.firebase:perf-plugin 1.4.0
Echtzeit-Datenbank com.google.firebase:firebase-datenbank 20.0.0
Remote-Konfiguration com.google.firebase:firebase-config 21.0.0
Plug-in für Google Play-Dienste com.google.gms:google-services 4.3.8
Veraltete Bibliotheken
APIs für benutzerdefinierte Firebase ML-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: Modell zur Bildbeschriftung 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-Scan-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: APIs für natürliche Sprache com.google.firebase:firebase-ml-natural-language 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 Stücklistenversion zugeordnet sind, lesen Sie die Versionshinweise für diese Stücklistenversion.

28.1.0
AdMob com.google.android.gms:play-services-ads 20.2.0
Analytik com.google.firebase:firebase-analytics-ktx 19.0.0
App-Verteilungs-Plugin com.google.firebase:firebase-appdistribution-gradle 2.1.2
App-Indexierung com.google.firebase:firebase-appindexing 20.0.0
Authentifizierung com.google.firebase:firebase-auth-ktx 21.0.1
Cloud Firestore com.google.firebase:firebase-firestore-ktx 23.0.1
Cloud Functions for Firebase Client SDK com.google.firebase:firebase-functions-ktx 20.0.0
Cloud-Messaging com.google.firebase:firebase-messaging-ktx 22.0.0
Cloud-Speicher com.google.firebase:firebase-storage-ktx 20.0.0
Crashlytics com.google.firebase:firebase-crashlytics-ktx 18.0.1
Crashlytics NDK com.google.firebase:firebase-crashlytics-ndk 18.0.1
Crashlytics-Plugin com.google.firebase:firebase-crashlytics-gradle 2.7.0
Unterstützung für dynamische Funktionsmodule com.google.firebase:firebase-dynamic-module-support 16.0.0-beta01
Dynamische Links com.google.firebase:firebase-dynamic-links-ktx 20.1.0
In-App-Messaging com.google.firebase:firebase-inappmessaging-ktx 20.0.0
(erforderlich)
In-App-Messaging-Anzeige com.google.firebase:firebase-inappmessaging-display-ktx 20.0.0
(erforderlich)
Firebase-Installationen com.google.firebase:firebase-installations-ktx 17.0.0
Firebase ML-Modell-Downloader-API com.google.firebase:firebase-ml-modeldownloader-ktx 24.0.0
Leistungsüberwachung com.google.firebase:firebase-perf-ktx 20.0.1
Leistungsüberwachungs-Plugin com.google.firebase:perf-plugin 1.4.0
Echtzeit-Datenbank com.google.firebase:firebase-database-ktx 20.0.0
Remote-Konfiguration com.google.firebase:firebase-config-ktx 21.0.0
Plug-in für Google Play-Dienste com.google.gms:google-services 4.3.8
Veraltete Bibliotheken
APIs für benutzerdefinierte Firebase ML-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: Modell zur Bildbeschriftung 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-Scan-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: APIs für natürliche Sprache com.google.firebase:firebase-ml-natural-language 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:

Weitere Informationen zu Firebase: