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

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


قبل از شروع

اگر قبلاً این کار را نکرده‌اید، Firebase را به پروژه Android خود اضافه کنید.

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

در فایل Gradle (سطح برنامه) واحدتان (معمولاً <project>/<app-module>/build.gradle.kts یا <project>/<app-module>/build.gradle)، وابستگی کتابخانه In-App Messaging را برای Android اضافه کنید. توصیه می‌کنیم از Firebase Android BoM برای کنترل نسخه‌بندی کتابخانه استفاده کنید.

برای استفاده از In-App Messaging، باید Google Analytics را در پروژه Firebase خود فعال کنید و کیت توسعه نرم‌افزار Firebase برای Google Analytics را به برنامه‌تان اضافه کنید. 

dependencies {
    // Import the BoM for the Firebase platform
    implementation(platform("com.google.firebase:firebase-bom:35.1.0"))

    // Add the dependencies for the In-App Messaging and Analytics libraries
    // When using the BoM, you don't specify versions in Firebase library dependencies
    implementation("com.google.firebase:firebase-inappmessaging-display")
    implementation("com.google.firebase:firebase-analytics")
}

بااستفاده از Firebase Android BoM، برنامه شما همیشه از نسخه‌های سازگار کتابخانه‌های Firebase Android استفاده خواهد کرد.

(جایگزین)  افزودن وابستگی‌های کتابخانه Firebase بدون استفاده از BoM

اگر انتخاب کنید که از Firebase BoM استفاده نکنید، باید هر نسخه کتابخانه Firebase را در خط وابستگی آن مشخص کنید.

توجه داشته باشید که اگر از چند کتابخانه Firebase در برنامه‌تان استفاده می‌کنید، اکیداً توصیه می‌کنیم از BoM برای مدیریت نسخه‌های کتابخانه استفاده کنید تا مطمئن شوید همه نسخه‌ها سازگار هستند. 

dependencies {
    // Add the dependencies for the In-App Messaging and Analytics libraries
    // When NOT using the BoM, you must specify versions in Firebase library dependencies
    implementation("com.google.firebase:firebase-inappmessaging-display:23.0.0")
    implementation("com.google.firebase:firebase-analytics:24.0.0")
}

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

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

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

آن دستگاه آزمایشی با FirebaseInstallations ID یا FID تعیین می‌شود. با بررسی Logcat در «استودیو Android» برای گزارش سطح `Info` زیر، FID برنامه آزمایشی‌تان را پیدا کنید:

I/FIAM.Headless: Starting InAppMessaging runtime with 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. برای دیدن پیام در دستگاه آزمایشی، باید برنامه را در دستگاه آزمایشی ببندید و دوباره باز کنید.

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

I/FIAM.Headless: Setting this device as a test device