Inviare e ricevere notifiche per un'app Flutter utilizzando Firebase Cloud Messaging

1. Introduzione

Ultimo aggiornamento: 2022-04-04

Questo codelab illustra la procedura di sviluppo di un'app multipiattaforma con Firebase Cloud Messaging (FCM) utilizzando Flutter. Scriverai un componente dell'implementazione dell'app, quindi la creerai ed eseguirai senza problemi su tre piattaforme: Android, iOS e web. Scoprirai inoltre come integrare FCM in Flutter e come scrivere codice per ricevere e inviare messaggi. Infine, il codelab introduce la funzionalità dei blocchi specifici della piattaforma dell'API FCM HTTP v1, che consente di inviare un messaggio con comportamenti diversi su piattaforme diverse.

Prerequisito

Conoscenza di base di Flutter.

Cosa imparerai a fare

  • Come configurare e creare un'app Flutter.
  • Come aggiungere le dipendenze FCM.
  • Come inviare singoli messaggi FCM alla tua app.
  • Come inviare messaggi FCM basati su argomenti alla tua app.

Che cosa ti serve

  • Ultima versione stabile di Android Studio configurata con i plug-in Dart e Flutter.

Puoi eseguire il codelab utilizzando uno dei seguenti dispositivi:

Facoltativamente, per eseguire il codelab utilizzando la piattaforma iOS, hai bisogno di un dispositivo iOS, un account sviluppatore Apple e un dispositivo macOS con Xcode installato.

2. Configurazione di Flutter

Se hai già configurato un ambiente di sviluppo Flutter, salta questa sezione.

Per configurare un ambiente di sviluppo Flutter:

  1. Scarica e installa Flutter per il tuo sistema operativo: Installa | Svolazzante
  2. Assicurati che lo strumento Flutter sia aggiunto al percorso.
  3. Configura l'editor per Flutter come mostrato in Configurare un editor | Flutter Assicurati di installare i plug-in Flutter e Dart per il tuo editor. Per la parte restante del codelab, utilizzerai Android Studio.
  4. Dalla riga di comando, esegui flutter doctor, che esegue la scansione della configurazione ed elenca le dipendenze mancanti che devono essere corrette. Segui le istruzioni per correggere eventuali importanti dipendenze mancanti. Tieni presente che alcune dipendenze potrebbero non essere necessarie. Ad esempio, se non vuoi sviluppare per iOS, una dipendenza CocoaPods mancante non sarà un problema bloccante.
  5. Esegui questo comando per creare l'app Flutter nella directory fcmflutter flutter create --org com.flutter.fcm --project-name fcmflutter fcmflutter, quindi cambia directory in fcmflutter.
  1. In Android Studio, vai a File -> Apri, trova il percorso dell'app Flutter e fai clic su Apri per aprire il progetto in Android Studio. Il codice dell'app si trova nel file lib/main.dart.

Nella barra degli strumenti di Android Studio, fai clic sulla Freccia giù per selezionare un dispositivo Android. Se il selettore di destinazione è vuoto, installa un dispositivo Android virtuale, il browser Chrome o il simulatore iOS se preferisci avviare l'app da un browser web o un dispositivo iOS. Potresti dover avviare il dispositivo manualmente e aggiornare l'elenco per trovare il dispositivo di destinazione.

Una barra degli strumenti di Android Studio in cui è evidenziata la freccia menu a discesa del menu di destinazione della build.

Fai clic su Esegui Pulsante Esegui in Android Studio per avviare l'app.

L'interfaccia utente di un'app demo Flutter lanciata

Complimenti! Hai creato un'app Flutter.

3. Configurazione di Firebase e FlutterFire

Per sviluppare un'app che si integra con Firebase Cloud Messaging mediante Flutter, devi avere:

  • Un progetto Firebase.
  • Un'interfaccia a riga di comando di Firebase funzionante.
  • Un'installazione di FlutterFire.
  • Un'app configurata e generata con flutterfire configure.

Crea il tuo progetto Firebase

