بدء استخدام "المراسلة داخل التطبيق من Firebase"

يوضّح لك دليل البدء السريع هذا كيفية إعداد Firebase In-App Messaging وإرسال رسالتك الأولى.


قبل البدء

ثبِّت حِزم تطوير البرامج (SDK) لمنصّة Firebase لنظام التشغيل Flutter وابدأ إعدادها إذا لم يسبق لك إجراء ذلك.

إضافة حزمة تطوير البرامج (SDK) لخدمة "المراسلة داخل التطبيق من 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. افتح علامة التبويب الوسيطات في مربع الحوار المنبثق.
  3. انقر على + إضافة عناصر ضمن الوسيطات التي تم تمريرها عند الإطلاق.
  4. أدخِل "-FIRDebugEnabled". في الحقل الذي تم إنشاؤه حديثًا.
  5. انقر على إغلاق، ثم شغِّل تطبيقك.

بعد بدء تشغيل تطبيقك، ابحث عن السطر التالي في سجلات وحدة تحكم Xcode:

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

إرسال رسالة إلى جهاز الاختبار

بعد إطلاق التطبيق على الجهاز الاختباري رقم تعريف تثبيت Firebase (FID)، يمكنك تجربة المراسلة داخل التطبيق على Firebase الإعداد من خلال إرسال رسالة اختبار:

  1. في وحدة تحكّم Firebase، افتح الرسائل.
  2. إذا كانت هذه هي حملتك الأولى، انقر على إنشاء حملتك الأولى.
    1. اختَر رسائل Firebase داخل التطبيق وانقر على إنشاء.
  3. أمّا إذا لم يكن الأمر كذلك، فانقر على حملة جديدة في علامة التبويب الحملات.
    1. اختَر الرسائل داخل التطبيق.
  4. أدخِل عنوانًا لرسالتك الأولى.
  5. انقر على الاختبار على جهازك.
  6. أدخِل رقم تعريف تثبيت تطبيقك على Firebase في الحقل إضافة رقم تعريف تثبيت.
  7. انقر على اختبار لإرسال الرسالة.

ترسل ميزة "المراسلة داخل التطبيق من Firebase" رسالة الاختبار بعد النقر على اختبار. للاطلاع على عليك إغلاق التطبيق ثم إعادة فتحه على الجهاز الاختباري.

للتأكّد مما إذا كان جهازك جهاز اختبار، ابحث عن إحدى رسائل السجلّ التالية:

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.