Testnachricht an eine App im Hintergrund senden

Um mit FCM zu beginnen, erstellen Sie den einfachsten Anwendungsfall: Senden Sie eine Testbenachrichtigung vom Benachrichtigungs-Composer an ein Entwicklungsgerät, während die App auf dem Gerät im Hintergrund ausgeführt wird. Auf dieser Seite sind alle dazu erforderlichen Schritte aufgeführt – von der Einrichtung bis zur Bestätigung die Schritte umfassen, die Sie bereits durchgeführt haben, eine Android-Client-App eingerichtet haben, für FCM.

SDK einrichten

In diesem Abschnitt werden Aufgaben beschrieben, die Sie möglicherweise bereits erledigt haben, wenn Sie bereits andere Firebase-Funktionen für Ihre App aktiviert haben.

Hinweis

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

  • Stellen Sie sicher, dass Ihr Projekt diese Anforderungen erfüllt (beachten Sie, dass einige Produkte möglicherweise strengere Anforderungen):

    • Ausrichtung auf API-Level 21 (Lollipop) oder höher
    • Android 5.0 oder höher verwendet
    • Verwendungen Jetpack (AndroidX) Dazu gehört die Erfüllung der folgenden Versionsanforderungen:
      • com.android.tools.build:gradle Version 7.3.0 oder höher
      • compileSdkVersion 28 oder später

  • Richten Sie ein physisches Gerät ein oder verwenden Sie einen Emulator, um Ihre App auszuführen.
    Für Firebase SDKs mit Abhängigkeit von Google Play-Diensten müssen auf dem Gerät oder Emulator Google Play-Dienste installiert sein.

  • Melden Sie sich mit Ihrem Google-Konto in Firebase an.

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

Firebase-Projekt erstellen

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 Weitere Informationen zu Firebase-Projekten Firebase-Projekte

App bei Firebase registrieren

Wenn Sie Firebase in Ihrer Android-App verwenden möchten, müssen Sie Ihre App in Ihrem Firebase-Projekt registrieren. Das Registrieren Ihrer App wird oft als „Hinzufügen“ bezeichnet. App zu Ihrem Projekt arbeiten.

  1. Rufen Sie die Firebase Console auf.

  2. Klicken Sie in der Mitte der Projektübersicht auf das Symbol Android () oder 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-Alias und SHA-1-Wert des Signaturzertifikats für die Fehlerbehebung.

  5. Klicken Sie auf App registrieren.

Firebase-Konfigurationsdatei hinzufügen

  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 die Firebase Android-Datei herunterzuladen. Konfigurationsdatei.

    2. Verschieben Sie Ihre Konfigurationsdatei in das Modul (auf App-Ebene)-Stammverzeichnis von für Ihre App.

  2. Wenn Sie die Werte in Ihrer google-services.json-Konfigurationsdatei für Firebase SDKs verfügbar machen möchten, benötigen Sie das Gradle-Plug-in für Google-Dienste (google-services).

    1. In der Gradle-Datei auf Stammebene (Projektebene) (<project>/build.gradle.kts oder <project>/build.gradle), fügen Sie den Google-Dienste-Plug-in als Abhängigkeit:

      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.2" 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.2' apply false
}

    2. In der Gradle-Datei des Moduls (auf App-Ebene) (normalerweise <project>/<app-module>/build.gradle.kts oder <project>/<app-module>/build.gradle) Fügen Sie das Plug-in für Google-Dienste 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'
  // ...
}