Se disponi già di un progetto Firebase, puoi saltare questo passaggio.

  1. Se hai un Account Google, apri Firebase e accedi con il tuo Account Google, quindi fai clic su Vai alla console.
  2. Nella console Firebase, fai clic su Aggiungi progetto. Segui le istruzioni per creare un progetto. Non selezionare Abilita Google Analytics per questo progetto perché non la utilizzerai in questo progetto.
  3. Dopo aver creato il progetto, vai alle Impostazioni progetto facendo clic sull'icona a forma di ingranaggio accanto a Panoramica progetto.

Uno screenshot ritagliata della Console Firebase che mette in evidenza l'icona del menu Impostazioni progetto e il

L'ID progetto viene utilizzato per identificare in modo univoco il progetto e potrebbe essere diverso dal Nome progetto. L'ID progetto verrà utilizzato per configurare FlutterFire in un secondo momento.

Uno screenshot ritagliato della console Firebase che evidenzia l'ID progetto

Complimenti! Hai creato un progetto Firebase.

Configura l'interfaccia a riga di comando di Firebase

Se hai configurato Firebase CLI, puoi saltare questo passaggio.

Vai al riferimento per l'interfaccia a riga di comando di Firebase per scaricare e installare l'interfaccia a riga di comando di Firebase. Accedi a Firebase con il tuo Account Google utilizzando il seguente comando:

firebase login

Configurare FlutterFire

  1. Installa il plug-in FlutterFire utilizzando il comando: flutter pub add firebase_core
  2. Installa il plug-in FCM: flutter pub add firebase_messaging
  3. Configura l'interfaccia a riga di comando FlutterFire: dart pub global activate flutterfire_cli
  4. Configura il progetto Firebase su Flutter: flutterfire configure --project=fcm4flutter. utilizza i tasti freccia e la barra spaziatrice per selezionare le piattaforme o premi Invio per utilizzare le piattaforme predefinite.

Questo codelab utilizza le piattaforme predefinite (Android, iOS e web), ma puoi selezionare solo una o due piattaforme. Se ti viene richiesto l'ID pacchetto iOS, inserisci com.flutter.fcm.fcmflutter o il tuo ID pacchetto iOS nel formato [company domain name].[project name]. Al termine del comando, aggiorna la pagina della console Firebase. Vedrai che ha creato app per le piattaforme selezionate nel progetto Firebase.

Uno screenshot ritagliato della console Firebase che mostra le app create per le piattaforme selezionate

Questo comando genera un file firebase_options.dart nella directory lib, che contiene tutte le opzioni necessarie per l'inizializzazione.

Configurare Cloud Messaging per iOS

  1. Vai alla pagina degli sviluppatori di Apple e fai clic su Create a key (Crea chiave) nella scheda Keys (Chiavi).

Uno screenshot ritagliato della pagina sviluppatore Apple che evidenzia i componenti della pagina per la creazione della chiave

  1. Inserisci il nome della chiave e seleziona APN (Servizi notifiche push di Apple). Uno screenshot della pagina dello sviluppatore Apple in cui è evidenziata la casella di testo per il nuovo nome della chiave
  2. Scarica il file della chiave, che ha un'estensione del file .p8. Uno screenshot ritagliata della pagina dello sviluppatore Apple che evidenzia il pulsante per il download di una chiave
  3. Nella console di Firebase, vai alle Impostazioni progetto del progetto e scegli la scheda Cloud Messaging.

Uno screenshot della pagina della Console Firebase ritagliata che mette in evidenza i componenti per aggiornare le impostazioni del progetto

Uno screenshot ritagliato della pagina della console Firebase che evidenzia la scheda Cloud Messaging

  1. Carica il file della chiave APN per l'app per iOS nella scheda Cloud Messaging. Inserisci l'ID chiave APNs dalla scheda Cloud Messaging e l'ID team, che puoi trovare nel Centro membri di Apple. Uno screenshot ritagliato della pagina della console Firebase che evidenzia i pulsanti per caricare una chiave di autenticazione del servizio APN

4. Preparazione FCM

