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

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

قبل از شروع

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

افزودن کیت توسعه نرم‌افزار Firebase In-App Messaging به پروژه

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

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

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

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

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

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

   Swift

   import Firebase

   Objective-C

   @import Firebase;

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

   Swift

   FirebaseApp.configure()

   Objective-C

   [FIRApp configure];

3. برنامه‌تان را کامپایل و اجرا کنید.

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

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

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

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