Catch up on highlights from Firebase at Google I/O 2023. Learn more

ابدأ مع Firebase In-App Messaging

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

قبل ان تبدأ

قم بتثبيت وتهيئة Firebase SDKs لـ 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 ، قم بتشغيل التطبيق باستخدام وسيطة الأمر runtime -FIRDebugEnabled :

  1. مع فتح مشروع Xcode الخاص بك ، حدد المنتج> مخطط> تحرير المخطط ... من شريط القائمة العلوي.
  2. افتح علامة تبويب الوسائط في مربع الحوار المنبثق.
  3. انقر فوق + إضافة عناصر ضمن Arguments Passed On Launch .
  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 داخل التطبيق وانقر على إنشاء .
  3. بخلاف ذلك ، في علامة التبويب الحملات ، انقر فوق حملة جديدة .
    1. حدد المراسلة داخل التطبيق .
  4. أدخل عنوانا لرسالتك الأولى.
  5. انقر فوق اختبار على جهازك
  6. أدخل معرف تثبيت Firebase لتطبيقك في حقل إضافة معرف التثبيت .
  7. انقر فوق اختبار لإرسال الرسالة.

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

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

ذكري المظهر

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.