شروع به کار با «پیام‌رسانی درون‌برنامه‌ای Firebase»

این شروع سریع به شما نشان می‌دهد که چگونه Firebase In-App Messaging را راه‌اندازی کنید و اولین پیام خود را ارسال کنید.

قبل از شروع

اگر قبلاً این کار را نکرده‌اید، کیت‌های توسعه نرم‌افزار Firebase برای Flutter را نصب و مقداردهی اولیه کنید.

کیت توسعه نرم‌افزار «پیام‌رسانی درون‌برنامه‌ای Firebase» را به پروژه‌تان اضافه کنید

1. از دایرکتوری ریشه پروژه Flutter، دستور زیر را برای نصب افزایه «پیام‌رسانی درون‌برنامه‌ای Firebase» اجرا کنید:

   flutter pub add firebase_in_app_messaging
   

2. پروژه‌تان را بازسازی کنید:

   flutter run
   

3. افزونه «پیام‌رسانی درون‌برنامه‌ای Firebase» را وارد کنید:

   import 'package:firebase_in_app_messaging/firebase_in_app_messaging.dart';
   

ارسال پیام آزمایشی

دریافت شناسه نصب برنامه

برای صرفه‌جویی در مصرف برق، «پیام‌رسانی درون‌برنامه‌ای Firebase» فقط یک بار در روز پیام‌ها را از سرور بازیابی می‌کند. این امر می‌تواند آزمایش را دشوار کند، بنابراین کنسول 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. برگه آرگومان‌ها را در کادر گفتگویی که باز می‌شود باز کنید.
3. روی + افزودن موارد در زیر آرگومان‌های منتقل‌شده در راه‌اندازی کلیک کنید.
4. در فیلد جدیدی که ایجاد شده است، «-FIRDebugEnabled» را وارد کنید.
5. روی بستن کلیک کنید، سپس برنامه‌تان را اجرا کنید.

وقتی برنامه‌تان شروع به اجرا کرد، خط زیر را در گزارش‌های کنسول Xcode پیدا کنید:

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

ارسال پیام به دستگاه آزمایشی

پس‌از راه‌اندازی برنامه در دستگاه آزمایشی و دریافت شناسه نصب Firebase (FID)، می‌توانید با ارسال پیام آزمایشی، راه‌اندازی «پیام‌رسانی درون‌برنامه‌ای Firebase» را امتحان کنید:

1. در کنسول Firebase، به DevOps و تعامل > پیام‌رسانی بروید.

2. برای راه‌اندازی پویش جدید، گردش کار را راه‌اندازی کنید:

   • اگر این اولین پویش شما است:

     1. روی ایجاد اولین پویش کلیک کنید.
     2. پیام‌های درون‌برنامه‌ای Firebase را انتخاب کنید و روی ایجاد کلیک کنید.

   • اگر قبلاً پویش ایجاد کرده‌اید:

     1. در برگه پویش‌ها، روی پویش جدید کلیک کنید.
     2. پیام‌رسانی درون‌برنامه را انتخاب کنید.

3. عنوانی برای اولین پیامتان وارد کنید.

4. روی آزمایش در دستگاه کلیک کنید.

5. شناسه نصب Firebase برنامه‌تان را در فیلد افزودن شناسه نصب وارد کنید.

6. برای ارسال پیام، روی آزمایش کلیک کنید. بلافاصله ارسال خواهد شد.

7. برای دیدن پیام در دستگاه آزمایشی، باید برنامه را در دستگاه آزمایشی ببندید و دوباره باز کنید.

برای تأیید اینکه دستگاهتان دستگاه آزمایشی است، یکی از پیام‌های ثبت زیر را جستجو کنید.

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.