Inviare un messaggio di prova a un'app in background

Per iniziare a utilizzare FCM, crea lo scenario d'uso più semplice: invia un messaggio di notifica di test dal composer delle notifiche a un dispositivo di sviluppo quando l'app è in background sul dispositivo. Questa pagina elenca tutti i passaggi per raggiungere questo obiettivo, dalla configurazione alla verifica e potrebbe includere passaggi che hai già completato se hai configurato un'app client Android per FCM.

Configura l'SDK

Questa sezione riguarda le attività che potresti aver completato se hai già attivato altre funzionalità di Firebase per la tua app.

Prima di iniziare

• Installa o aggiorna Android Studio all'ultima versione.

• Assicurati che il tuo progetto soddisfi questi requisiti (tieni presente che alcuni prodotti potrebbero avere requisiti più rigorosi):

  • Ha come target il livello API 21 (Lollipop) o versioni successive
  • Utilizza Android 5.0 o versioni successive
  • Utilizza Jetpack (AndroidX), che include il rispetto dei seguenti requisiti di versione:
    • com.android.tools.build:gradle v7.3.0 o versioni successive
    • compileSdkVersion 28 o versioni successive

• Configura un dispositivo fisico o utilizza un emulatore per eseguire la tua app.
  Tieni presente che gli SDK Firebase con una dipendenza da Google Play Services richiedono che sul dispositivo o sull'emulatore sia installato Google Play Services.

• Accedi a Firebase utilizzando il tuo Account Google.

Se non hai ancora un progetto Android e vuoi solo provare un prodotto Firebase, puoi scaricare uno dei nostri esempi di avvio rapido.

Crea un progetto Firebase

Prima di poter aggiungere Firebase alla tua app per Android, devi creare un progetto Firebase per connetterti all'app. Visita la pagina Informazioni sui progetti Firebase per scoprire di più sui progetti Firebase.

Registrare l'app con Firebase

Per utilizzare Firebase nella tua app per Android, devi registrare l'app con il tuo progetto Firebase. La registrazione dell'app viene spesso chiamata "aggiunta" dell'app al progetto.

1. Vai alla console Firebase.

2. Al centro della pagina di riepilogo del progetto, fai clic sull'icona Android (plat_android) o su Aggiungi app per avviare il flusso di lavoro della configurazione.

3. Inserisci il nome del pacchetto della tua app nel campo Nome del pacchetto Android.

   Che cos'è un nome del pacchetto e dove si trova?

   • Un nome del pacchetto identifica in modo univoco la tua app sul dispositivo e nel Google Play Store.

   • Un nome pacchetto viene spesso definito ID applicazione.

   • Trova il nome del pacchetto della tua app nel file Gradle del modulo (a livello di app), di solito app/build.gradle (nome del pacchetto di esempio: com.yourcompany.yourproject).

   • Tieni presente che il valore del nome del pacchetto è sensibile alle maiuscole e non può essere modificato per questa app Firebase per Android dopo la registrazione nel tuo progetto Firebase.

4. (Facoltativo) Inserisci altre informazioni sull'app: Nickname dell'app e Certificato SHA-1 per la firma di debug.

   Come vengono utilizzati il nickname dell'app e il certificato SHA-1 per la firma di debug in Firebase?

   • Nickname dell'app: un identificatore interno e pratico visibile solo nella console Firebase.

   • Certificato SHA-1 per la firma di debug: un hash SHA-1 è richiesto da Firebase Authentication (quando si utilizza l'accesso con Google o l'accesso con il numero di telefono) e da Firebase Dynamic Links.

5. Fai clic su Registra app.

Aggiungere un file di configurazione di Firebase

1. Scarica e poi aggiungi il file di configurazione Firebase della tua app (google-services.json) al tuo codebase:

   1. Fai clic su Scarica google-services.json per ottenere il file di configurazione Firebase della tua app.

   2. Sposta il file di configurazione nella directory root del modulo (a livello di app) della tua app.

   Cosa devi sapere di questo file di configurazione?

   • Il file di configurazione di Firebase contiene identificatori univoci, ma non segreti, per il tuo progetto e la tua app. Per scoprire di più su questo file di configurazione, visita la pagina Informazioni sui progetti Firebase.

   • Puoi scaricare di nuovo il file di configurazione di Firebase in qualsiasi momento.

   • Assicurati che al nome del file di configurazione non vengano aggiunti caratteri aggiuntivi, ad esempio (2).

2. Per rendere accessibili agli SDK Firebase i valori nel file di configurazione google-services.json, è necessario il plug-in Gradle dei servizi Google (google-services).

   1. Nel file Gradle a livello di directory principale (a livello di progetto) (<project>/build.gradle.kts o <project>/build.gradle), aggiungi il plug-in dei servizi Google come dipendenza:

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

   2. Nel file Gradle del modulo (a livello di app) (di solito <project>/<app-module>/build.gradle.kts o <project>/<app-module>/build.gradle), aggiungi il plug-in dei servizi Google:

      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'
        // ...
      }

Aggiungere gli SDK Firebase alla tua app

