بدء استخدام "المراسلة داخل التطبيق من 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، انقر على المنتج (Product) > المخطّط (Scheme) > تعديل المخطّط… (Edit scheme…‎) من شريط القوائم العلوي.
2. افتح علامة التبويب الوسيطات (Arguments) في مربّع الحوار الذي يظهر.
3. انقر على + إضافة عناصر ضمن المَعلمات التي تم تمريرها عند التشغيل.
4. أدخِل "-FIRDebugEnabled" في الحقل الذي تم إنشاؤه حديثًا.
5. انقر على إغلاق، ثم شغِّل تطبيقك.

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

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

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

بعد تشغيل تطبيقك على جهاز الاختبار والحصول على رقم تعريف التثبيت (FID) في Firebase، يمكنك تجربة إعدادات "الرسائل داخل التطبيق من 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.