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

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

قبل البدء

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

إضافة حزمة تطوير البرامج (SDK) Firebase In-App Messaging إلى مشروعك

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

في Xcode، انتقِل إلى File (ملف) > بعد فتح مشروع التطبيق الخاص بك. إضافة حِزم
أضِف مستودع حزمة تطوير البرامج (SDK) لمنصّات Apple من Firebase عندما يُطلب منك ذلك:

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

اختَر مكتبة "In-App Messaging".
أضِف العلامة -ObjC إلى القسم علامات الروابط الأخرى في إعدادات إصدار هدفك.
لاستخدام In-App Messaging، يجب استيفاء الشروط التالية: تفعيل Google Analytics في مشروع Firebase وإضافة حزمة تطوير البرامج (SDK) لمنصّة Firebase الخاصّة بخدمة "إحصاءات Google" إلى تطبيقك. يمكنك اختيار إما في المكتبة بدون جمع معرّف المعلِنين (IDFA) أو من خلال جمع معرّف المعلِنين (IDFA).
عند الانتهاء، سيبدأ Xcode تلقائيًا في حل وتنزيل ملف والتبعيات في الخلفية.

الآن، يمكنك إعداد حزمة SDK في تطبيقك:

استورِد وحدة Firebase في بنية App أو UIApplicationDelegate، إذا لم تكن قد قمت بذلك بعد:
Swift
```
import Firebase
```
Objective-C
```
@import Firebase;
```
يمكنك أيضًا ضبط مثيل مشترَك من FirebaseApp ، عادةً في دالة الإعداد الخاصة بـ App أو في application(_:didFinishLaunchingWithOptions:) الخاصة بوكيل التطبيق، إذا لم يسبق لك إجراء ذلك:
Swift
```
FirebaseApp.configure()
```
Objective-C
```
[FIRApp configure];
```
جمِّع تطبيقك وشغِّله.

ملاحظة: يتطلّب تطبيق Firebase In-App Messaging استخدام الإصدار 5.6.0 من Firebase أو إصدار أحدث. في حال حذف لديك مشكلة في تجميع تطبيقك. يُرجى محاولة تشغيل pod update في دليل المشروع. ضع في اعتبارك مع ذلك أن الأمر يحدِّث جميع تبعيات تطبيقك، وليس فقط أحداث Firebase.

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

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

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

يتم تحديد جهاز الاختبار هذا من خلال رقم تعريف تثبيت Firebase الذي توفّره السمة خدمة عمليات تثبيت Firebase. للعثور على رقم تعريف تثبيت التطبيق الاختباري، شغِّل التطبيق باستخدام وسيطة أمر وقت التشغيل -FIRDebugEnabled:

بعد فتح مشروع Xcode، اختَر المنتج >. المخطط > تعديل المخطط... من شريط القوائم العلوي.
افتح علامة التبويب الوسيطات في مربّع الحوار المنبثق.
انقر على + إضافة عناصر ضمن الوسيطات التي تم تمريرها عند الإطلاق.
أدخِل "-FIRDebugEnabled". في الحقل الذي تم إنشاؤه حديثًا.
انقر على إغلاق، ثم شغِّل تطبيقك.

بعد بدء تشغيل تطبيقك، ابحث عن السطر التالي في سجلات وحدة تحكم Xcode:

[Firebase/InAppMessaging][I-IAM180017] Starting InAppMessaging runtime with Firebase Installation ID YOUR_INSTALLATION_ID

إرسال رسالة إلى جهاز الاختبار

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

في وحدة تحكُّم Firebase، افتح صفحة "المراسلة".
إذا كانت هذه هي حملتك الأولى، فانقر على إنشاء حملتك الأولى.
1. اختَر الرسائل داخل التطبيق من Firebase وانقر على إنشاء.
وبخلاف ذلك، في علامة التبويب الحملات، انقر على حملة جديدة.
1. اختَر المراسلة داخل التطبيق.
أدخِل عنوانًا لرسالتك الأولى.
انقر على الاختبار على الجهاز.
أدخِل رقم تعريف تثبيت Firebase لتطبيقك في حقل إضافة معرّف تثبيت.
انقر على اختبار لإرسال الرسالة.

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

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

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