Prima che un'app possa ricevere messaggi da FCM, deve:

  • Inizializza FlutterFire.
  • Richiedi le autorizzazioni per le notifiche.
  • Registrati con FCM per ricevere un token di registrazione.

Inizializzazione

Per inizializzare il servizio, sostituisci la funzione principale (lib/main.dart) con questo codice:

// core Flutter primitives
import 'package:flutter/foundation.dart';
// core FlutterFire dependency
import 'package:firebase_core/firebase_core.dart';
// generated by 
flutterfire configure
import 'firebase_options.dart';
// FlutterFire's Firebase Cloud Messaging plugin
import 'package:firebase_messaging/firebase_messaging.dart';

// TODO: Add stream controller
// TODO: Define the background message handler

Future<void> main() async {
 WidgetsFlutterBinding.ensureInitialized();
 await Firebase.initializeApp(
   options: DefaultFirebaseOptions.currentPlatform,
 );

 // TODO: Request permission
 // TODO: Register with FCM
 // TODO: Set up foreground message handler
 // TODO: Set up background message handler

 runApp(MyApp());
}

Poi esegui Strumenti -> Flutter -> Flutter Pub Get in Android Studio per caricare i pacchetti aggiunti in Configurare FlutterFire e visualizzare il codice con l'impostazione Intellisense appropriata in Android Studio.

Viene inizializzato FlutterFire per la piattaforma DefaultFirebaseOptions.currentPlatform corrente, che viene importata dal file firebase_options.dart generato. Tieni presente che initializeApp è una funzione asincrona e la parola chiave await garantisce il completamento dell'inizializzazione prima dell'esecuzione dell'applicazione.

Richiedi autorizzazione

L'app deve chiedere all'utente l'autorizzazione per ricevere notifiche. Il metodo requestPermission fornito da firebase_messaging mostra una finestra di dialogo o un popup che chiede all'utente di consentire o negare l'autorizzazione.

Innanzitutto, copia questo codice nella funzione principale sotto il commento TODO: Request permission. Il valore settings restituito indica se l'utente ha concesso l'autorizzazione. È consigliabile richiedere l'autorizzazione solo quando l'utente deve utilizzare una funzionalità che richiede l'accesso (ad esempio, quando l'utente attiva le notifiche nelle impostazioni dell'app). Per semplicità, in questo codelab richiediamo l'autorizzazione all'avvio dell'app.

final messaging = FirebaseMessaging.instance;

final settings = await messaging.requestPermission(
 alert: true,
 announcement: false,
 badge: true,
 carPlay: false,
 criticalAlert: false,
 provisional: false,
 sound: true,
);

 if (kDebugMode) {
   print('Permission granted: ${settings.authorizationStatus}');
 }

Quindi, nella barra degli strumenti di Android Studio, seleziona Chrome (web) dal selettore di target ed esegui di nuovo l'app.

Uno screenshot ritagliato della barra degli strumenti di Android Studio con il selettore di destinazione e il pulsante Esegui

Viene quindi aperta una scheda di Chrome con un popup che richiede l'autorizzazione. Se fai clic su Allow, nella console di Android Studio viene visualizzato un log: Permission granted: AuthorizationStatus.authorized. Dopo aver consentito o bloccato la richiesta di autorizzazione, la tua risposta viene memorizzata insieme all'app nel browser e il popup non viene visualizzato di nuovo. Tieni presente che quando esegui nuovamente l'app web su Android Studio, ti potrebbe essere chiesta l'autorizzazione. Uno screenshot ritagliato di una scheda di Chrome con un popup che richiede

Registrazione

Copia questo codice nella funzione principale sotto il commento TODO: Register with FCM per registrarti in FCM. La chiamata getToken restituisce un token di registrazione che può essere utilizzato dal server delle app o dall'ambiente server attendibile per inviare messaggi agli utenti.

// It requests a registration token for sending messages to users from your App server or other trusted server environment.
String? token = await messaging.getToken();

if (kDebugMode) {
  print('Registration Token=$token');
}

Nella barra degli strumenti di Android Studio, seleziona un dispositivo Android ed esegui l'app. Nella console di Android Studio, il token di registrazione viene stampato nel seguente modo:

