استقبال إشعارات FCM في Flutter باستخدام onMessage، ومعالجة رسائل data دون notification وإدارة StreamSubscription ومنع الإشعارات المكررة.
ماذا يحدث في المقدمة؟
عندما تكون واجهة التطبيق مفتوحة يصل الحدث عبر FirebaseMessaging.onMessage، لكن وصوله لا يفرض إظهار إشعار نظام تلقائيًا في كل منصة. افصل بين الاستقبال وبين طريقة العرض: banner داخل الشاشة، أو local notification مجهز، أو تحديث قائمة البيانات دون تنبيه. اختر طريقة واحدة مقصودة حتى لا تعرض رسالة محلية فوق تنبيه النظام في المنصات التي فعلت فيها عرض المقدمة.
بيانات الرسالة قد لا تحتوي notification
RemoteMessage قد تحتوي data فقط؛ لذلك لا تستخدم message.notification! دون فحص. اقرأ مفاتيح data بعد التحقق من النوع والقيم المتوقعة، ولا تفتح رابطًا عشوائيًا أو تنفذ أمرًا بناء على نص وصل من الرسالة وحده. الرسالة إشارة لتحديث البيانات، أما بيانات الحساب الخاصة فيفضل جلبها من خادم موثق. يتعامل المثال مع العنوان الافتراضي ويتجنب طباعة payload كامل قد يتضمن معلومات خاصة.
ملكية المستمع وعمره
أنشئ الاشتراك مرة في خدمة لها عمر معروف أو في initState، ثم ألغِه عند التخلص من المالك. وضع listen داخل build أو كل مرة تدخل فيها الشاشة يكرر استقبال الحدث ويظهر التنبيه عدة مرات. لا تجعل إضافة مستمع جديد حلًا لفقد رسالة قديمة؛ افحص من أنشأ الاشتراك ومن ألغاه. عند ربط الحدث بـ setState تحقق من mounted، وافصل المعالجة عن سياق شاشة قد أغلقت.
حدود المثال والاختبار
المقطع لا يجهز قناة Android أو إضافة local notifications ولا يعالج الضغط على الرسالة بعد إغلاق التطبيق. هذه مسارات منفصلة يغطيها درس حالات التطبيق. اختبر notification مع data ثم data فقط، وأرسل معرف حدث ثابتًا لتتمكن من كشف تكرار التعامل معه عند إعادة التسليم. جرّب رفض إذن الإشعارات وانقطاع الشبكة وتغيير الحساب؛ واجهة المستخدم ينبغي أن تعمل دون افتراض وصول كل إشعار.
المثال التطبيقي وحدوده
أضف الحزم المستوردة بإصدارات متوافقة، وهيئ Firebase قبل استخدام خدماته. المقطع يوضح الجزء المذكور في الشرح؛ إعدادات المنصة والقواعد وواجهة الحالات تظل مسؤولية المشروع المستضيف.
import 'dart:async';
import 'package:firebase_messaging/firebase_messaging.dart';
StreamSubscription<RemoteMessage> listenToForeground(
void Function(String title, Map<String, dynamic> data) onMessage,
) {
return FirebaseMessaging.onMessage.listen((message) {
final title = message.notification?.title ?? 'تحديث جديد';
onMessage(title, message.data);
});
}
// Store the returned subscription and await subscription.cancel() on disposal.الصور والفيديو من الشرح
المواد المرئية الأصلية محفوظة للرجوع إليها. قد تعرض إصدارًا قديمًا؛ عند الاختلاف اتبع النص والأمثلة المصححة أعلاه، خاصة في خدمات الإشعارات والروابط التي تغيرت.









