FCM und FIAM verwenden, um Nachrichten an Nutzer zu senden

1. Hinweis

In diesem Codelab erfahren Sie, wie Sie die Möglichkeit hinzufügen, mit Nutzern zu interagieren, unabhängig davon, ob sie Ihre App im Vordergrund oder im Hintergrund verwenden.

Voraussetzungen

Keine

Lerninhalte

• Firebase zu Ihrer Android-App hinzufügen
• FCM- und FIAM-Abhängigkeiten hinzufügen
• FCM-Testnachricht an Ihre App senden
• Test-FIAM-Nachricht an Ihre App senden

Voraussetzungen

• Android Studio 4.1
• Android-Gerät oder -Emulator

2. Jetzt starten

Beispielcode abrufen

Klonen Sie das GitHub-Repository über die Befehlszeile:

Start-App importieren

Wählen Sie in Android Studio das Verzeichnis codelab-fcm-and-fiam aus ( ). Es ist das Verzeichnis, das im vorherigen Schritt geklont wurde (File > Open > .../codelab-fcm-and-fiam).

Das Projekt „FcmAndFiam“ sollte jetzt in Android Studio geöffnet sein. Wenn Sie eine Warnung sehen, dass eine google-services.json-Datei fehlt, ist das kein Problem. Sie wird im nächsten Schritt hinzugefügt.

3. Firebase-Projekt und App für die Verwendung von Firebase einrichten

Firebase-Projekt erstellen

1. Melden Sie sich mit Ihrem Google-Konto in der Firebase Console an.
2. Klicken Sie auf die Schaltfläche zum Erstellen eines neuen Projekts und geben Sie einen Projektnamen ein (z. B. Send messages codelab).
3. Klicken Sie auf Weiter.
4. Lesen und akzeptieren Sie bei Aufforderung die Firebase-Nutzungsbedingungen und klicken Sie dann auf Weiter.
5. (Optional) Aktivieren Sie die KI-Unterstützung in der Firebase Console (als „Gemini in Firebase“ bezeichnet).
6. Für dieses Codelab benötigen Sie Google Analytics, um Firebase-Produkte optimal nutzen zu können. Lassen Sie die Ein/Aus-Schaltfläche für die Google Analytics-Option also aktiviert. Folgen Sie der Anleitung auf dem Bildschirm, um Google Analytics einzurichten.
7. Klicken Sie auf Projekt erstellen, warten Sie, bis Ihr Projekt bereitgestellt wurde, und klicken Sie dann auf Weiter.

Firebase zu Ihrer Anwendung hinzufügen

1. Klicken Sie auf dem Übersichtsbildschirm Ihres neuen Projekts auf das Android-Symbol, um den Einrichtungsworkflow zu starten.
2. Geben Sie den Paketnamen des Codelabs ein: com.google.firebase.codelab.fcmandfiam
3. Klicken Sie nach dem Hinzufügen des Paketnamens auf App registrieren und google-services.json herunterladen, um Ihre Firebase-Konfigurationsdatei für Android zu erhalten. Kopieren Sie dann die Datei „google-services.json“ in das Verzeichnis app in Ihrem Projekt. Nachdem die Datei heruntergeladen wurde, können Sie für die nächsten Schritte, die in der Konsole angezeigt werden, auf Überspringen klicken. Sie wurden bereits für Sie im Projekt „build-android-start“ ausgeführt.
4. Fügen Sie Ihrer App das google-services-Plug-in hinzu.**
   Das google-services-Plug-in verwendet die Datei „google-services.json“, um Ihre Anwendung für die Verwendung von Firebase zu konfigurieren. Die google-services-Plug-in-Abhängigkeit und das Plug-in selbst sollten bereits den Build-Dateien auf Projekt- bzw. App-Ebene hinzugefügt worden sein. Bestätigen Sie die folgenden Einträge:build.gradle

   buildscript {
     ...
     dependencies {
       ...
       classpath 'com.google.gms:google-services:4.3.8'
     }
   }
   

   app/build.gradle

   plugins {
     ...
     id: 'com.google.gms.google-services'
   }
   

Abhängigkeiten hinzufügen

Für FCM und FIAM sind die folgenden Abhängigkeiten erforderlich. Diese Abhängigkeiten sollten bereits der Build-Datei auf App-Ebene hinzugefügt worden sein. Prüfen Sie, ob die folgenden Abhängigkeiten hinzugefügt wurden:

app/build.gradle

dependencies {
  ...
  implementation platform('com.google.firebase:firebase-bom:28.4.2')
  implementation 'com.google.firebase:firebase-analytics'
  implementation 'com.google.firebase:firebase-messaging'
  implementation 'com.google.firebase:firebase-inappmessaging-display'
}

