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

توضّح لك هذه البداية السريعة كيفية إعداد ميزة "المراسلة داخل التطبيق على Firebase" وإرسال رسالتك الأولى.

قبل البدء

تثبيت حِزم تطوير البرامج (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.