Questa pagina è stata tradotta dall'API Cloud Translation.

Ricevere messaggi in un'app per Android

Le notifiche di Firebase si comportano in modo diverso a seconda dello stato in primo piano o in background dell'app di destinazione. Se vuoi che le app in primo piano ricevano messaggi di notifica o messaggi di dati, devi scrivere il codice per gestire il callback onMessageReceived. Per una spiegazione della differenza tra messaggi di notifica e di dati, consulta Tipi di messaggi.

Gestione dei messaggi

Per ricevere messaggi, utilizza un servizio che si estende FirebaseMessagingService. Il tuo servizio deve sostituire i callback onMessageReceived e onDeletedMessages.

La finestra temporale per la gestione di un messaggio può essere inferiore a 20 secondi a seconda dei ritardi subiti prima di chiamare onMessageReceived, inclusi i ritardi del sistema operativo, il tempo di avvio dell'app, il blocco del thread principale da parte di altre operazioni o chiamate onMessageReceived precedenti che richiedono troppo tempo. Dopo questo periodo, vari comportamenti del sistema operativo, come l'interruzione dei processi di Android o i limiti di esecuzione in background di Android O, potrebbero interferire con la tua capacità di completare il lavoro.

onMessageReceived è fornito per la maggior parte dei tipi di messaggi, con le seguenti eccezioni:

Messaggi di notifica recapitati quando l'app è in background. In questo caso, la notifica viene inviata alla barra delle app del dispositivo. Quando un utente tocca una notifica, per impostazione predefinita si apre Avvio app.
Messaggi con payload di notifica e dati, se ricevuti in background. In questo caso, la notifica viene inviata alla barra delle app del dispositivo e il payload dei dati viene inviato negli extra dell'intent dell'attività del programma di avvio.

In sintesi:

Stato dell'app	Notifica	Dati	Entrambe
Primo piano	`onMessageReceived`	`onMessageReceived`	`onMessageReceived`
Contesto	Barra delle app	`onMessageReceived`	Notifica: riquadro delle app Dati: negli extra dell'intent.

Per ulteriori informazioni sui tipi di messaggi, vedi Notifiche e messaggi di dati.

Modificare il file manifest dell'app

Per utilizzare FirebaseMessagingService, devi aggiungere quanto segue nel file manifest dell'app:

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

Ti consigliamo inoltre di impostare valori predefiniti per personalizzare l'aspetto delle notifiche. Puoi specificare un'icona predefinita personalizzata e un colore predefinito personalizzato che vengono applicati ogni volta che i valori equivalenti non sono impostati nel payload della notifica.

Aggiungi queste righe all'interno del tag application per impostare l'icona predefinita e il colore personalizzati:

<!-- 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" />AndroidManifest.xml

Android mostra l'icona predefinita personalizzata per

Tutti i messaggi di notifica inviati dal Editor di notifiche.
Qualsiasi messaggio di notifica che non imposta esplicitamente l'icona nel payload della notifica.

Android utilizza il colore predefinito personalizzato per

Tutti i messaggi di notifica inviati dal Editor di notifiche.
Qualsiasi messaggio di notifica che non imposta esplicitamente il colore nel payload della notifica.

Se non viene impostata alcuna icona predefinita personalizzata e non ne viene impostata nessuna nel payload delle notifiche, Android mostra l'icona dell'applicazione visualizzata in bianco.

Sostituisci `onMessageReceived`

Sostituendo il metodo FirebaseMessagingService.onMessageReceived, puoi eseguire azioni in base all'oggetto RemoteMessage ricevuto e recuperare i dati del messaggio:

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}")

        // Check if data needs to be processed by long running job
        if (needsToBeScheduled()) {
            // 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.
}MyFirebaseMessagingService.kt

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.
}MyFirebaseMessagingService.java

Esegui l'override di `onDeletedMessages`

