شروع به کار با «پیام‌رسانی درون‌برنامه‌ای 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، از نوار منو بالا، محصول > طرح > ویرایش طرح... را انتخاب کنید.
2. برگه Arguments (استدلال‌ها) را در چارگوش گفتگویی که بالا می‌آید باز کنید.
3. در بخش Arguments Passed On Launch (استدلال‌های ارسال‌شده در زمان راه‌اندازی)، روی + Add items (افزودن موارد) کلیک کنید.
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.