Join us for Firebase Summit on November 10, 2021. Tune in to learn how Firebase can help you accelerate app development, release with confidence, and scale with ease. Register

Nachrichten in einer Android-App empfangen

Firebase-Benachrichtigungen verhalten sich je nach Vordergrund-/Hintergrundstatus der empfangenden App unterschiedlich. Wenn Sie Anwendungen im Vordergrund wollen Benachrichtigung Nachrichten oder Daten - Nachrichten zu empfangen, müssen Sie Code schreiben müssen , die zu handhaben onMessageReceived Rückruf. Eine Erläuterung der Differenz zwischen der Meldung und Datennachrichten finden Sie Nachrichtentypen .

Umgang mit Nachrichten

Um Nachrichten zu erhalten, verwenden Sie einen Service, der sich FirebaseMessagingService . Ihre Dienste sind die außer Kraft setzen onMessageReceived und onDeletedMessages Rückrufe. Es sollte jede Nachricht innerhalb von 20 Sekunden nach Erhalt verarbeiten (10 Sekunden bei Android Marshmallow). Das Zeitfenster kann kürzer sein , je nach Betriebssystem Verzögerungen entstehen vor calling onMessageReceived . Nach dieser Zeit verschiedene OS Verhaltensweisen wie Android O Ausführung im Hintergrund Grenzen können mit Ihrer Fähigkeit stören Ihre Arbeit abzuschließen. Für weitere Informationen siehe unsere Übersicht über die Nachrichtenpriorität .

onMessageReceived ist für die meisten Nachrichtentypen zur Verfügung gestellt, mit folgenden Ausnahmen:

  • Benachrichtigungsmeldungen geliefert , wenn die App im Hintergrund ist. In diesem Fall wird die Benachrichtigung an die Taskleiste des Geräts gesendet. Ein Benutzer, der auf eine Benachrichtigung tippt, öffnet standardmäßig den App-Launcher.

  • Nachrichten mit sowohl Benachrichtigung und Datennutzlast, wenn im Hintergrund erhalten. In diesem Fall wird die Benachrichtigung an die Taskleiste des Geräts gesendet und die Datennutzlast wird in den Extras der Absicht Ihrer Launcher-Aktivität geliefert.

Zusammenfassend:

App-Status Benachrichtigung Daten Beide
Vordergrund onMessageReceived onMessageReceived onMessageReceived
Hintergrund System Tray onMessageReceived Benachrichtigung: Taskleiste
Daten: in Extras der Absicht.
Weitere Informationen zu Nachrichtentypen finden Sie Hinweise und Datennachrichten .

Bearbeiten Sie das App-Manifest

Zur Nutzung FirebaseMessagingService , müssen Sie die folgende in Ihrem App - Manifest hinzuzufügen:

<service
    android:name=".java.MyFirebaseMessagingService"
    android:exported="false">
    <intent-filter>
        <action android:name="com.google.firebase.MESSAGING_EVENT" />
    </intent-filter>
</service>

Außerdem wird empfohlen, Standardwerte festzulegen, um das Erscheinungsbild von Benachrichtigungen anzupassen. Sie können ein benutzerdefiniertes Standardsymbol und eine benutzerdefinierte Standardfarbe angeben, die angewendet werden, wenn keine entsprechenden Werte in der Benachrichtigungsnutzlast festgelegt sind.

Fügen Sie diese Zeilen in der application Tag das benutzerdefinierte Standardsymbol und benutzerdefinierte Farbe festlegen:

