ابدأ باستخدام Firebase In-App Messaging

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

قبل ان تبدأ

قم بتثبيت وتهيئة Firebase SDKs for Flutter إذا لم تكن قد قمت بذلك بالفعل.

قم بإضافة Firebase In-App Messaging SDK إلى مشروعك

  1. من الدليل الجذر لمشروع Flutter، قم بتشغيل الأمر التالي لتثبيت البرنامج الإضافي Firebase In-App Messaging:

    flutter pub add firebase_in_app_messaging

  2. أعد بناء مشروعك:

    flutter run

  3. قم باستيراد البرنامج المساعد Firebase In-App Messaging:

    import 'package:firebase_in_app_messaging/firebase_in_app_messaging.dart';

إرسال رسالة اختبار

احصل على معرف تثبيت التطبيق الخاص بك

للحفاظ على الطاقة، تقوم خدمة Firebase In-App Messaging باسترداد الرسائل من الخادم مرة واحدة فقط يوميًا. وهذا يمكن أن يجعل الاختبار صعبًا، لذا تسمح لك وحدة تحكم 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 In-App Messaging عن طريق إرسال رسالة اختبار:

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

ترسل خدمة Firebase In-App Messaging رسالة الاختبار الخاصة بك بمجرد النقر فوق اختبار . لرؤية الرسالة، يتعين عليك إغلاق التطبيق ثم إعادة فتحه على جهاز الاختبار الخاص بك.

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

ذكري المظهر

I/FIAM.Headless: Setting this device as a test device

دائرة الرقابة الداخلية

[Firebase/InAppMessaging][I-IAM180017] Seeing test message in fetch response. Turn the current instance into a testing instance.