תחילת העבודה עם העברת הודעות בתוך האפליקציה ב-Firebase

במדריך למתחילים הזה נסביר איך מגדירים את Firebase In-App Messaging ושולחים את ההודעה הראשונה.

לפני שמתחילים

מתקינים ומפעילים את Firebase SDKs for Flutter, אם עוד לא עשיתם זאת.

הוספת ה-SDK של Firebase ליצירת הודעות בתוך האפליקציה לפרויקט

1. בתיקיית השורש של פרויקט Flutter, מריצים את הפקודה הבאה כדי להתקין את הפלאגין של Firebase In-App Messaging:

   flutter pub add firebase_in_app_messaging
   

2. מריצים מחדש את הפרויקט:

   flutter run
   

3. מייבאים את הפלאגין של העברת הודעות בתוך האפליקציה ב-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 בסביבת זמן הריצה:

1. כשפרויקט Xcode פתוח, בוחרים באפשרות Product > Scheme > Edit scheme… בסרגל התפריטים העליון.
2. פותחים את הכרטיסייה Arguments בתיבת הדו-שיח הקופצת.
3. לוחצים על + הוספת פריטים בקטע Arguments Passed On Launch.
4. מזינים "-FIRDebugEnabled" בשדה החדש שנוצר.
5. לוחצים על סגירה ומפעילים את האפליקציה.

אחרי שהאפליקציה מתחילה לפעול, מחפשים את השורה הבאה ביומני מסוף Xcode:

[Firebase/InAppMessaging][I-IAM180017] Starting InAppMessaging runtime with Firebase Installation ID YOUR_INSTALLATION_ID

שליחת הודעה למכשיר הבדיקה

אחרי שתפעילו את האפליקציה במכשיר הבדיקה ותקבלו את מזהה ההתקנה ב-Firebase‏ (FID), תוכלו לבדוק את ההגדרה של Firebase In-App Messaging על ידי שליחת הודעת בדיקה:

1. במסוף Firebase, פותחים את Messaging.
2. אם זה הקמפיין הראשון שלכם, לוחצים על יצירת הקמפיין הראשון.
   1. בוחרים באפשרות הודעות בתוך האפליקציה של Firebase ולוחצים על יצירה.
3. לחלופין, בכרטיסייה קמפיינים, לוחצים על קמפיין חדש.
   1. בוחרים באפשרות הודעות בתוך האפליקציה.
4. מזינים כותרת להודעה הראשונה.
5. לוחצים על בדיקה במכשיר.
6. מזינים את מזהה ההתקנה של האפליקציה ב-Firebase בשדה Add an installation ID.
7. לוחצים על בדיקה כדי לשלוח את ההודעה.

מערכת העברת ההודעות בתוך האפליקציה ב-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.