این آموزش سریع به شما نشان می‌دهد که چگونه Firebase In-App Messaging راه‌اندازی کنید و اولین پیام خود را ارسال کنید.
قبل از اینکه شروع کنی
اگر قبلاً SDK های Firebase را برای Flutter نصب و مقداردهی اولیه نکرده‌اید، این کار را انجام دهید.
کیت توسعه نرم‌افزاری پیام‌رسان درون‌برنامه‌ای فایربیس را به پروژه خود اضافه کنید.
از دایرکتوری ریشه پروژه Flutter خود، دستور زیر را برای نصب افزونه Firebase In-App Messaging اجرا کنید:
flutter pub add firebase_in_app_messagingپروژه خود را بازسازی کنید:
flutter runافزونه پیام‌رسانی درون‌برنامه‌ای فایربیس را وارد کنید:
import 'package:firebase_in_app_messaging/firebase_in_app_messaging.dart';
ارسال پیام آزمایشی
شناسه نصب برنامه خود را دریافت کنید
برای صرفه‌جویی در مصرف برق، پیام‌رسانی درون‌برنامه‌ای فایربیس فقط یک بار در روز پیام‌ها را از سرور دریافت می‌کند. این امر می‌تواند آزمایش را دشوار کند، بنابراین کنسول فایربیس به شما امکان می‌دهد یک دستگاه آزمایشی را مشخص کنید که پیام‌ها را در صورت تقاضا نمایش دهد.
دستگاه تست توسط یک FID تعیین می‌شود. FID برنامه تست خود را با بررسی خروجی کنسول هنگام اجرای برنامه پیدا کنید.
در اندروید، پیام به شکل زیر است:
I/FIAM.Headless: Starting InAppMessaging runtime with Installation ID YOUR_INSTALLATION_ID
در iOS، برنامه را با آرگومان دستور runtime -FIRDebugEnabled اجرا کنید:
- با باز کردن پروژه Xcode خود، از نوار منوی بالا، گزینه Product > Scheme > Edit scheme... را انتخاب کنید.
- برگه آرگومان‌ها را از کادر محاوره‌ای که ظاهر می‌شود، باز کنید.
- روی «افزودن موارد» در زیر آرگومان‌های ارسالی هنگام اجرا کلیک کنید.
- در فیلد تازه ایجاد شده، عبارت "-FIRDebugEnabled" را وارد کنید.
- روی بستن کلیک کنید، سپس برنامه خود را اجرا کنید.
پس از شروع اجرای برنامه، در لاگ‌های کنسول Xcode به دنبال خط زیر بگردید:
[Firebase/InAppMessaging][I-IAM180017] Starting InAppMessaging runtime with Firebase Installation ID YOUR_INSTALLATION_ID
ارسال پیام به دستگاه تست شما
پس از اینکه برنامه خود را روی دستگاه آزمایشی اجرا کردید و شناسه نصب Firebase (FID) آن را داشتید، می‌توانید با ارسال یک پیام آزمایشی، تنظیمات پیام‌رسانی درون‌برنامه‌ای Firebase خود را امتحان کنید:
- در کنسول Firebase ، Messaging را باز کنید.
- اگر این اولین کمپین شماست، روی «ایجاد اولین کمپین» کلیک کنید.
- پیام‌های درون‌برنامه‌ای فایربیس را انتخاب کنید و روی ایجاد کلیک کنید.
- در غیر این صورت، در برگه کمپین‌ها ، روی کمپین جدید کلیک کنید.
- پیام‌رسانی درون‌برنامه‌ای را انتخاب کنید.
- برای اولین پیام خود یک عنوان وارد کنید.
- روی تست روی دستگاه خود کلیک کنید
- شناسه نصب Firebase برنامه خود را در فیلد «افزودن شناسه نصب» وارد کنید.
- برای ارسال پیام، روی «تست» کلیک کنید.
پیام‌رسانی درون‌برنامه‌ای فایربیس، پیام آزمایشی شما را به محض کلیک روی «تست» ارسال می‌کند. برای دیدن پیام، باید برنامه را در دستگاه آزمایشی خود ببندید و دوباره باز کنید.
برای تأیید اینکه آیا دستگاه شما یک دستگاه آزمایشی است، به دنبال یکی از پیام‌های گزارش زیر باشید.
اندروید
I/FIAM.Headless: Setting this device as a test device
آی‌او‌اس
[Firebase/InAppMessaging][I-IAM180017] Seeing test message in fetch response. Turn the current instance into a testing instance.