Ce guide de démarrage rapide vous explique comment configurer Firebase In-App Messaging et envoyer votre premier message.
Avant de commencer
Installez et initialisez les SDK Firebase pour Flutter si vous : ne l'avez pas déjà fait.
Ajouter le SDK Firebase In-App Messaging à votre projet
Dans le répertoire racine de votre projet Flutter, exécutez la commande suivante pour installer le plug-in Firebase In-App Messaging :
flutter pub add firebase_in_app_messaging
Recréez votre projet :
flutter run
Importez le plug-in Firebase Messaging dans l'application :
import 'package:firebase_in_app_messaging/firebase_in_app_messaging.dart';
Envoyer un message de 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 seule fois par jour. Cela peut compliquer les tests. La console Firebase vous permet de spécifier un appareil de test qui affiche les messages à la demande.
Cet appareil de test est déterminé par un FID. Recherchez le FID de votre application de test en consultant la sortie de la console lorsque vous exécutez votre application.
Sur Android, le message se présente comme suit :
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 Product > Scheme > Edit scheme (Produit > Schéma > Modifier le schéma) dans la barre de menu supérieure.
- Ouvrez l'onglet Arguments dans la boîte de dialogue qui s'affiche.
- Cliquez sur + Ajouter des éléments sous Arguments transmis lors du lancement.
- Saisissez "-FIRDebugEnabled". dans le champ que vous venez de créer.
- Cliquez sur Close (Fermer), puis exécutez votre application.
Une fois que votre application démarre, 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 avez ID d'installation Firebase (FID), vous pouvez essayer la messagerie dans l'application Firebase 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 ma première campagne.
- Sélectionnez Messages dans l'application Firebase, puis cliquez sur Créer.
- Sinon, dans l'onglet Campagnes, cliquez sur Nouvelle campagne.
- Sélectionnez In-App Messaging (Messagerie dans l'application).
- Saisissez un titre pour votre premier message.
- Cliquez sur Tester sur votre appareil.
- Saisissez l'ID d'installation Firebase de votre application dans le Champ Add an installation ID (Ajouter un ID d'installation).
- Cliquez sur Tester pour envoyer le message.
La messagerie dans l'application Firebase envoie votre message de test dès que vous cliquez sur Tester. Pour afficher les s'affiche, vous devez fermer, puis rouvrir l'application sur votre appareil de test.
Pour vérifier 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.