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

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

قبل البدء

ثبِّت حِزم Firebase SDK لـ 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. يمكنك العثور على معرّف مثيل Firebase لتطبيقك الاختباري من خلال التحقّق من مخرجات وحدة التحكّم عند تشغيل تطبيقك.

على أجهزة 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. انقر على إغلاق (Close)، ثم شغِّل تطبيقك.

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

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

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

بعد تشغيل تطبيقك على جهاز الاختبار والحصول على معرّف تثبيت Firebase‏ (FID)، يمكنك تجربة إعداد ميزة "الرسائل داخل التطبيق" في Firebase من خلال إرسال رسالة اختبارية:

1. في وحدة تحكّم Firebase، انتقِل إلى DevOps والتفاعل > المراسلة.

2. ابدأ سير العمل لإعداد حملة جديدة:

   • إذا كانت هذه حملتك الأولى:

     1. انقر على إنشاء حملتك الأولى.
     2. اختَر ميزة "الرسائل داخل التطبيق" في Firebase وانقر على إنشاء.

   • إذا سبق لك إنشاء حملات:

     1. في علامة التبويب الحملات، انقر على حملة جديدة.
     2. اختَر المراسلة داخل التطبيق.

3. أدخِل عنوانًا لرسالتك الأولى.

4. انقر على اختبار على الجهاز (Test on Device).

5. أدخِل معرّف تثبيت Firebase لتطبيقك في حقل إضافة معرّف تثبيت.

6. انقر على اختبار لإرسال الرسالة. سيتم إرسالها على الفور.

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

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

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.