<!-- Set custom default icon. This is used when no icon is set for incoming notification messages.
     See README(https://goo.gl/l4GJaQ) for more. -->
<meta-data
    android:name="com.google.firebase.messaging.default_notification_icon"
    android:resource="@drawable/ic_stat_ic_notification" />
<!-- Set color used with incoming notification messages. This is used when no color is set for the incoming
     notification message. See README(https://goo.gl/6BKBk7) for more. -->
<meta-data
    android:name="com.google.firebase.messaging.default_notification_color"
    android:resource="@color/colorAccent" />

Android zeigt das benutzerdefinierte Standardsymbol für . an

  • Alle Benachrichtigungsnachrichten von den gesendeten Benachrichtigungen Komponisten .
  • Jede Benachrichtigungsnachricht, die das Symbol nicht explizit in der Benachrichtigungsnutzlast festlegt.

Android verwendet die benutzerdefinierte Standardfarbe für

  • Alle Benachrichtigungsnachrichten von den gesendeten Benachrichtigungen Komponisten .
  • Jede Benachrichtigungsnachricht, die die Farbe in der Benachrichtigungsnutzlast nicht explizit festlegt.

Wenn kein benutzerdefiniertes Standardsymbol und kein Symbol in der Benachrichtigungsnutzlast festgelegt ist, zeigt Android das Anwendungssymbol in Weiß an.

außer Kraft setzen onMessageReceived

Durch das Überschreiben der Methode FirebaseMessagingService.onMessageReceived , können Sie Aktionen ausführen , auf dem empfangenen Basis RemoteMessage Objekt und die Nachrichtendaten erhalten:

Java

@Override
public void onMessageReceived(RemoteMessage remoteMessage) {
    // ...

    // TODO(developer): Handle FCM messages here.
    // Not getting messages here? See why this may be: https://goo.gl/39bRNJ
    Log.d(TAG, "From: " + remoteMessage.getFrom());

    // Check if message contains a data payload.
    if (remoteMessage.getData().size() > 0) {
        Log.d(TAG, "Message data payload: " + remoteMessage.getData());

        if (/* Check if data needs to be processed by long running job */ true) {
            // For long-running tasks (10 seconds or more) use WorkManager.
            scheduleJob();
        } else {
            // Handle message within 10 seconds
            handleNow();
        }

    }

    // Check if message contains a notification payload.
    if (remoteMessage.getNotification() != null) {
        Log.d(TAG, "Message Notification Body: " + remoteMessage.getNotification().getBody());
    }

    // Also if you intend on generating your own notifications as a result of a received FCM
    // message, here is where that should be initiated. See sendNotification method below.
}

Kotlin+KTX

override fun onMessageReceived(remoteMessage: RemoteMessage) {
    // ...

    // TODO(developer): Handle FCM messages here.
    // Not getting messages here? See why this may be: https://goo.gl/39bRNJ
    Log.d(TAG, "From: ${remoteMessage.from}")

    // Check if message contains a data payload.
    if (remoteMessage.data.isNotEmpty()) {
        Log.d(TAG, "Message data payload: ${remoteMessage.data}")

        if (/* Check if data needs to be processed by long running job */ true) {
            // For long-running tasks (10 seconds or more) use WorkManager.
            scheduleJob()
        } else {
            // Handle message within 10 seconds
            handleNow()
        }
    }

    // Check if message contains a notification payload.
    remoteMessage.notification?.let {
        Log.d(TAG, "Message Notification Body: ${it.body}")
    }

    // Also if you intend on generating your own notifications as a result of a received FCM
    // message, here is where that should be initiated. See sendNotification method below.
}

außer Kraft setzen onDeletedMessages

In einigen Situationen übermittelt FCM möglicherweise keine Nachricht. Dies tritt auf, wenn zum Zeitpunkt der Verbindung zu viele Nachrichten (> 100) für Ihre App auf einem bestimmten Gerät ausstehen oder wenn das Gerät seit mehr als einem Monat keine Verbindung zu FCM hergestellt hat. In diesen Fällen können Sie einen Rückruf erhalten FirebaseMessagingService.onDeletedMessages() Wenn die App - Instanz diesen Rückruf empfängt, sollte es eine vollständige Synchronisierung mit Ihrem App - Server durchführt. Wenn Sie nicht eine Nachricht an die App auf dem Gerät innerhalb der letzten 4 Wochen gesendet haben, wird FCM nicht nennen onDeletedMessages() .

Behandeln Sie Benachrichtigungen in einer Hintergrund-App

Wenn sich Ihre App im Hintergrund befindet, leitet Android Benachrichtigungen an die Taskleiste weiter. Ein Benutzer, der auf die Benachrichtigung tippt, öffnet standardmäßig den App-Launcher.

Dazu gehören Nachrichten, die sowohl Benachrichtigungen als auch Datennutzlast enthalten (sowie alle Nachrichten, die von der Notifications-Konsole gesendet werden). In diesen Fällen wird die Benachrichtigung an die Taskleiste des Geräts gesendet und die Datennutzlast wird in den Extras der Absicht Ihrer Launcher-Aktivität geliefert.

Für einen Einblick in die Nachrichtenübermittlung zu Ihrer Anwendung finden Sie in der FCM - Reporting - Dashboard , das die Anzahl der gesendeten Nachrichten und geöffnet auf iOS und Android - Geräte, zusammen mit den Daten für „Eindrücke“ (Mitteilungen gesehen werden von den Benutzern) für Android - Anwendungen aufzeichnet.

Apps mit eingeschränktem Hintergrund (Android P oder neuer)

FCM kann keine Nachrichten an Anwendungen liefern , die in gestellt wurden Hintergrund Beschränkung durch den Benutzer (wie zum Beispiel über: Einstellungen -> Apps und Benachrichtigung -> [appname] -> Batterie). Sobald Ihre App aus der Hintergrundbeschränkung entfernt wurde, werden neue Nachrichten an die App wie zuvor zugestellt. Um verlorene Nachrichten und andere Hintergrund Einschränkung Auswirkungen zu verhindern, stellen Sie sicher , schlechte Verhaltensweisen durch den genannten zu vermeiden Android Vitals Aufwand. Diese Verhaltensweisen können dazu führen, dass das Android-Gerät dem Benutzer empfiehlt, dass Ihre App im Hintergrund eingeschränkt wird. Ihre App kann überprüfen , ob es Hintergrund ist eingeschränkt mit: isBackgroundRestricted () .

Empfangen von FCM-Nachrichten im Direktstartmodus

Entwickler, die FCM-Nachrichten an Apps senden möchten, noch bevor das Gerät entsperrt ist, können einer Android-App den Empfang von Nachrichten ermöglichen, wenn sich das Gerät im Direktstartmodus befindet. Sie möchten beispielsweise, dass Benutzer Ihrer App auch auf einem gesperrten Gerät Alarmbenachrichtigungen erhalten.

Bei diesem Anwendungsfall des Aufbau aus, beachten Sie die allgemeine Best Practices und Einschränkungen für die direkten Boot - Modus . Es ist besonders wichtig , um die Sichtbarkeit der Direktstart-Nachrichten zu prüfen; Jeder Benutzer mit Zugriff auf das Gerät kann diese Nachrichten anzeigen, ohne Benutzeranmeldeinformationen einzugeben.

Voraussetzungen

  • Das Gerät muss für den Direktstartmodus eingerichtet sein.
  • Auf dem Gerät muss eine aktuelle Version der Google Play-Dienste installiert sein (19.0.54 oder höher).
  • Die App muss das FCM SDK wird ( com.google.firebase:firebase-messaging ) FCM - Nachrichten zu empfangen.

Aktivieren Sie die Nachrichtenverarbeitung im Direktstartmodus in Ihrer App

  1. Fügen Sie in der Gradle-Datei auf App-Ebene eine Abhängigkeit von der FCM Direct Boot Support Library hinzu:

    implementation 'com.google.firebase:firebase-messaging-directboot:20.2.0'
    
  2. Machen Sie die App FirebaseMessagingService direkten Boot bewusst durch das Hinzufügen von android:directBootAware="true" Attribut in der App - Manifest:

    <service
        android:name=".java.MyFirebaseMessagingService"
        android:exported="false"
        android:directBootAware="true">
        <intent-filter>
            <action android:name="com.google.firebase.MESSAGING_EVENT" />
        </intent-filter>
    </service>
    

Es ist wichtig , um sicherzustellen , dass diese FirebaseMessagingService in direktem Boot - Modus ausgeführt werden kann. Überprüfen Sie die folgenden Anforderungen:

  • Der Dienst sollte nicht auf mit Anmeldeinformationen geschützten Speicher zugreifen, während er im Direktstartmodus ausgeführt wird.
  • Der Dienst soll nicht zu verwenden Komponenten versuchen, wie Activities , BroadcastReceivers oder andere Services , die nicht markiert sind als direkte Boot bewusst , während im direkten Boot - Modus ausgeführt wird .
  • Alle Bibliotheken, die der Dienst verwendet, dürfen auch nicht auf mit Anmeldeinformationen geschützten Speicher zugreifen oder Nicht-directBootAware-Komponenten aufrufen, während sie im Direktstartmodus ausgeführt werden. Dies bedeutet, dass alle Bibliotheken, die die App verwendet, die vom Dienst aufgerufen werden, entweder direkt bootfähig sein müssen oder die App überprüfen muss, ob sie im direkten Bootmodus ausgeführt wird, und sie nicht in diesem Modus aufrufen. Firebase SDKs funktionieren beispielsweise mit Direktstart (sie können in eine App eingebunden werden, ohne dass diese im Direktstartmodus abstürzt), aber viele Firebase-APIs unterstützen den Aufruf im Direktstartmodus nicht.
  • Wenn die App einer benutzerdefinierte verwendete Application , die Application auch direkt Boot bewusst (kein Zugriff auf Anmeldeinformationen eines geschützte Lagerung im direkten Boot - Modus) sein muß.

Für Hinweise auf Nachrichten an Geräte in direktem Boot - Modus zu senden, siehe senden Direktstart-Nachrichten .