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

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

قبل البدء

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

إضافة حزمة تطوير البرامج (SDK) لخدمة "المراسلة داخل التطبيق من Firebase" إلى مشروعك

يمكنك استخدام "مدير حزم Swift" لتثبيت اعتماديات Firebase وإدارتها.

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

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

اختَر مكتبة "المراسلة داخل التطبيق".
أضِف العلامة -ObjC إلى القسم علامات الروابط الأخرى في إعدادات إصدار هدفك.
لاستخدام المراسلة داخل التطبيق، يجب تفعيل "إحصاءات Google" في مشروعك على 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" الإصدار 5.6.0 من Firebase أو إصدار أحدث. إذا كنت تواجه مشكلة في تجميع تطبيقك، جرِّب تشغيل pod update في دليل مشروع تطبيقك. مع ذلك، تذكَّر أنّ الأمر يعدّل جميع اعتماديات تطبيقك، وليس فقط اعتمادات Firebase.

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

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

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

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

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

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

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

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

بعد إطلاق تطبيقك على الجهاز الاختباري ولديك رقم تعريف تثبيت Firebase (FID)، يمكنك تجربة إعداد "المراسلة داخل التطبيق من Firebase" عن طريق إرسال رسالة اختبار:

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

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

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

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