معالجة إشعارات Flutter في الخلفية وعند الإغلاق باستخدام onBackgroundMessage وgetInitialMessage وonMessageOpenedApp دون تنفيذ واجهة من معالج الخلفية.
ثلاث حالات ومساران للضغط
الرسالة في المقدمة تصل عبر onMessage. الضغط على إشعار والتطبيق في الخلفية يمر عادة عبر onMessageOpenedApp، بينما فتحه من حالة منتهية يفحص باستخدام getInitialMessage. لا تعتبر معالج الخلفية بديلًا عن مسارات الضغط والتنقل. حدّد أي خدمة تسجل المستمعين ومتى يجهز Navigator، حتى لا تحاول فتح شاشة قبل اكتمال التهيئة أو تفتحها مرتين بعد إعادة بناء الواجهة.
معالج خلفية مستقل عن الواجهة
يجب أن يكون onBackgroundMessage دالة علوية غير مجهولة، وتضاف pragma الخاصة بنقطة الدخول في الإصدارات المناسبة حتى لا يحذفها تصغير Release. هيئ Firebase داخل المعالج إذا كنت ستستخدم خدماته. لا تستدع showToast أو Navigator أو setState من هذا المسار؛ قد يعمل في isolate منفصل ولا يملك سياق واجهة. أنجز مهمة محدودة سريعة أو احفظ إشارة محلية، ثم اترك الواجهة تتعامل مع النتيجة عند فتحها.
معالجة التنقل بأمان
افحص مفاتيح data وفق قائمة شاشات مسموحة بدل تحويل أي قيمة إلى route. إذا كانت الشاشة خاصة فانتظر حالة تسجيل الدخول ثم اجلب المورد وتحقق من حق المستخدم. استخدم معرف حدث عند الحاجة لمنع تطبيق الأثر مرتين من initial message أو callback آخر. لا تعتمد على الرسالة لتنفيذ تحويل مالي أو تعديل صلاحيات؛ قرار الخادم وبياناته هما المرجع لا نص payload.
قيود النظام والتجربة
التسليم الخلفي ليس مؤقتًا مضمونًا؛ يؤثر نوع الرسالة والأولوية وحالة النظام والإذن وإغلاق التطبيق بالقوة. على Apple قد يلزم إعادة فتح التطبيق بعد سحبه، وعلى Android يمكن أن يتطلب force-stop فتحه من جديد. اختبر نسخة Release وجهازًا فعليًا مع notification وdata، ثم راجع إعدادات المنصة. المثال يعرض معالج الخلفية فقط؛ اجمعه مع مستمع المقدمة ومعالجة ضغط الإشعار في خدمة واحدة ذات عمر واضح.
المثال التطبيقي وحدوده
أضف الحزم المستوردة بإصدارات متوافقة، وهيئ Firebase قبل استخدام خدماته. المقطع يوضح الجزء المذكور في الشرح؛ إعدادات المنصة والقواعد وواجهة الحالات تظل مسؤولية المشروع المستضيف.
import 'package:firebase_core/firebase_core.dart';
import 'package:firebase_messaging/firebase_messaging.dart';
import 'firebase_options.dart';
@pragma('vm:entry-point')
Future<void> messagingBackgroundHandler(RemoteMessage message) async {
await Firebase.initializeApp(options: DefaultFirebaseOptions.currentPlatform);
// Process a short, non-UI task; do not navigate or show a toast here.
}
void registerBackgroundMessaging() {
FirebaseMessaging.onBackgroundMessage(messagingBackgroundHandler);
}
// Register before runApp. Handle notification taps after navigation is ready.الصور والفيديو من الشرح
المواد المرئية الأصلية محفوظة للرجوع إليها. قد تعرض إصدارًا قديمًا؛ عند الاختلاف اتبع النص والأمثلة المصححة أعلاه، خاصة في خدمات الإشعارات والروابط التي تغيرت.








