במדריך למתחילים הזה מוסבר איך להגדיר את Firebase In-App Messaging ולשלוח את ההודעה הראשונה.
לפני שמתחילים
מתקינים ומפעילים את ערכות Firebase SDK של Flutter, אם עדיין לא עשו זאת.
מוסיפים לפרויקט את ה-SDK של Firebase להעברת הודעות בתוך האפליקציה
בתיקיית השורש של פרויקט Flutter, מריצים את הפקודה הבאה כדי להתקין את הפלאגין של Firebase In-App Messaging:
flutter pub add firebase_in_app_messaging
בונים מחדש את הפרויקט:
flutter run
מייבאים את הפלאגין של Firebase להעברת הודעות בתוך האפליקציה:
import 'package:firebase_in_app_messaging/firebase_in_app_messaging.dart';
שליחת הודעת בדיקה
אחזור מזהה ההתקנה של האפליקציה
כדי לחסוך בחשמל, Firebase In-App Messaging מאחזר הודעות מהשרת רק פעם ביום. לכן, במסוף Firebase אפשר לציין מכשיר בדיקה שיציג הודעות על פי דרישה.
מכשיר הבדיקה הזה נקבע לפי FID. כדי למצוא את ה-FID של אפליקציית הבדיקה, בודקים את הפלט של המסוף כשמריצים את האפליקציה.
ב-Android, ההודעה נראית כך:
I/FIAM.Headless: Starting InAppMessaging runtime with Installation ID YOUR_INSTALLATION_ID
ב-iOS, מריצים את האפליקציה עם הארגומנט של פקודת זמן הריצה -FIRDebugEnabled
:
- כשפרויקט ה-Xcode פתוח, בוחרים באפשרות מוצר > סכימה > עריכת הסכמה... מתוך בסרגל התפריטים העליון.
- פותחים את הכרטיסייה Arguments בתיבת הדו-שיח הקופצת.
- לוחצים על + הוספת פריטים בקטע ארגומנטים שהועברו בהפעלה.
- מזינים "-FIRDebugEnabled" בשדה החדש שנוצר.
- לוחצים על סגירה ומפעילים את האפליקציה.
אחרי שהאפליקציה תתחיל לפעול, צריך לחפש את השורה הבאה ביומנים של מסוף Xcode:
[Firebase/InAppMessaging][I-IAM180017] Starting InAppMessaging runtime with Firebase Installation ID YOUR_INSTALLATION_ID
שליחת הודעה למכשיר הבדיקה
אחרי שמפעילים את האפליקציה במכשיר הבדיקה, מזהה ההתקנה של Firebase (FID), אפשר לנסות את העברת ההודעות בתוך האפליקציה ב-Firebase על ידי שליחת הודעת בדיקה:
- במסוף Firebase, פותחים את העברת הודעות.
- אם זה הקמפיין הראשון שלכם, לוחצים על יצירת הקמפיין הראשון.
- בוחרים באפשרות הודעות בתוך האפליקציה מ-Firebase ולוחצים על יצירה.
- לחלופין, בכרטיסייה קמפיינים, לוחצים על קמפיין חדש.
- בוחרים באפשרות הודעות בתוך האפליקציה.
- מזינים כותרת להודעה הראשונה.
- לוחצים על בדיקה במכשיר.
- מזינים את מזהה התקנת Firebase של האפליקציה בשדה Add an installation ID (הוספת מזהה התקנה)
- לוחצים על בדיקה כדי לשלוח את ההודעה.
'העברת הודעות בתוך האפליקציה ב-Firebase' שולח את הודעת הבדיקה ברגע שלוחצים על בדיקה. כדי לראות את ההודעה, צריך לסגור את האפליקציה במכשיר הבדיקה ולפתוח אותה מחדש.
כדי לוודא שהמכשיר שלכם הוא מכשיר בדיקה, מחפשים אחת מהודעות היומן הבאות.
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.