اختبار إشعارات Firebase في Flutter من Console على جهاز واحد باستخدام register وonRegistered، مع طلب الإذن وفهم الفرق بين وصول الرسالة وعرضها.
التسجيل الحديث في firebase_messaging 17
في الإصدار 17 يستخدم المثال register مع onRegistered للحصول على Firebase Installation ID المسجل لدى FCM، بدل getToken وonTokenRefresh اللذين أصبحا deprecated. اشترك في الحدث قبل register، واحتفظ بالاشتراك لإلغائه مع عمر الخدمة. فعّل firebase_messaging_installation_id_enabled بقيمة true داخل application في AndroidManifest.xml، وعلى Apple فعّل FirebaseMessagingInstallationIdEnabled في Info.plist. أرسل FID لخادمك عبر جلسة موثقة، وحدّث الربط عند تغيره أو إلغاء التسجيل. راجع متطلبات إصدار الحزمة قبل ترقية مشروع قائم.
ابدأ برسالة اختبار واحدة
قبل بناء نظام إرسال آلي، اربط Firebase وأضف firebase_messaging واضبط Android أو APNs وفق المنصة. احصل على FID المسجل للجهاز التجريبي ثم استخدم واجهة الرسائل في Firebase Console لإرسال رسالة اختبار لهذا التثبيت. لا تبدأ بموضوع يشمل كل المستخدمين؛ اختبار جهاز واحد يحدد هل المشكلة في إعداد العميل أم اختيار الجمهور. لا تنشر التوكن في المقال أو سجل عام.
الإذن جزء من التجربة
اطلب permission في وقت يفهم فيه المستخدم فائدته، وتعامل مع denied وprovisional والحالة المتاحة حسب المنصة. رفض الإذن لا يعني أن التطبيق ينبغي أن يتعطل أو يعيد الطلب باستمرار. على Android راجع متطلبات إشعارات النسخة المستهدفة، وعلى iOS تحقق من APNs قبل الاعتماد على FCM token. المقطع التالي لتسجيل الجهاز والحصول على FID من بيئة مجهزة، وليس بديلًا عن إعداد capabilities ومفاتيح APNs.
المقدمة تختلف عن الخلفية
ظهور رسالة في onMessage يثبت الاستقبال في المقدمة، لكنه لا يثبت إعداد local notifications أو قنوات Android أو عرض Apple في المقدمة. إذا اخترت إشعارًا محليًا فجهز الإضافة مرة واحدة وقناة مناسبة وأيقونة صالحة، ولا تهيئها مع كل رسالة. data-only قد لا تحتوي notification، لذا تعامل مع nullable fields بدل استخدام علامة !. لا تضاعف التنبيه بإظهار محلي ونظامي لنفس الحدث.
نتيجة اختبار يمكن تفسيرها
سجل محليًا حالة التطبيق ومعرف رسالة غير حساس ووقت التجربة، ثم جرب المقدمة والخلفية والضغط بعد الإغلاق. راجع وجود أكثر من مستمع إذا تكرر التنبيه، وتطابق المشروع إذا لم يصل. نجاح الإرسال من Console لا يحل تلقائيًا إعداد خادمك أو OAuth، لذلك انتقل لدرس HTTP v1 بعد نجاح العميل. تأكد أيضًا من تحديث معرّف التسجيل وربطه بالحساب الصحيح قبل الاعتماد عليه في منتج منشور.
المثال التطبيقي وحدوده
أضف الحزم المستوردة بإصدارات متوافقة، وهيئ Firebase قبل استخدام خدماته. المقطع يوضح الجزء المذكور في الشرح؛ إعدادات المنصة والقواعد وواجهة الحالات تظل مسؤولية المشروع المستضيف.
import 'dart:async';
import 'package:firebase_messaging/firebase_messaging.dart';
Future<StreamSubscription<String>?> prepareMessagingTest(
void Function(String fid) onRegistered,
void Function(Object error) onError,
) async {
final messaging = FirebaseMessaging.instance;
final settings = await messaging.requestPermission();
if (settings.authorizationStatus == AuthorizationStatus.denied) return null;
// Apple: ensure APNs is ready. Web: supply your configured public VAPID key.
final subscription = messaging.onRegistered.listen(onRegistered, onError: onError);
try {
await messaging.register();
return subscription;
} catch (_) {
await subscription.cancel();
rethrow;
}
}
// The owner stores/cancels the subscription; send FID only to your trusted server.الصور والفيديو من الشرح
المواد المرئية الأصلية محفوظة للرجوع إليها. قد تعرض إصدارًا قديمًا؛ عند الاختلاف اتبع النص والأمثلة المصححة أعلاه، خاصة في خدمات الإشعارات والروابط التي تغيرت.