I/flutter ( 3717): Permission granted: AuthorizationStatus.authorized
I/flutter ( 3717): Registration Token=dch. . . D2P:APA9. . .kbb4

Copialo in un editor di testo, poiché lo utilizzerai per inviare messaggi in seguito.

uses-sdk:minSdkVersion 16 cannot be smaller than version 19 declared in library [:firebase_messaging]

Passaggi aggiuntivi per ricevere messaggi sul web

Le app web richiedono due passaggi aggiuntivi per ottenere il token di registrazione e ascoltare i messaggi in arrivo. Il web deve passare una chiave VAPID a getToken per autorizzare l'invio di richieste ai servizi push web supportati.

Innanzitutto, apri la scheda Cloud Messaging del progetto Firebase nella Console Firebase, scorri verso il basso fino alla sezione Configurazione web per trovare la coppia di chiavi esistente o generarne una nuova. Fai clic sul pulsante evidenziato per copiare la chiave in modo che possa essere utilizzata come vapidKey.

Uno screenshot ritagliato del componente Web Push Certificates della pagina di configurazione web che evidenzia la coppia di chiavi

Quindi, sostituisci il codice di registrazione nella sezione Registrazione con questo codice e aggiorna la vapidKey:

// TODO: replace with your own VAPID key
 const vapidKey = "<YOUR_PUBLIC_VAPID_KEY_HERE>";

 // use the registration token to send messages to users from your trusted server environment
 String? token;

 if (DefaultFirebaseOptions.currentPlatform == DefaultFirebaseOptions.web) {
   token = await messaging.getToken(
     vapidKey: vapidKey,
   );
 } else {
   token = await messaging.getToken();
 }

 if (kDebugMode) {
   print('Registration Token=$token');
 }

Quindi, crea un file firebase-messaging-sw.js sotto la directory web/ nella radice del progetto. Copia quanto segue in firebase-messaging-sw.js per consentire all'app web di ricevere eventi onMessage. Per ulteriori informazioni, consulta Impostare le opzioni di notifica nel service worker.

importScripts("https://www.gstatic.com/firebasejs/9.6.10/firebase-app-compat.js");
importScripts("https://www.gstatic.com/firebasejs/9.6.10/firebase-messaging-compat.js");

// todo Copy/paste firebaseConfig from Firebase Console
const firebaseConfig = {
 apiKey: "...",
 authDomain: "...",
 databaseURL: "...",
 projectId: "...",
 storageBucket: "...",
 messagingSenderId: "...",
 appId: "...",
};

firebase.initializeApp(firebaseConfig);
const messaging = firebase.messaging();

// todo Set up background message handler

Dopodiché, nella scheda Impostazioni progetto -> Generale, scorri verso il basso e individua App web, copia la sezione di codice firebaseConfig e incollala in firebase-messaging-sw.js. Uno screenshot ritagliata del componente dell&#39;app web della pagina di configurazione di Firebase

Infine, nella barra degli strumenti di Android Studio, seleziona Chrome (web) nel selettore del target ed esegui l'app. Nella console di Android Studio, il token di registrazione viene stampato nel seguente modo:

Debug service listening on ws://127.0.0.1:61538/BLQQ3Fg-h7I=/ws
Permission granted: AuthorizationStatus.authorized
Registration Token=fH. . .ue:APA91. . .qwt3chpv

Copia il token di registrazione in un editor di testo in modo da poterlo utilizzare per inviare messaggi in un secondo momento.

Passaggi aggiuntivi per ricevere messaggi su iOS

Per ricevere messaggi da FCM, i dispositivi iOS devono abilitare le notifiche push e le modalità in background su Xcode:

  1. In Android Studio, fai clic con il tasto destro del mouse sul nome del progetto e seleziona Flutter -> Apri il modulo iOS in Xcode. Uno screenshot ritagliata di
  2. Dopo il lancio di Xcode, attiva le notifiche push e le modalità in background nella funzionalità Firma e Funzionalità per il target del progetto. Per ulteriori informazioni, vedi Configurare l'app.
  3. Nella barra degli strumenti di Android Studio, seleziona un dispositivo iOS nel selettore di target ed esegui l'app. Una volta concessa l'autorizzazione alle notifiche, il token di registrazione viene stampato nella console di Android Studio.

