1- قبل البدء
في هذا الدرس التطبيقي حول الترميز، ستتعلّم كيفية تعزيز التفاعل مع المستخدمين سواء كانوا يستخدمون تطبيقك في المقدّمة أو يعمل في الخلفية.
المتطلبات الأساسية
ما مِن دور
المعلومات التي ستطّلع عليها
- إضافة Firebase إلى تطبيق Android
- إضافة اعتماديات FCM وFIAM
- إرسال رسالة اختبار عبر خدمة "المراسلة عبر السحابة الإلكترونية من Firebase" إلى تطبيقك
- إرسال رسالة اختبار FIAM إلى تطبيقك
المتطلبات
- الإصدار 4.1 من "استوديو Android"
- جهاز Android أو محاكي
2- البدء
الحصول على رمز نموذجي
استنسِخ مستودع GitHub من سطر الأوامر:
استيراد تطبيق إجراء التفعيل
من "استوديو Android"، اختَر دليل codelab-fcm-and-fiam ( 
). سيكون هذا الرمز هو الجهاز الذي تم استنساخه في الخطوة السابقة (ملف > فتح > .../codelab-fcm-and-fiam).
من المفترض أن يكون مشروع FcmAndFiam مفتوحًا في "استوديو Android". إذا ظهر لك تحذير بشأن فقدان ملف google-services.json، لا داعي للقلق. وستتم إضافته في الخطوة التالية.
3- إنشاء مشروع على "وحدة تحكُّم Firebase"
إضافة Firebase إلى المشروع
- انتقِل إلى وحدة تحكُّم Firebase.
- اختَر إضافة مشروع.
- اختَر اسم المشروع أو أدخِله.
- اتّبِع خطوات الإعداد المتبقية في "وحدة تحكُّم Firebase"، ثم انقر على إنشاء مشروع (أو "إضافة Firebase"، إذا كنت تستخدم مشروعًا حاليًا على Google).
- من شاشة النظرة العامة لمشروعك الجديد، انقر على رمز Android لبدء عملية الإعداد.
- أدخِل اسم حزمة الدرس التطبيقي حول الترميز:
com.google.firebase.codelab.fcmandfiam.
إضافة ملف google-services.json إلى تطبيقك
بعد إضافة اسم الحزمة، انقر على تسجيل التطبيق ثم تنزيل google-services.json للحصول على ملف إعداد Firebase Android، ثم انسخ ملف google-services.json إلى دليل app في مشروعك. بعد تنزيل الملف، يمكنك النقر على تخطّي لمعرفة الخطوات التالية المعروضة في وحدة التحكّم (تم تنفيذها لك من قبل في مشروع إنشاء android-start).
إضافة المكوّن الإضافي "خدمات Google" إلى تطبيقك
يستخدم المكوّن الإضافي "خدمات Google" ملف google-services.json لضبط تطبيقك على استخدام Firebase. يجب أن تتم إضافة تبعية المكوّن الإضافي لخدمات Google وكذلك المكوّن الإضافي نفسه إلى ملفات الإصدار على مستوى المشروع والتطبيق على التوالي. يُرجى تأكيد البيانات التالية:
Build.gradle
buildscript {
...
dependencies {
...
classpath 'com.google.gms:google-services:4.3.8'
}
}
app/build.gradle
plugins {
...
id: 'com.google.gms.google-services'
}
إضافة التبعيات
تتطلب كل من "المراسلة عبر السحابة الإلكترونية من Firebase" و"إدارة الهوية وإمكانية الوصول" التبعيات التالية. يجب إضافة هذه التبعيات من قبل إلى ملف الإصدار على مستوى التطبيق. تأكَّد من إضافة التبعيات التالية:
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 في هذه المرحلة. حدد ملف > مزامنة المشروع مع ملفات Gradle من شريط أدوات "استوديو Android"
4. معرّفات السجلّ
تستخدم كل من "المراسلة عبر السحابة الإلكترونية من Firebase" و"المراسلة داخل التطبيق" من Firebase المعرّفات لإرسال الرسائل إلى التطبيقات. تستخدم خدمة "المراسلة عبر السحابة الإلكترونية من Firebase" رمزًا مميّزًا للتسجيل، وتستخدم إدارة الهوية وإمكانية الوصول معرّف تثبيت.
- في
MainActivity.kt، استبدل قائمة المهام بالرمز أدناه لتسجيل المعرّفات اللازمة لإرسال الرسائل:
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)
}
}
- اربط جهاز Android، وانقر على تشغيل (
) في شريط أدوات "استوديو Android". سيؤدي النقر على الزر معرّفات السجلّ إلى تسجيل الرمز المميّز للتسجيل في خدمة "المراسلة عبر السحابة الإلكترونية من Firebase" ورقم تعريف عمليات تثبيت Firebase في سجلّ Logcat. من المفترض أن تبدو النتيجة على النحو التالي:
D/FcmAndFiam: Firebase Installations ID: emMc5...AsJfb
FCM registration token: emMc5LART6GV7...r0Q
5- إرسال رسالة اختبار عبر خدمة "المراسلة عبر السحابة الإلكترونية من Firebase"
يمكن إرسال رسائل المراسلة عبر السحابة الإلكترونية من Firebase من وحدة تحكُّم Firebase ومن واجهة برمجة تطبيقات FCM REST. في هذا الدرس التطبيقي حول الترميز، سننشئ رسالة إشعار عبر خدمة "المراسلة عبر السحابة الإلكترونية من Firebase" ونرسلها إلى جهازنا. رسائل الإشعارات هي تلك التي يتم عرضها في منطقة إشعارات النظام. إرسال رسالة اختبار عبر خدمة "المراسلة عبر السحابة الإلكترونية من Firebase" من خلال:
- التأكّد من تشغيل التطبيق في الخلفية (الانتقال إلى الشاشة الرئيسية)
- انتقِل إلى وحدة تحكُّم Firebase واختَر المراسلة عبر السحابة الإلكترونية في شريط التنقّل الأيمن.
- اختَر إرسال رسالتك الأولى.
- أضِف عنوانًا ونص الرسالة، ثم انقر على إرسال رسالة اختبار
- أضِف الرمز المميّز للتسجيل في خدمة "المراسلة عبر السحابة الإلكترونية من Firebase"، ثم انقر على اختبار.
- تتبُّع الإشعارات المعروضة على الجهاز
- ويؤدي النقر على الإشعار إلى فتح التطبيق.
6- إرسال رسالة اختبار FIAM
يمكن تشغيل ميزة "المراسلة داخل التطبيق من Firebase" نتيجةً لمجموعة متنوعة من أحداث المستخدمين. تستخدِم رسالة الاختبار حدث فتح التطبيق لعرض الرسالة داخل التطبيق. إرسال رسالة اختبار FIAM بواسطة:
- التأكّد من تشغيل التطبيق في الخلفية (الانتقال إلى الشاشة الرئيسية)
- انتقِل إلى "وحدة تحكُّم Firebase" واختَر "المراسلة داخل التطبيق" في شريط التنقّل الأيمن.
- اختَر إنشاء حملتك الأولى
- اختَر حملة البانر العلوي وأدخِل عنوان الرسالة ونصها الأساسي.
- انقر على الاختبار على الجهاز.
- أضِف معرّف عمليات التثبيت وانقر على اختبار.
- إعادة فتح التطبيق
- الملاحظة في رسالة التطبيق
7- تهانينا
تهانينا، لقد تم إرسال رسالتَي "المراسلة عبر السحابة الإلكترونية من Firebase" و"إدارة الهوية وإمكانية الوصول" بنجاح. أنت الآن تعرف كيفية التفاعل مع المستخدمين سواء كانوا يستخدمون تطبيقك في المقدّمة أو يعمل في الخلفية.
قراءة إضافية
الخطوات التالية
- إرسال رسائل إلى المستخدمين في تطبيقك على Android