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

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

قبل از شروع

قبل‌از شروع، حتماً Firebase را به پروژه Apple خود اضافه کنید.

‫Firebase In-App Messaging SDK را به پروژه‌تان اضافه کنید

از «مدیر بسته Swift» برای نصب و مدیریت وابستگی‌های Firebase استفاده کنید.

1. در Xcode، با باز بودن پروژه برنامه، به File > Add Packages (فایل > افزودن بسته‌ها) پیمایش کنید.
2. وقتی درخواست شد، مخزن کیت توسعه نرم‌افزار پلاتفرم‌های Firebase Apple را اضافه کنید:

  https://github.com/firebase/firebase-ios-sdk.git

3. کتابخانه In-App Messaging را انتخاب کنید.
4. پرچم -ObjC را به بخش پرچم‌های پیونددهنده دیگر در تنظیمات ساخت هدف اضافه کنید.
5. برای استفاده از In-App Messaging، باید ‫Google Analytics را در پروژه Firebase خود فعال کنید و «کیت توسعه نرم‌افزار Firebase برای Google Analytics» را به برنامه‌تان اضافه کنید. می‌توانید کتابخانه را بدون جمع‌آوری «شناسه آگهی‌دهندگان» یا با جمع‌آوری «شناسه آگهی‌دهندگان» انتخاب کنید. «پرسشگان» ما را درباره جدیدترین سازماندهی واحدها در Google Analytics برای کیت توسعه نرم‌افزار Firebase ببینید.
6. پس‌از اتمام، Xcode به‌طور خودکار شروع به حل و بارگیری وابستگی‌های شما در پس‌زمینه می‌کند.

اکنون، کیت توسعه نرم‌افزار را در برنامه‌تان مقداردهی اولیه کنید:

1. اگر هنوز این کار را نکرده‌اید، واحد Firebase را در ساختار App یا UIApplicationDelegate وارد کنید:

   Swift

   import Firebase

   Objective-C

   @import Firebase;

2. همچنین اگر هنوز این کار را نکرده‌اید، یک نمونه هم‌رسانی‌شده را، معمولاً در مقداردهی اولیه App یا در روش application(_:didFinishLaunchingWithOptions:) نماینده برنامه، پیکربندی کنید: FirebaseApp

   Swift

   FirebaseApp.configure()

   Objective-C

   [FIRApp configure];

3. برنامه‌تان را گردآوری و اجرا کنید.

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

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

برای صرفه‌جویی در مصرف انرژی، Firebase In-App Messaging فقط یک‌بار در روز پیام‌ها را از سرور بازیابی می‌کند. این امر می‌تواند آزمایش را دشوار کند، بنابراین کنسول Firebase به شما امکان می‌دهد دستگاه آزمایشی را مشخص کنید که پیام‌ها را به‌درخواست نمایش دهد.

آن دستگاه آزمایش توسط شناسه نصب Firebase ارائه‌شده توسط سرویس نصب Firebase تعیین می‌شود. برای پیدا کردن شناسه نصب برنامه آزمایشی‌تان، برنامه را با آگومان دستور زمان اجرا -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 In-App Messaging راه‌اندازی را امتحان کنید:

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

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

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

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

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

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

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

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

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

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

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

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

[Firebase/InAppMessaging][I-IAM180017] Seeing test message in fetch response. Turn the current instance into a testing instance.