Uno screenshot ritagliata di un&#39;app per iOS che chiede l&#39;autorizzazione per inviare notifiche

Congratulazioni, hai registrato correttamente la tua app con FCM. Sei pronto a ricevere messaggi, come descritto nella sezione successiva.

5. Ricevi messaggi da FCM

Configurare i gestori dei messaggi

L'app deve gestire gli eventi onMessage quando arrivano i messaggi mentre l'app è in modalità primo piano ed eventi onBackgroundMessage quando l'app è in background.

Gestore dei messaggi in primo piano

Innanzitutto, aggiungi un controller dello stream dopo il commento TODO: Add stream controller nel file main.dart per trasmettere i messaggi dal gestore degli eventi all'interfaccia utente.

import 'package:rxdart/rxdart.dart';
// used to pass messages from event handler to the UI
final _messageStreamController = BehaviorSubject<RemoteMessage>();

Per aggiungere la dipendenza rxdart, esegui questo comando dalla directory del progetto: flutter pub add rxdart.

Successivamente, esegui Strumenti -> Flutter -> Flutter Pub Get in Android Studio per caricare il pacchetto rxdart.dart e visualizzare il codice con le impostazioni Intellisense appropriate in Android Studio.

Aggiungi un gestore eventi per ascoltare i messaggi in primo piano dopo il commento TODO: Set up foreground message handler. Stampa i log e pubblica il messaggio nel controller di flusso.

 FirebaseMessaging.onMessage.listen((RemoteMessage message) {
   if (kDebugMode) {
     print('Handling a foreground message: ${message.messageId}');
     print('Message data: ${message.data}');
     print('Message notification: ${message.notification?.title}');
     print('Message notification: ${message.notification?.body}');
   }

   _messageStreamController.sink.add(message);
 });

Dopodiché, sostituisci il widget Stato originale nel file main.dart con questo codice, che aggiunge un abbonato al controller dello stream nel widget Stato e mostra l'ultimo messaggio sul widget.

class _MyHomePageState extends State<MyHomePage> {
 String _lastMessage = "";

 _MyHomePageState() {
   _messageStreamController.listen((message) {
     setState(() {
       if (message.notification != null) {
         _lastMessage = 'Received a notification message:'
             '\nTitle=${message.notification?.title},'
             '\nBody=${message.notification?.body},'
             '\nData=${message.data}';
       } else {
         _lastMessage = 'Received a data message: ${message.data}';
       }
     });
   });
 }

 @override
 Widget build(BuildContext context) {
   return Scaffold(
     appBar: AppBar(
       title: Text(widget.title),
     ),
     body: Center(
       child: Column(
         mainAxisAlignment: MainAxisAlignment.center,
         children: <Widget>[
           Text('Last message from Firebase Messaging:',
               style: Theme.of(context).textTheme.titleLarge),
           Text(_lastMessage, style: Theme.of(context).textTheme.bodyLarge),
         ],
       ),
     ),
   );
 }
}

Gestione dei messaggi in background per Android/iOS

I messaggi vengono gestiti dal gestore onBackgroundMessage mentre l'app è in background. Il gestore deve essere una funzione di primo livello. L'interfaccia utente può essere aggiornata quando l'app viene messa in primo piano gestendo i messaggi (vedi Gestione dell'interazione) o sincronizzandola con il server dell'app.

Crea la funzione di gestore dopo il commento TODO: Define the background message handler all'esterno della funzione principale e richiamala nella funzione principale dopo il commento TODO: Define the background message handler.

// TODO: Define the background message handler
Future<void> _firebaseMessagingBackgroundHandler(RemoteMessage message) async {
 await Firebase.initializeApp();

 if (kDebugMode) {
   print("Handling a background message: ${message.messageId}");
   print('Message data: ${message.data}');
   print('Message notification: ${message.notification?.title}');
   print('Message notification: ${message.notification?.body}');
 }
}