Firebase SDKs zu Ihrer App hinzufügen

  1. Fügen Sie in der Gradle-Datei des Moduls (auf Anwendungsebene) (in der Regel <project>/<app-module>/build.gradle.kts oder <project>/<app-module>/build.gradle) die Abhängigkeit für die Firebase Cloud Messaging-Bibliothek für Android hinzu. Wir empfehlen die Verwendung des Firebase Android BoM um die Versionsverwaltung der Bibliothek zu steuern.

    Für eine optimale Nutzung von Firebase Cloud Messaging empfehlen wir Google Analytics wird aktiviert in Ihrem Firebase-Projekt und fügen Ihrer App das Firebase SDK für Google Analytics hinzu. 

    dependencies {
    // Import the BoM for the Firebase platform
    implementation(platform("com.google.firebase:firebase-bom:33.4.0"))

    // Add the dependencies for the Firebase Cloud Messaging and Analytics libraries
    // When using the BoM, you don't specify versions in Firebase library dependencies
    implementation("com.google.firebase:firebase-messaging")
    implementation("com.google.firebase:firebase-analytics")
}

    Mit dem Firebase Android BoM Ihre App verwendet immer kompatible Versionen der Firebase Android Libraries.

    Alternative: Firebase-Bibliotheksabhängigkeiten ohne BoM hinzufügen

    Wenn Sie Firebase BoM nicht verwenden, müssen Sie jede Firebase-Bibliotheksversion angeben in der Abhängigkeitszeile ein.

    Wenn Sie in Ihrer App mehrere Firebase-Bibliotheken verwenden, empfehlen, Bibliotheksversionen mit der BoM zu verwalten. Dadurch wird sichergestellt, dass alle Versionen kompatibel. 

    dependencies {
    // Add the dependencies for the Firebase Cloud Messaging and Analytics libraries
    // When NOT using the BoM, you must specify versions in Firebase library dependencies
    implementation("com.google.firebase:firebase-messaging:24.0.2")
    implementation("com.google.firebase:firebase-analytics:22.1.2")
}
         Sie suchen nach einem Kotlin-spezifischen Bibliotheksmodul? Beginnt in Oktober 2023 (Firebase BoM 32.5.0) können sowohl Kotlin- als auch Java-Entwickler sind vom Modul der Hauptbibliothek abhängig (Details finden Sie in der FAQs zu dieser Initiative).

  2. Synchronisieren Sie Ihr Android-Projekt mit Gradle-Dateien.

Auf Registrierungstoken zugreifen

Wenn Sie eine Nachricht an ein bestimmtes Gerät senden möchten, benötigen Sie das Registrierungstoken dieses Geräts. Da Sie das Token in ein Feld in der Benachrichtigungskonsole eingeben müssen, um diese Anleitung abzuschließen, sollten Sie es kopieren oder sicher speichern, nachdem Sie es abgerufen haben.

Beim ersten Starten Ihrer App generiert das FCM SDK ein Registrierungstoken für die Client-App-Instanz. Wenn Sie eine Ausrichtung auf einzelne Geräte oder Gerätegruppen zu erstellen, müssen Sie auf dieses Token zugreifen, indem Sie FirebaseMessagingService und überschreibt onNewToken.

In diesem Abschnitt wird beschrieben, wie Sie das Token abrufen und Änderungen überwachen. in das Token ein. Da das Token nach dem ersten Start rotiert werden kann, empfehlen wir Ihnen dringend, das aktuellste aktualisierte Registrierungstoken abzurufen.

Das Registrierungstoken kann sich in folgenden Fällen ändern:

  • Die App wird auf einem neuen Gerät wiederhergestellt
  • Der Nutzer deinstalliert die App und installiert sie neu.
  • Der Nutzer löscht die App-Daten.

Aktuelles Registrierungstoken abrufen

Wenn Sie das aktuelle Token abrufen möchten, rufen Sie FirebaseMessaging.getInstance().getToken() auf:

Kotlin+KTX

FirebaseMessaging.getInstance().token.addOnCompleteListener(OnCompleteListener { task ->
    if (!task.isSuccessful) {
        Log.w(TAG, "Fetching FCM registration token failed", task.exception)
        return@OnCompleteListener
    }

    // Get new FCM registration token
    val token = task.result

    // Log and toast
    val msg = getString(R.string.msg_token_fmt, token)
    Log.d(TAG, msg)
    Toast.makeText(baseContext, msg, Toast.LENGTH_SHORT).show()
})

Java

