استخدم FCM و FIAM لإرسال رسائل إلى المستخدمين

1. قبل أن تبدأ

في مختبر الرموز هذا ، ستتعلم كيفية إضافة القدرة على التفاعل مع المستخدمين سواء كانوا يستخدمون تطبيقك في المقدمة أو في الخلفية.

المتطلبات الأساسية

لا أحد

ماذا ستتعلم

• أضف Firebase إلى تطبيق Android الخاص بك
• أضف تبعيات FCM و FIAM
• إرسال رسالة اختبار FCM إلى التطبيق الخاص بك
• إرسال رسالة اختبار FIAM إلى التطبيق الخاص بك

ماذا ستحتاج

• Android Studio 4.1
• جهاز Android أو المحاكي

2. ابدأ

احصل على نموذج التعليمات البرمجية

استنساخ مستودع GitHub من سطر الأوامر:

قم باستيراد تطبيق المبتدئين

من Android Studio ، حدد دليل codelab-fcm-and-fiam ( ). سيكون هو المستنسخ في الخطوة السابقة ( ملف > فتح > ... / codelab-fcm-and-fiam).

يجب أن يكون لديك الآن مشروع FcmAndFiam مفتوحًا في Android Studio. إذا رأيت تحذيرًا بشأن فقد ملف google-services.json ، فلا داعي للقلق. ستتم إضافته في الخطوة التالية.

3. إنشاء مشروع وحدة تحكم Firebase

أضف Firebase إلى المشروع

1. انتقل إلى وحدة تحكم Firebase .
2. حدد إضافة مشروع .
3. حدد أو أدخل اسم المشروع.
4. اتبع خطوات الإعداد المتبقية في وحدة تحكم Firebase ، ثم انقر على إنشاء مشروع (أو إضافة Firebase ، إذا كنت تستخدم مشروع Google موجودًا).
5. من شاشة النظرة العامة لمشروعك الجديد ، انقر فوق رمز Android لبدء سير عمل الإعداد.
6. أدخل اسم حزمة مختبر الكود: com.google.firebase.codelab.fcmandfiam

أضف ملف google-services.json إلى تطبيقك

بعد إضافة اسم الحزمة ، انقر على تسجيل التطبيق ، ثم قم بتنزيل google-services.json للحصول على ملف تهيئة Firebase Android ، ثم انسخ ملف google-services.json في دليل app في مشروعك. بعد تنزيل الملف ، يمكنك النقر فوق "تخطي" للاطلاع على الخطوات التالية الموضحة في وحدة التحكم (تم تنفيذها بالفعل من أجلك في مشروع build-android-start).

أضف المكوِّن الإضافي لخدمات google إلى تطبيقك

يستخدم المكون الإضافي لخدمات google ملف google-services.json لتهيئة تطبيقك لاستخدام Firebase. يجب بالفعل إضافة تبعية المكون الإضافي لخدمات google والمكوِّن الإضافي نفسه إلى ملفات بناء مستوى المشروع والتطبيق على التوالي. قم بتأكيد الإدخالات التالية:

بناء

buildscript {
  ...
  dependencies {
    ...
    classpath 'com.google.gms:google-services:4.3.8'
  }
}

app / build.gradle

plugins {
  ...
  id: 'com.google.gms.google-services'
}

أضف التبعيات

تتطلب FCM و FIAM التبعيات التالية. يجب إضافة هذه التبعيات بالفعل إلى ملف إنشاء مستوى التطبيق. تأكد من إضافة التبعيات التالية:

app / build.gradle

dependencies {
  ...
  implementation platform('com.google.firebase:firebase-bom:28.4.2')
  implementation 'com.google.firebase:firebase-analytics'
  implementation 'com.google.firebase:firebase-messaging'
  implementation 'com.google.firebase:firebase-inappmessaging-display'
}

مزامنة مشروعك مع ملفات gradle

للتأكد من أن جميع التبعيات متاحة لتطبيقك ، يجب عليك مزامنة مشروعك مع ملفات gradle في هذه المرحلة. حدد File> Sync Project with Gradle Files من شريط أدوات Android Studio.

