ابدأ مع Firebase In-App Messaging

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

قبل ان تبدأ

قبل البدء ، تأكد من إضافة Firebase إلى مشروع Apple الخاص بك .

أضف Firebase In-App Messaging SDK إلى مشروعك

استخدم Swift Package Manager لتثبيت وإدارة تبعيات Firebase.

1. في Xcode ، مع فتح مشروع التطبيق الخاص بك ، انتقل إلى ملف> إضافة حزم .
2. عند المطالبة ، أضف مستودع SDK لأنظمة Apple الأساسية لـ Firebase:

  https://github.com/firebase/firebase-ios-sdk

3. اختر مكتبة الرسائل داخل التطبيق.
4. لاستخدام المراسلة داخل التطبيق ، يجب عليك تمكين Google Analytics في مشروع Firebase وإضافة Firebase SDK لـ Google Analytics إلى تطبيقك. يمكنك تحديد المكتبة بدون مجموعة IDFA أو مع مجموعة IDFA.
5. عند الانتهاء ، سيبدأ Xcode تلقائيًا في حل وتنزيل التبعيات الخاصة بك في الخلفية.

الآن ، قم بتهيئة SDK في تطبيقك:

1. قم باستيراد وحدة Firebase في بنية App أو UIApplicationDelegate ، إذا لم تكن قد قمت بما يلي:

   سويفت

   import Firebase

   ج موضوعية

   @import Firebase;

2. قم أيضًا بتهيئة مثيل FirebaseApp المشترك ، عادةً في مُهيئ App أو application(_:didFinishLaunchingWithOptions:) ، إذا لم تكن قد قمت بذلك بعد:

   سويفت

   FirebaseApp.configure()

   ج موضوعية

   [FIRApp configure];

3. تجميع وتشغيل التطبيق الخاص بك.

أرسل رسالة تجريبية

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

للحفاظ على الطاقة ، لا يسترد Firebase In-App Messaging سوى الرسائل من الخادم مرة واحدة يوميًا. يمكن أن يجعل هذا الاختبار صعبًا ، لذا تتيح لك وحدة تحكم Firebase تحديد جهاز اختبار يعرض الرسائل عند الطلب.

يتم تحديد جهاز الاختبار هذا من خلال معرف تثبيت Firebase الذي توفره خدمة تثبيت Firebase. للعثور على معرف تثبيت تطبيق الاختبار الخاص بك ، قم بتشغيل التطبيق باستخدام وسيطة الأمر 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 رسالة الاختبار الخاصة بك بمجرد النقر فوق "اختبار" . لرؤية الرسالة ، يجب إغلاق التطبيق ثم إعادة فتحه على جهاز الاختبار الخاص بك.

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

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