In alcune situazioni, FCM potrebbe non recapitare un messaggio. Questo si verifica se nel momento in cui ci sono troppi messaggi (> 100) in attesa per la tua app su un determinato dispositivo nel momento in cui si connette o se il dispositivo non si connette a FCM da più di un mese. In questi casi, puoi ricevere un callback a FirebaseMessagingService.onDeletedMessages() Quando l'istanza dell'app riceve questo callback, dovrebbe eseguire una sincronizzazione completa con il server dell'app. Se non hai inviato un messaggio all'app su quel dispositivo nelle ultime 4 settimane, FCM non chiamerà onDeletedMessages().

Gestire i messaggi di notifica in un'app in background

Quando l'app è in background, Android indirizza i messaggi di notifica alla barra delle applicazioni. Se un utente tocca la notifica, viene aperto Avvio app per impostazione predefinita.

Sono inclusi i messaggi che contengono sia il payload di notifica sia quello di dati (e tutti i messaggi inviati dalla console Notifiche). In questi casi, la notifica viene inviata alla barra delle app del dispositivo e il payload dei dati viene inviato negli extra dell'intent della tua attività di Avvio.

Per informazioni sulla consegna dei messaggi nella tua app, consulta la dashboard dei report FCM, che registra il numero di messaggi inviati e aperti sui dispositivi Apple e Android, insieme ai dati per le "impressioni" (notifiche visualizzate dagli utenti) per le app per Android.

Ricevere messaggi FCM in modalità di avvio diretto

Gli sviluppatori che vogliono inviare messaggi FCM alle app anche prima che il dispositivo venga sbloccato possono consentire a un'app per Android di ricevere messaggi quando il dispositivo è in modalità di avvio diretto. Ad esempio, potresti volere che gli utenti della tua app ricevano notifiche per gli allarmi anche su un dispositivo bloccato.

Quando sviluppi questo caso d'uso, rispetta le best practice e le limitazioni generali per la modalità di avvio diretto. È particolarmente importante considerare la visibilità dei messaggi con avvio diretto. Qualsiasi utente con accesso al dispositivo può visualizzare questi messaggi senza inserire le credenziali utente.

Prerequisiti

Il dispositivo deve essere configurato per la modalità di avvio diretto.
Sul dispositivo deve essere installata una versione recente di Google Play Services (19.0.54 o successive).
L'app deve utilizzare l'SDK FCM (com.google.firebase:firebase-messaging) per ricevere messaggi FCM.

Attiva la gestione dei messaggi in modalità di avvio diretto nella tua app

Nel file Gradle a livello di app, aggiungi una dipendenza dalla libreria di supporto per il boot diretto FCM:
```
implementation 'com.google.firebase:firebase-messaging-directboot:20.2.0'
```

Rendi l'app FirebaseMessagingService consapevole del boot diretto aggiungendo l'attributo android:directBootAware="true" nel manifest dell'app:

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

È importante assicurarsi che questo FirebaseMessagingService possa funzionare in modalità di avvio diretto. Verifica i seguenti requisiti:

Il servizio non deve accedere allo spazio di archiviazione protetto dalle credenziali durante l'esecuzione in modalità di avvio diretto.
Il servizio non deve tentare di utilizzare componenti, come Activities, BroadcastReceivers o altri Services, non contrassegnati come sensibili all'avvio diretto durante l'esecuzione in modalità di avvio diretto.
Inoltre, tutte le librerie utilizzate dal servizio non devono accedere allo spazio di archiviazione protetto da credenziali né chiamare componenti non directBootAware durante l'esecuzione in modalità di avvio diretto. Ciò significa che tutte le librerie impiegate dall'app e richiamate dal servizio dovranno essere compatibili con il boot diretto oppure l'app dovrà verificare se è in esecuzione in modalità di boot diretto e non richiamarle in quella modalità. Ad esempio, gli SDK Firebase funzionano con il boot diretto (possono essere inclusi in un'app senza provocarne l'arresto anomalo in modalità di boot diretto), ma molte API Firebase non supportano l'utilizzo in modalità di boot diretto.
Se l'app utilizza un Application personalizzato, anche questo dovrà essere consapevole del boot diretto (nessun accesso allo spazio di archiviazione protetto dalle credenziali in modalità di boot diretto).Application

Per indicazioni su come inviare messaggi ai dispositivi in modalità di avvio diretto, consulta Inviare messaggi abilitati per l'avvio diretto.