Ce guide de démarrage rapide vous montre comment configurer Firebase In-App Messaging et envoyer votre premier message.
Avant que tu commences
Installez et initialisez les SDK Firebase pour Flutter si vous ne l'avez pas déjà fait.
Ajoutez le SDK Firebase In-App Messaging à votre projet
Depuis le répertoire racine de votre projet Flutter, exécutez la commande suivante pour installer le plugin Firebase In-App Messaging :
flutter pub add firebase_in_app_messaging
Reconstruisez votre projet :
flutter run
Importez le plug-in Firebase In-App Messaging :
import 'package:firebase_in_app_messaging/firebase_in_app_messaging.dart';
Envoyer un message test
Obtenir l'ID d'installation de votre application
Pour économiser de l'énergie, Firebase In-App Messaging ne récupère les messages du serveur qu'une fois par jour. Cela peut rendre les tests difficiles, c'est pourquoi la console Firebase vous permet de spécifier un appareil de test qui affiche des messages à la demande.
Ce dispositif de test est déterminé par un FID. Trouvez le FID de votre application de test en vérifiant la sortie de la console lorsque vous exécutez votre application.
Sur Android, le message ressemble à ceci :
I/FIAM.Headless: Starting InAppMessaging runtime with Installation ID YOUR_INSTALLATION_ID
Sur iOS, exécutez l'application avec l'argument de commande d'exécution -FIRDebugEnabled
:
- Avec votre projet Xcode ouvert, sélectionnez Produit > Schéma > Modifier le schéma... dans la barre de menus supérieure.
- Ouvrez l'onglet Arguments de la boîte de dialogue qui apparaît.
- Cliquez sur + Ajouter des éléments sous Arguments transmis au lancement .
- Entrez "-FIRDebugEnabled" dans le champ nouvellement créé.
- Cliquez sur Fermer , puis exécutez votre application.
Une fois votre application lancée, recherchez la ligne suivante dans les journaux de la console Xcode :
[Firebase/InAppMessaging][I-IAM180017] Starting InAppMessaging runtime with Firebase Installation ID YOUR_INSTALLATION_ID
Envoyer un message à votre appareil de test
Une fois que vous avez lancé votre application sur l'appareil de test et que vous disposez de son ID d'installation Firebase (FID), vous pouvez tester la configuration de votre messagerie Firebase In-App en envoyant un message de test :
- Dans la console Firebase, ouvrez Messagerie .
- S'il s'agit de votre première campagne, cliquez sur Créer votre première campagne .
- Sélectionnez Messages Firebase In-App et cliquez sur Créer .
- Sinon, dans l'onglet Campagnes , cliquez sur Nouvelle campagne .
- Sélectionnez Messagerie intégrée à l'application .
- Entrez un titre pour votre premier message.
- Cliquez sur Tester sur votre appareil
- Saisissez l'ID d'installation Firebase de votre application dans le champ Ajouter un ID d'installation .
- Cliquez sur Tester pour envoyer le message.
Firebase In-App Messaging envoie votre message de test dès que vous cliquez sur Test . Pour voir le message, vous devez fermer, puis rouvrir l'application sur votre appareil de test.
Pour confirmer si votre appareil est un appareil de test, recherchez l'un des messages de journal suivants.
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.