4. معرفات السجل

يستخدم كل من Firebase Cloud Messaging و Firebase In App Messaging معرّفات لإرسال الرسائل إلى التطبيقات. يستخدم FCM رمزًا مميزًا للتسجيل ويستخدم FIAM معرف التثبيت.

1. في MainActivity.kt استبدل TODO بالكود أدناه لتسجيل المعرفات اللازمة لإرسال الرسائل:

FirebaseMessaging.getInstance().token.addOnCompleteListener { regTokenTask ->
   if (regTokenTask.isSuccessful) {
       Log.d(TAG, "FCM registration token: ${regTokenTask.result}")
   } else {
       Log.e(TAG, "Unable to retrieve registration token",
           regTokenTask.exception)
   }
}
FirebaseInstallations.getInstance().id.addOnCompleteListener { installationIdTask ->
   if (installationIdTask.isSuccessful) {
       Log.d(TAG, "Firebase Installations ID: ${installationIdTask.result}")
   } else {
       Log.e(TAG, "Unable to retrieve installations ID",
           installationIdTask.exception)
   }
}

2. قم بتوصيل جهاز Android الخاص بك ، وانقر فوق تشغيل ( ) في شريط أدوات Android Studio. سيؤدي النقر فوق زر معرفات السجل إلى تسجيل رمز تسجيل FCM ومعرف تثبيت Firebase إلى logcat. يجب أن يبدو الإخراج كما يلي:

D/FcmAndFiam: Firebase Installations ID: emMc5...AsJfb
  FCM registration token: emMc5LART6GV7...r0Q

5. إرسال رسالة اختبار FCM

يمكن إرسال رسائل FCM من وحدة تحكم Firebase ومن واجهة برمجة تطبيقات FCM REST. في مختبر الرموز هذا ، سننشئ رسالة إعلام FCM ونرسلها إلى أجهزتنا. رسائل الإعلام هي تلك التي يتم عرضها في منطقة إعلام النظام. إرسال رسالة اختبار FCM عن طريق:

1. تأكد من أن التطبيق في الخلفية (انتقل إلى الشاشة الرئيسية)
2. انتقل إلى وحدة تحكم Firebase وحدد Cloud Messaging في شريط التنقل الأيسر
3. حدد إرسال رسالتك الأولى
4. أضف عنوانًا ونصًا للرسالة ، ثم انقر على إرسال رسالة اختبار

5. أضف رمز تسجيل FCM ، ثم انقر فوق اختبار

6. مراقبة عرض الإخطار على الجهاز
7. النقر على الإشعار يفتح التطبيق

6. إرسال رسالة اختبار FIAM

يمكن تشغيل Firebase In App Messaging كنتيجة لمجموعة متنوعة من أحداث المستخدم. تستخدم رسالة الاختبار حدث فتح التطبيق لتشغيل رسالة داخل التطبيق. إرسال رسالة اختبار FIAM عن طريق:

1. تأكد من أن التطبيق في الخلفية (انتقل إلى الشاشة الرئيسية)
2. انتقل إلى وحدة تحكم Firebase وحدد المراسلة داخل التطبيق في شريط التنقل الأيمن
3. حدد إنشاء حملتك الأولى
4. حدد حملة لافتة أعلى وأدخل عنوان الرسالة ونصها
5. انقر فوق اختبار على الجهاز

6. أضف معرف التثبيت وانقر فوق اختبار

7. أعد فتح التطبيق
8. لاحظ في رسالة التطبيق

7. مبروك

تهانينا ، لقد نجحت في إرسال رسائل FCM و FIAM. أنت الآن تعرف كيفية التفاعل مع المستخدمين سواء كانوا يستخدمون تطبيقك في المقدمة أو تطبيقك في الخلفية.

قراءة متعمقة

• مستندات Firebase Cloud Messaging
• مستندات Firebase In-App Messaging

ماذا بعد

• أرسل رسائل إلى المستخدمين في تطبيق Android الخاص بك.

مستندات مرجعية

• Firebase Cloud Messaging
• المراسلة داخل تطبيق Firebase