إعداد إشعارات Firebase في Flutter على iOS باستخدام APNs وطلب الإذن وتسجيل FID عبر 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 إلى جهاز Apple
يستخدم Firebase Cloud Messaging خدمة APNs لتوصيل الرسالة إلى أجهزة Apple. لهذا لا يكفي تثبيت firebase_messaging داخل Flutter؛ يجب تطابق Bundle ID والتوقيع وإعدادات Firebase مع تطبيق Xcode. أضف Push Notifications إلى capabilities، وأضف Background Modes ثم Remote notifications عند الحاجة للرسائل الخلفية. لا تعتبر ظهور FCM token وحده إثباتًا أن كل مسارات الاستقبال تعمل على النسخة المنشورة.
إعداد مفتاح APNs دون تضمينه في التطبيق
يمكن رفع مفتاح APNs بصيغة p8 داخل إعدادات Cloud Messaging لمشروع Firebase مع Key ID وTeam ID الصحيحين. احتفظ بالمفتاح في مكان خاص؛ لا تضعه في assets أو مستودع التطبيق. راجع صلاحيات المفتاح ونطاقه وفق إعداد Apple الحالي بدل افتراض صلاحيته لكل التطبيقات. الشهادات بديل له دورة تجديد مختلفة، واستخدام مفتاح لا يلغي ضرورة ضبط التوقيع وملف provisioning الصحيح.
الإذن والتوكن ليسا خطوة واحدة
اطلب الإذن بعد توضيح فائدته للمستخدم، وتعامل مع الرفض والتفويض المؤقت. قد يتأخر APNs token؛ إذا أعادت getAPNSToken قيمة null فانتظر وأعد المحاولة من مسار مضبوط بدل اعتبارها خطأ نهائيًا أو تكرار الطلب بلا حد. بعد توفره سجل التطبيق واحصل على FID من onRegistered وأرسله عبر اتصال موثق لخادمك. استمع لأحداث التسجيل وإلغاء التسجيل، واحذف ارتباط الجهاز بالحساب عند تسجيل الخروج.
اختبار الخلفية والضغط على الإشعار
ابدأ بجهاز iPhone فعلي ونسخة موقعة، وأرسل رسالة اختبار لجهاز واحد. جرّب المقدمة والخلفية والفتح بالضغط على الرسالة؛ كل حالة لها callback مختلف. لا تتوقع ظهور notification banner في المقدمة دون إعداد presentation المناسب. الرسائل الصامتة تخضع لقرارات النظام ولا توفر تشغيلًا خلفيًا مضمونًا، كما قد يلزم فتح التطبيق مجددًا بعد إغلاقه بالقوة. افحص إعداد Apple وFirebase قبل تغيير كود الواجهة عشوائيًا.
المثال التطبيقي وحدوده
أضف الحزم المستوردة بإصدارات متوافقة، وهيئ Firebase قبل استخدام خدماته. المقطع يوضح الجزء المذكور في الشرح؛ إعدادات المنصة والقواعد وواجهة الحالات تظل مسؤولية المشروع المستضيف.
import 'dart:async';
import 'package:firebase_messaging/firebase_messaging.dart';
Future<StreamSubscription<String>?> registerIosMessaging(
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;
if (await messaging.getAPNSToken() == null) return null;
final subscription = messaging.onRegistered.listen(onRegistered, onError: onError);
try {
await messaging.register();
return subscription;
} catch (_) {
await subscription.cancel();
rethrow;
}
}
// Retain the subscription and cancel it when its owning service is disposed.الصور والفيديو من الشرح
المواد المرئية الأصلية محفوظة للرجوع إليها. قد تعرض إصدارًا قديمًا؛ عند الاختلاف اتبع النص والأمثلة المصححة أعلاه، خاصة في خدمات الإشعارات والروابط التي تغيرت.