void main() {
 ...

 // TODO: Set up background message handler
 FirebaseMessaging.onBackgroundMessage(_firebaseMessagingBackgroundHandler);

 runApp(MyApp());
}

Gestore di messaggi in background per il web

A partire dalla versione 11.2.8 di FlutterFire firebase_messaging, la gestione dei messaggi in background sulle piattaforme web richiede un flusso diverso. Di conseguenza, devi aggiungere un gestore di messaggi separato nel Service worker web/firebase-messaging-sw.js.

messaging.onBackgroundMessage((message) => {
 console.log("onBackgroundMessage", message);
});

Configurare il server dell'app

  1. Importa il codice del server di avvio aprendo https://github.com/FirebaseExtended/firebase_fcm_flutter/tree/main/server project in Android Studio. Il server è un progetto Java basato su Gradle con una dipendenza dall'SDK firebase-admin, che fornisce la funzionalità di invio di messaggi FCM.
  2. Configura un account di servizio Firebase che consenta all'SDK Firebase Admin di autorizzare le chiamate alle API FCM. Nella console Firebase, apri Impostazioni progetto e seleziona la scheda Account di servizio. Scegli "Java" e fai clic su Generate new private key per scaricare lo snippet di configurazione. Uno screenshot ritagliato che mette in evidenza lo snippet di configurazione dell&#39;SDK Admin del componente Account di servizio della pagina Impostazioni progetto
  3. Rinomina il file in service-account.json e copialo nel percorso src/main/resources del progetto server.

Inviare un messaggio di prova

Nel file FcmSender.java, sendMessageToFcmRegistrationToken compone un messaggio di notifica con un payload di dati. Il token di registrazione ha come target l'istanza dell'app a cui viene inviato il messaggio.

private static void sendMessageToFcmRegistrationToken() throws Exception {
   String registrationToken = "REPLACE_WITH_FCM_REGISTRATION_TOKEN";
   Message message =
       Message.builder()
           .putData("FCM", "https://firebase.google.com/docs/cloud-messaging")
           .putData("flutter", "https://flutter.dev/")
           .setNotification(
               Notification.builder()
                   .setTitle("Try this new app")
                   .setBody("Learn how FCM works with Flutter")
                   .build())
           .setToken(registrationToken)
           .build();

   FirebaseMessaging.getInstance().send(message);

   System.out.println("Message to FCM Registration Token sent successfully!!");
 }
  1. Copia il token di registrazione di Android dalla sezione Registrazione e incollalo nel valore della variabile registrationToken.
  2. Fai clic su Esegui Il pulsante Esegui in Android Studio per eseguire la funzione principale e inviare il messaggio all'utente tramite FCM. Uno screenshot ritagliato dell&#39;icona Esegui mostrata accanto alla funzione principale FcmSender.java in Android Studio

Quando l'app per Android è in background, il messaggio viene visualizzato nella barra delle notifiche.

Uno screenshot ritagliato di un messaggio visualizzato nella barra delle notifiche di Android

Quando l'app per Android è in primo piano, nella console di Android Studio viene visualizzato il log "Gestione di un messaggio in primo piano". I contenuti del messaggio vengono visualizzati anche nell'interfaccia utente perché l'interfaccia utente è iscritta al controller dello stream per i nuovi messaggi.

Uno screenshot ritagliato dei contenuti del messaggio visualizzati nell&#39;app per Android

Se incolli il token di registrazione e invii il messaggio dal server dell'app o da un altro ambiente server attendibile, noterai un comportamento simile:

  • Quando l'app web è in background (ovvero quando è nascosta da un'altra finestra o un'altra scheda è attiva), viene visualizzata una notifica web.

Uno screenshot ritagliato di una notifica web mostrata nel browser Chrome

  • Quando l'app web è in primo piano, puoi visualizzare il log nella console di Chrome facendo clic con il tasto destro del mouse sul web e selezionando Inspect. I contenuti del messaggio vengono visualizzati anche nell'interfaccia utente. Uno screenshot ritagliata della Console di Chrome con i log di debug