1. Nel file Gradle (a livello di app) del modulo (di solito <project>/<app-module>/build.gradle.kts o <project>/<app-module>/build.gradle), aggiungi la dipendenza per la libreria Firebase Cloud Messaging per Android. Ti consigliamo di utilizzare Firebase Android BoM per controllare il controllo delle versioni della libreria.

   Per un'esperienza ottimale con Firebase Cloud Messaging, ti consigliamo di attivare Google Analytics nel tuo progetto Firebase e di aggiungere l'SDK Firebase per Google Analytics alla tua app.

   dependencies {
       // Import the BoM for the Firebase platform
       implementation(platform("com.google.firebase:firebase-bom:34.0.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")
   }

   Utilizzando la Firebase Android BoM, la tua app utilizzerà sempre versioni compatibili delle librerie Firebase Android.

   (Alternativa)  Aggiungi le dipendenze della libreria Firebase senza utilizzare BoM

   Se scegli di non utilizzare la Firebase BoM, devi specificare ogni versione della libreria Firebase nella riga della dipendenza.

   Tieni presente che se utilizzi più librerie Firebase nella tua app, ti consigliamo vivamente di utilizzare la BoM per gestire le versioni delle librerie, in modo da garantire la compatibilità di tutte le versioni.

   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:25.0.0")
       implementation("com.google.firebase:firebase-analytics:23.0.0")
   }

2. Sincronizza il tuo progetto Android con i file Gradle.

   Ricevi un errore di build relativo al supporto di invoke-custom e all'attivazione del desugaring? Ecco come risolvere il problema.

   Le build Gradle che utilizzano il plug-in Android per Gradle (AGP) v4.2 o versioni precedenti devono attivare il supporto di Java 8. In caso contrario, questi progetti Android generano un errore di build quando viene aggiunto un SDK Firebase.

   Per risolvere questo errore di compilazione, puoi seguire una delle due opzioni seguenti:

   • Aggiungi compileOptions elencati nel messaggio di errore al file a livello di app build.gradle.kts o build.gradle.
   • Aumenta il minSdk per il tuo progetto Android a 26 o un valore superiore.

   Scopri di più su questo errore della build in queste Domande frequenti.

Accedere al token di registrazione

Per inviare un messaggio a un dispositivo specifico, devi conoscere il token di registrazione del dispositivo. Poiché dovrai inserire il token in un campo della console delle notifiche per completare questo tutorial, assicurati di copiare il token o di archiviarlo in modo sicuro dopo averlo recuperato.

All'avvio iniziale dell'app, l'SDK FCM genera un token di registrazione per l'istanza dell'app client. Se vuoi scegliere come target singoli dispositivi o creare gruppi di dispositivi, dovrai accedere a questo token estendendo FirebaseMessagingService e sostituendo onNewToken.

Questa sezione descrive come recuperare il token e come monitorare le modifiche apportate. Poiché il token potrebbe essere ruotato dopo l'avvio iniziale, ti consigliamo vivamente di recuperare l'ultimo token di registrazione aggiornato.

Il token di registrazione può cambiare quando:

• L'app viene ripristinata su un nuovo dispositivo
• L'utente disinstalla/reinstalla l'app
• L'utente cancella i dati dell'app.

Recuperare il token di registrazione attuale

Quando devi recuperare il token attuale, chiama FirebaseMessaging.getInstance().getToken():

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

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();
        }
    });

Monitorare la generazione di token

Il callback onNewToken viene attivato ogni volta che viene generato un nuovo token.

/**
 * 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

/**
 * 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

Dopo aver ottenuto il token, puoi inviarlo al server dell'app e memorizzarlo utilizzando il metodo che preferisci.

Invia un messaggio di notifica di prova

1. Installa ed esegui l'app sul dispositivo di destinazione. Sui dispositivi Apple, dovrai accettare la richiesta di autorizzazione per ricevere notifiche da remoto.

2. Assicurati che l'app sia in background sul dispositivo.

3. Nella console Firebase, apri la pagina Messaggistica.

4. Se questo è il tuo primo messaggio, seleziona Crea la tua prima campagna.

   1. Seleziona Messaggi di notifica Firebase e poi Crea.

5. In caso contrario, nella scheda Campagne, seleziona Nuova campagna e poi Notifiche.

6. Inserisci il testo del messaggio. Tutti gli altri campi sono facoltativi.

7. Seleziona Invia messaggio di prova dal riquadro a destra.

8. Nel campo etichettato Aggiungi un token di registrazione FCM, inserisci il token di registrazione che hai ottenuto in una sezione precedente di questa guida.

9. Seleziona Test.

Dopo aver selezionato Test, il dispositivo client di destinazione (con l'app in background) dovrebbe ricevere la notifica.

Per informazioni sulla distribuzione dei messaggi alla tua app, consulta la dashboard dei report FCM, che registra il numero di messaggi inviati e aperti su dispositivi Apple e Android, nonché i dati relativi alle "impressioni" (notifiche visualizzate dagli utenti) per le app per Android.

Passaggi successivi

Inviare messaggi alle app in primo piano

Dopo aver inviato correttamente i messaggi di notifica mentre l'app è in background, consulta Ricevere messaggi in un'app per Android per iniziare a inviare messaggi alle app in primo piano.

Andare oltre i messaggi di notifica

Per andare oltre i messaggi di notifica e aggiungere altri comportamenti più avanzati alla tua app, consulta:

• Ricevere messaggi in un'app per Android
• Inviare messaggi a più dispositivi