بدء استخدام "المراسلة داخل التطبيق من 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" تحديد جهاز اختبار يعرض الرسائل عند الطلب.

يتم تحديد جهاز الاختبار من خلال رقم تعريف عملية التثبيت في 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. انقر على + إضافة عناصر (Add items) ضِمن الوسيطات التي تم تمريرها عند التشغيل (Arguments Passed On Launch).
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 & Engagement > المراسلة.

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

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

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

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

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

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

4. انقر على الاختبار على الجهاز.

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.