Questa guida introduttiva mostra come configurare la messaggistica in-app di Firebase e inviare il tuo primo messaggio.
Prima di iniziare
Installa e inizializza gli SDK Firebase per Flutter se non lo hai già fatto.
Aggiungi l'SDK di messaggistica in-app Firebase al tuo progetto
Dalla directory principale del tuo progetto Flutter, esegui il seguente comando per installare il plug-in Firebase In-App Messaging:
flutter pub add firebase_in_app_messaging
Ricostruisci il tuo progetto:
flutter run
Importa il plug-in di messaggistica in-app di Firebase:
import 'package:firebase_in_app_messaging/firebase_in_app_messaging.dart';
Invia un messaggio di prova
Ottieni l'ID di installazione della tua app
Per risparmiare energia, la messaggistica in-app di Firebase recupera i messaggi dal server solo una volta al giorno. Ciò può rendere difficile il test, quindi la console Firebase ti consente di specificare un dispositivo di test che visualizza i messaggi su richiesta.
Quel dispositivo di test è determinato da un FID. Trova il FID dell'app di test controllando l'output della console quando esegui l'app.
Su Android, il messaggio è simile al seguente:
I/FIAM.Headless: Starting InAppMessaging runtime with Installation ID YOUR_INSTALLATION_ID
Su iOS, eseguire l'app con l'argomento del comando di runtime -FIRDebugEnabled
:
- Con il progetto Xcode aperto, seleziona Prodotto > Schema > Modifica schema... dalla barra dei menu in alto.
- Apri la scheda Argomenti della finestra di dialogo che si apre.
- Fai clic su + Aggiungi elementi in Argomenti trasmessi all'avvio .
- Immettere "-FIRDebugEnabled" nel campo appena creato.
- Fare clic su Chiudi , quindi eseguire l'app.
Una volta avviata l'esecuzione dell'app, 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 tuo dispositivo di prova
Una volta che hai avviato la tua app sul dispositivo di prova e hai il suo ID di installazione (FID) di Firebase, puoi provare la configurazione della messaggistica in-app di Firebase inviando un messaggio di prova:
- Nella console Firebase, apri Messaggi .
- Se questa è la tua prima campagna, fai clic su Crea la tua prima campagna .
- Seleziona Messaggi in-app Firebase e fai clic su Crea .
- Altrimenti, nella scheda Campagne , fai clic su Nuova campagna .
- Seleziona Messaggi in-app .
- Inserisci un titolo per il tuo primo messaggio.
- Fai clic su Prova sul tuo dispositivo
- Inserisci l'ID di installazione Firebase della tua app nel campo Aggiungi un ID di installazione .
- Fare clic su Prova per inviare il messaggio.
La messaggistica in-app di Firebase invia il tuo messaggio di prova non appena fai clic su Test . Per visualizzare il messaggio, devi chiudere e quindi riaprire l'app sul dispositivo di prova.
Per confermare se il tuo dispositivo è un dispositivo di prova, cerca uno dei seguenti messaggi di registro.
Androide
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.