Projekt mit Gradle-Dateien synchronisieren

Damit alle Abhängigkeiten für Ihre App verfügbar sind, sollten Sie Ihr Projekt jetzt mit Gradle-Dateien synchronisieren. Wählen Sie in der Android Studio-Symbolleiste File > Sync Project with Gradle Files aus.

4. Log-IDs

Firebase Cloud Messaging und Firebase In-App Messaging verwenden beide Kennungen, um Nachrichten an Apps zu senden. FCM verwendet ein Registrierungstoken und FIAM eine Installations-ID.

1. Ersetzen Sie in MainActivity.kt den TODO-Kommentar durch den folgenden Code, um die zum Senden von Nachrichten erforderlichen Kennungen zu protokollieren:

FirebaseMessaging.getInstance().token.addOnCompleteListener { regTokenTask ->
   if (regTokenTask.isSuccessful) {
       Log.d(TAG, "FCM registration token: ${regTokenTask.result}")
   } else {
       Log.e(TAG, "Unable to retrieve registration token",
           regTokenTask.exception)
   }
}
FirebaseInstallations.getInstance().id.addOnCompleteListener { installationIdTask ->
   if (installationIdTask.isSuccessful) {
       Log.d(TAG, "Firebase Installations ID: ${installationIdTask.result}")
   } else {
       Log.e(TAG, "Unable to retrieve installations ID",
           installationIdTask.exception)
   }
}

2. Verbinden Sie Ihr Android-Gerät und klicken Sie in der Android Studio-Symbolleiste auf Ausführen ( ). Wenn Sie auf die Schaltfläche Log Identifiers (Kennungen protokollieren) tippen, werden das FCM-Registrierungstoken und die Firebase-Installations-ID in logcat protokolliert. Die Ausgabe sollte in etwa so aussehen:

D/FcmAndFiam: Firebase Installations ID: emMc5...AsJfb
  FCM registration token: emMc5LART6GV7...r0Q

5. FCM-Testnachricht senden

FCM-Nachrichten können sowohl über die Firebase Console als auch über die FCM REST API gesendet werden. In diesem Codelab erstellen wir eine FCM-Benachrichtigung und senden sie an unser Gerät. Benachrichtigungen werden im Benachrichtigungsbereich des Systems angezeigt. So senden Sie eine FCM-Testnachricht:

1. App im Hintergrund ausführen (zum Startbildschirm wechseln)
2. Rufen Sie die Firebase Console auf und wählen Sie in der linken Navigationsleiste Cloud Messaging aus.
3. Wählen Sie Erste Nachricht senden aus.
4. Geben Sie einen Titel und einen Text für die Nachricht ein und klicken Sie dann auf Testnachricht senden.

5. Fügen Sie das FCM-Registrierungstoken hinzu und klicken Sie auf Testen.

6. Benachrichtigung auf dem Display des Geräts beobachten
7. Durch Tippen auf die Benachrichtigung wird die App geöffnet

6. FIAM-Testnachricht senden

Firebase In-App Messaging kann durch eine Vielzahl von Nutzerereignissen ausgelöst werden. Die Testnachricht verwendet das Ereignis „App öffnen“, um die In-App-Nachricht auszulösen. So senden Sie eine Test-FIAM-Nachricht:

1. App im Hintergrund ausführen (zum Startbildschirm wechseln)
2. Rufen Sie die Firebase Console auf und wählen Sie in der linken Navigationsleiste „In-App Messaging“ aus.
3. Wählen Sie Erste Kampagne erstellen aus.
4. Wählen Sie eine Kampagne für das Banner oben aus und geben Sie Titel und Text der Mitteilung ein.
5. Klicken Sie auf Auf Gerät testen.

6. Fügen Sie die Installations-ID hinzu und klicken Sie auf Testen.

7. App wieder öffnen
8. Mitteilung in der App beachten

7. Glückwunsch

Herzlichen Glückwunsch! Sie haben sowohl FCM- als auch FIAM-Nachrichten gesendet. Jetzt wissen Sie, wie Sie mit Ihren Nutzern interagieren können, unabhängig davon, ob sie Ihre App im Vordergrund oder im Hintergrund verwenden.

Weitere Informationen

• Firebase Cloud Messaging-Dokumentation
• Firebase In-App Messaging-Dokumentation

Nächste Schritte

• Nachrichten an Nutzer in Ihrer eigenen Android-App senden

Referenzdokumente

• Firebase Cloud Messaging
• Firebase In-App Messaging