6. Invia un messaggio relativo all'argomento

La funzionalità di override della piattaforma dell'API HTTP v1 di FCM consente a una richiesta di invio di un messaggio di avere comportamenti diversi su piattaforme diverse. Un caso d'uso di questa funzionalità è visualizzare diversi contenuti dei messaggi di notifica in base alla piattaforma. La funzionalità viene utilizzata in modo particolare quando si sceglie come target più dispositivi (che potrebbero estendersi su più piattaforme) con messaggi incentrati sugli argomenti. Questa sezione illustra i passaggi per fare in modo che la tua app riceva un messaggio dell'argomento personalizzato per ogni piattaforma.

Abbonarsi a un argomento dal client

Per sottoscrivere un argomento, chiama il metodo messaging.subscribeToTopic alla fine della funzione principale nel file main.dart dell'app Flutter.

// subscribe to a topic.
const topic = 'app_promotion';
await messaging.subscribeToTopic(topic);

[Facoltativo] Iscriverti a un argomento dal server per il web

Puoi saltare questa sezione se non stai sviluppando sulla piattaforma web.

Al momento l'SDK FCM JS non supporta la sottoscrizione all'argomento lato client. In alternativa, puoi iscriverti utilizzando l'API di gestione degli argomenti lato server dell'SDK Admin. Questo codice illustra l'iscrizione agli argomenti lato server con l'SDK Java Admin.

 private static void subscribeFcmRegistrationTokensToTopic() throws Exception {
   List<String> registrationTokens =
       Arrays.asList(
           "REPLACE_WITH_FCM_REGISTRATION_TOKEN"); // TODO: add FCM Registration Tokens to
   // subscribe
   String topicName = "app_promotion";

   TopicManagementResponse response =     FirebaseMessaging.getInstance().subscribeToTopic(registrationTokens, topicName);
   System.out.printf("Num tokens successfully subscribed %d", response.getSuccessCount());
 }

Apri il server dell'app e fai clic su Esegui Il pulsante Esegui in Android Studio per eseguire la funzione principale nel file FcmSubscriptionManager.java:

Uno screenshot ritagliato dell&#39;icona Esegui mostrata accanto alla funzione principale FcmSubscriptionManager.java in Android Studio

Invia un messaggio con override della piattaformaa un argomento

Ora puoi inviare un messaggio di override della piattaforma dell'argomento. Nel seguente snippet di codice:

  • Crei una richiesta di invio con un messaggio di base e il titolo "A new app is available".
  • Il messaggio genera una notifica di visualizzazione con il titolo "A new app is available" su piattaforme web e iOS.
  • Il messaggio genera una notifica di visualizzazione con titolo "A new Android app is available" sui dispositivi Android.
private static void sendMessageToFcmTopic() throws Exception {
   String topicName = "app_promotion";

   Message message =
       Message.builder()
           .setNotification(
               Notification.builder()
                   .setTitle("A new app is available")
                   .setBody("Check out our latest app in the app store.")
                   .build())
           .setAndroidConfig(
               AndroidConfig.builder()
                   .setNotification(
                       AndroidNotification.builder()
                           .setTitle("A new Android app is available")
                           .setBody("Our latest app is available on Google Play store")
                           .build())
                   .build())
           .setTopic("app_promotion")
           .build();

   FirebaseMessaging.getInstance().send(message);

   System.out.println("Message to topic sent successfully!!");
 }

Nella funzione principale del file FcmSender.java, riattiva il commento sendMessageToFcmTopic();. Fai clic su Esegui Pulsante Esegui in Android Studio per inviare il messaggio dell'argomento.

7. Riepilogo e passaggi successivi

Ricapitolando, hai appreso come coinvolgere lo sviluppo di app multipiattaforma utilizzando Flutter e FCM, che include la configurazione dell'ambiente, l'integrazione delle dipendenze e la ricezione e l'invio di messaggi. Per approfondire, consulta i seguenti materiali:

Codelab

References