Questa guida rapida mostra come configurare Firebase In-App Messaging e inviare il primo messaggio.
Prima di iniziare
Installa e inizializza gli SDK Firebase per Flutter, se non l'hai ancora fatto.
Aggiungere l'SDK Firebase In-App Messaging al progetto
Dalla directory principale del progetto Flutter, esegui il seguente comando per installare il plug-in Firebase In-App Messaging:
flutter pub add firebase_in_app_messagingRicostruisci il progetto:
flutter runImporta il plug-in Firebase In-App Messaging:
import 'package:firebase_in_app_messaging/firebase_in_app_messaging.dart';
Invia un messaggio di prova
Ottenere l'ID installazione dell'app
Per risparmiare energia, Firebase In-App Messaging recupera i messaggi dal server solo una volta al giorno. Ciò può rendere difficile il test, pertanto la Console Firebase ti consente di specificare un dispositivo di test che mostri i messaggi su richiesta.
Il dispositivo di test è determinato da un FID. Trova l'ID cliente della tua app di test controllando l'output della console quando esegui l'app.
Su Android, il messaggio è il seguente:
I/FIAM.Headless: Starting InAppMessaging runtime with Installation ID YOUR_INSTALLATION_ID
Su iOS, esegui l'app con l'argomento del comando di runtime -FIRDebugEnabled:
- Con il progetto Xcode aperto, seleziona Product > Scheme > Edit scheme… (Prodotto > Schema > Modifica schema…) dalla barra dei menu in alto.
- Apri la scheda Argomenti della finestra di dialogo visualizzata.
- Fai clic su + Aggiungi elementi in Argomenti passati al momento dell'avvio.
- Inserisci "-FIRDebugEnabled" nel campo appena creato.
- Fai clic su Chiudi e poi esegui l'app.
Quando l'app inizia a funzionare, cerca la seguente riga nei log della console Xcode:
[Firebase/InAppMessaging][I-IAM180017] Starting InAppMessaging runtime with Firebase Installation ID YOUR_INSTALLATION_ID
Invia un messaggio al dispositivo di test
Dopo aver lanciato l'app sul dispositivo di test e aver ottenuto il relativo ID installazione Firebase (FID), puoi provare la configurazione di Firebase In-App Messaging inviando un messaggio di prova:
- Nella console Firebase, apri Messaging.
- Se si tratta della tua prima campagna, fai clic su Crea la tua prima campagna.
- Seleziona Messaggi in-app di Firebase e fai clic su Crea.
- In caso contrario, nella scheda Campagne, fai clic su Nuova campagna.
- Seleziona Messaggistica in-app.
- Inserisci un titolo per il primo messaggio.
- Fai clic su Esegui test sul dispositivo.
- Inserisci l'ID installazione Firebase della tua app nel campo Aggiungi un ID installazione.
- Fai clic su Test per inviare il messaggio.
Firebase In-App Messaging invia il messaggio di prova non appena fai clic su Test. Per visualizzare il messaggio, devi chiudere e riaprire l'app sul dispositivo di test.
Per verificare se il tuo dispositivo è un dispositivo di test, cerca uno dei seguenti messaggi di log.
Android
I/FIAM.Headless: Setting this device as a test device
iOS
[Firebase/InAppMessaging][I-IAM180017] Seeing test message in fetch response. Turn the current instance into a testing instance.