شارك المقالة
إرسال إشعار لجهاز Flutter من الخادم باستخدام Firebase Admin SDK

إرسال إشعار لجهاز Flutter من الخادم باستخدام Firebase Admin SDK

إرسال إشعار لجهاز Flutter من خادم Node.js باستخدام Firebase Admin SDK، والتحقق من صلاحية المرسل وتوكن الجهاز دون كشف بيانات…

إرسال إشعار لجهاز Flutter من خادم Node.js باستخدام Firebase Admin SDK، والتحقق من صلاحية المرسل وتوكن الجهاز دون كشف بيانات الاعتماد.

الاستهداف باستخدام FID

المثال يستخدم حقل fid في إصدار Firebase Admin SDK الداعم له، ليتوافق مع عميل firebase_messaging 17 بعد تفعيل إعدادات FID وتسجيله. لا تخلط FID المسجل مع OAuth access token الذي يفوض الخادم. حقل token القديم ما زال موجودًا خلال الانتقال لكنه deprecated وفق مرجع الخدمة؛ عند ترقية تطبيق قائم راجع نسختي العميل والخادم قبل تغيير الحقول، ولا تفترض أن قيمة غير مسجلة تصلح هدف إرسال.

افصل استقبال الهاتف عن إرسال الخادم

تطبيق Flutter يحصل على FID الخاص بالتثبيت بعد تسجيله لدى FCM ويرسله إلى خادمك عبر جلسة موثقة. خادمك يختار الجهاز المناسب ويرسل باستخدام Firebase Admin SDK؛ لا توضع بيانات حساب الخدمة في التطبيق. صححنا مثال Legacy الذي استخدم to وServer Key، لأن إرسال FCM الحالي يحتاج واجهة مدعومة وهوية مخولة. التطبيق لا يصبح مرسلًا موثوقًا لمجرد امتلاكه إعداد Firebase العام.

تهيئة هوية الخادم

ثبت firebase-admin في خدمة Node.js، واضبط Application Default Credentials وفق منصة التشغيل. يمكن استخدام هوية مرفقة بالخدمة بدل ملف مفتاح ثابت عندما تتوفر. لا تحمّل JSON خاصًا من مجلد public ولا تضمنه في APK. حدد المشروع وتأكد من الصلاحية اللازمة للإرسال، ثم اختبر على جهاز تجريبي. إذا كان لديك endpoint يستقبل طلب الإرسال، احمه بالمصادقة والتفويض وحدود الطلبات؛ Admin SDK لا يقرر تلقائيًا من يحق له إرسال رسالة لمن.

اختيار الجهاز وحماية التوكن

FID معرّف تثبيت قابل للتغير، وليس معرف مستخدم دائمًا أو دليل ملكية الحساب. خزّن الربط بالحساب على الخادم بعد التحقق من الجلسة، واستمع لأحداث التسجيل وإلغاء التسجيل واحذف الربط عند الخروج عند الحاجة. لا تقبل من عميل غير مخول FID لأي مستخدم ثم ترسل إليه محتوى يختاره العميل. كذلك لا ترسل معلومات شديدة الحساسية في notification قد تظهر على شاشة القفل؛ استخدم تنبيهًا عامًا ثم اجلب التفاصيل بعد التحقق.

الإخفاقات واختبار التسليم

المعرف المعاد من send يعني قبول الطلب، وليس إيصال قراءة. عالج التوكنات غير المسجلة بتنظيف الربط المؤكد أنه غير صالح، ولا تحذفها لكل خطأ شبكة مؤقت. جرّب التطبيق في المقدمة والخلفية والفتح من الإشعار ورفض الإذن. المثال دالة خادم فقط ولا ينشر HTTP endpoint ولا يجهز قاعدة حفظ المعرّفات؛ أضف هذه الأجزاء حسب نموذج صلاحيات مشروعك بدل اعتبار الدالة تطبيق إشعارات كاملًا.

المثال التطبيقي وحدوده

import {initializeApp, applicationDefault} from 'firebase-admin/app';
import {getMessaging} from 'firebase-admin/messaging';

initializeApp({credential: applicationDefault()});
export async function sendDeviceNotification(fid) {
  if (typeof fid !== 'string' || !fid.trim()) {
    throw new TypeError('A registered FID is required');
  }
  return getMessaging().send({
    fid: fid,
    notification: {title: 'تحديث جديد', body: 'افتح التطبيق للاطلاع على التفاصيل'},
    data: {screen: 'updates'},
  });
}
// Call only after checking the sender's authorization and token ownership.

الصور والفيديو من الشرح

المواد المرئية الأصلية محفوظة للرجوع إليها. قد تعرض إصدارًا قديمًا؛ عند الاختلاف اتبع النص والأمثلة المصححة أعلاه، خاصة في خدمات الإشعارات والروابط التي تغيرت.

Headers of FCMBody FCM firebase

مراجع التنفيذ

شاهد أيضًا
مقالات ذات صلة
🚫 مانع الإعلانات مفعل

يجب إيقاف مانع الإعلانات لاستكمال تصفح الموقع