FirebaseMessaging.getInstance().getToken()
    .addOnCompleteListener(new OnCompleteListener<String>() {
        @Override
        public void onComplete(@NonNull Task<String> task) {
          if (!task.isSuccessful()) {
            Log.w(TAG, "Fetching FCM registration token failed", task.getException());
            return;
          }

          // Get new FCM registration token
          String token = task.getResult();

          // Log and toast
          String msg = getString(R.string.msg_token_fmt, token);
          Log.d(TAG, msg);
          Toast.makeText(MainActivity.this, msg, Toast.LENGTH_SHORT).show();
        }
    });

Tokengenerierung überwachen

Der onNewToken-Callback wird immer dann ausgelöst, wenn ein neues Token generiert wird.

Kotlin+KTX

/**
 * Called if the FCM registration token is updated. This may occur if the security of
 * the previous token had been compromised. Note that this is called when the
 * FCM registration token is initially generated so this is where you would retrieve the token.
 */
override fun onNewToken(token: String) {
    Log.d(TAG, "Refreshed token: $token")

    // If you want to send messages to this application instance or
    // manage this apps subscriptions on the server side, send the
    // FCM registration token to your app server.
    sendRegistrationToServer(token)
}
MyFirebaseMessagingService.kt

Java

/**
 * There are two scenarios when onNewToken is called:
 * 1) When a new token is generated on initial app startup
 * 2) Whenever an existing token is changed
 * Under #2, there are three scenarios when the existing token is changed:
 * A) App is restored to a new device
 * B) User uninstalls/reinstalls the app
 * C) User clears app data
 */
@Override
public void onNewToken(@NonNull String token) {
    Log.d(TAG, "Refreshed token: " + token);

    // If you want to send messages to this application instance or
    // manage this apps subscriptions on the server side, send the
    // FCM registration token to your app server.
    sendRegistrationToServer(token);
}
MyFirebaseMessagingService.java

Nachdem du das Token erhalten hast, kannst du es an deinen App-Server senden und mit deiner bevorzugten Methode speichern.

Testbenachrichtigung senden

  1. Installieren Sie die App auf dem Zielgerät und führen Sie sie aus. Auf Apple-Geräten benötigen Sie , um die Berechtigungsanfrage für den Empfang von Remote-Benachrichtigungen zu akzeptieren.

  2. Die App muss auf dem Gerät im Hintergrund ausgeführt werden.

  3. Öffnen Sie in der Firebase-Konsole die Seite Messaging.

  4. Wenn dies Ihre erste Mitteilung ist, wählen Sie Erste Kampagne erstellen aus.

    1. Wählen Sie Firebase-Benachrichtigungsnachrichten und dann Erstellen aus.

  5. Wählen Sie andernfalls auf dem Tab Kampagnen die Option Neue Kampagne und dann Benachrichtigungen aus.

  6. Geben Sie den Nachrichtentext ein. Alle anderen sind optional.

  7. Wählen Sie im rechten Bereich Testnachricht senden aus.

  8. Geben Sie in das Feld FCM-Registrierungstoken hinzufügen das Registrierungstoken ein, das Sie in einem vorherigen Abschnitt dieser Anleitung erhalten haben.

  9. Wählen Sie Testen aus.

Nachdem Sie Testen ausgewählt haben, sollte das Zielclientgerät (mit der App im Hintergrund) die Benachrichtigung erhalten.

Informationen zur Nachrichtenzustellung an Ihre App finden Sie unter die FCM-Berichts-Dashboard, das die Anzahl der Nachrichten, die auf Apple- und Android-Geräten gesendet und geöffnet wurden, Daten für „Impressionen“ (für Nutzer angezeigte Benachrichtigungen) für Android-Apps.

Nächste Schritte

Nachrichten an Apps im Vordergrund senden

Wenn Sie erfolgreich Benachrichtigungen gesendet haben, während Ihre App installiert ist im Hintergrund, siehe Nachrichten in einer Android-App empfangen um mit dem Senden an Apps im Vordergrund zu beginnen.

Mehr als nur Benachrichtigungen

Wenn Sie Ihrer App nicht nur Benachrichtigungen hinzufügen, sondern auch andere, erweiterte Funktionen, finden Sie hier weitere Informationen: