ترحيل Azure Notification Hubs وGoogle Firebase Cloud Messaging

تتوفر الإمكانات الأساسية لتكامل Azure Notification Hubs مع Firebase Cloud Messaging (FCM) v1. للتذكير، ستتوقف Google عن دعم FCM القديم HTTP في 20 يونيو 2024، لذلك يجب عليك ترحيل تطبيقاتك وحمولة الإعلامات إلى التنسيق الجديد قبل ذلك.

هام

اعتبارا من يونيو 2024، لن يتم دعم واجهات برمجة التطبيقات القديمة FCM وسيتم إيقافها. لتجنب أي تعطيل في خدمة الإعلامات المؤقتة، يجب الترحيل إلى بروتوكول FCM v1 في أقرب وقت ممكن.

مفاهيم FCM v1

  • يتم دعم نوع نظام أساسي جديد، يسمى FCM v1.
  • يتم استخدام واجهات برمجة التطبيقات الجديدة وبيانات الاعتماد والتسجيلات والتثبيتات ل FCM v1.

خطوات الترحيل

سيتم إهمال واجهة برمجة التطبيقات القديمة Firebase Cloud Messaging (FCM) بحلول يوليو 2024. يمكنك البدء في الترحيل من بروتوكول HTTP القديم إلى FCM v1 الآن. يجب إكمال الترحيل بحلول يونيو 2024.

الأسئلة المتداولة

يوفر هذا القسم إجابات على الأسئلة المتداولة حول الترحيل من FCM القديم إلى FCM v1.

كيف أعمل إنشاء تسجيلات قالب FCM v1 باستخدام SDKs أو واجهات برمجة تطبيقات REST؟

للحصول على إرشادات حول كيفية إنشاء تسجيلات قالب FCM v1، راجع Azure Notification Hubs وترحيل Google Firebase Cloud Messaging (FCM) باستخدام SDKs.

هل أحتاج إلى تخزين كل من بيانات اعتماد FCM القديمة وبيانات اعتماد FCM v1؟

نعم، يتم التعامل مع FCM القديم وFCM v1 كمنصة منفصلة في Azure Notification Hubs، لذلك يجب تخزين كل من بيانات اعتماد FCM القديمة وFCM v1 بشكل منفصل. لمزيد من المعلومات، راجع الإرشادات لإعداد بيانات الاعتماد.

كيف يمكنني التحقق من أن عمليات الإرسال تمر عبر البنية الأساسية لبرنامج ربط العمليات التجارية FCM v1 بدلا من البنية الأساسية لبرنامج ربط العمليات التجارية القديمة FCM؟

تحتوي استجابة إرسال تتبع الأخطاء على خاصية results ، وهي صفيف من نتائج التسجيل لإرسال تتبع الأخطاء. تحدد كل نتيجة تسجيل النظام الأساسي للتطبيق. بالإضافة إلى ذلك، نقدم بيانات تتبع الاستخدام لكل رسالة لمراكز إعلام المستوى القياسي. ميزات GcmOutcomeCounts بيانات تتبع الاستخدام هذه و FcmV1OutcomeCounts، والتي يمكن أن تساعدك في التحقق من النظام الأساسي المستخدم لعمليات الإرسال.

هل أحتاج إلى إنشاء تسجيلات جديدة ل FCM v1؟

نعم، ولكن يمكنك استخدام الاستيراد/التصدير. بمجرد تحديث SDK للعميل، فإنه ينشئ رموزا مميزة للجهاز لتسجيلات FCM v1.

تشير وثائق Google Firebase إلى أنه لا يلزم إجراء تغييرات من جانب العميل. هل أحتاج إلى إجراء أي تغييرات في مراكز الإعلامات لضمان إرسال إعلاماتي من خلال FCM v1؟

بالنسبة لعمليات الإرسال المباشر، لا توجد تغييرات خاصة بمراكز الإعلامات يجب إجراؤها على جهاز العميل. إذا قمت بتخزين عمليات التثبيت أو التسجيلات باستخدام Azure Notification Hubs، فيجب عليك إعلام مراكز الإعلامات بأنك تريد الاستماع إلى النظام الأساسي الذي تم ترحيله (FCM v1). بغض النظر عما إذا كنت تستخدم مراكز الإعلامات أو Firebase مباشرة، يلزم إجراء تغييرات على البيانات الأساسية. راجع الوثائق حول كيفية الترحيل إلى FCM v1.

تظهر ملاحظات PNS "خطأ غير معروف" عند إرسال رسالة FCM v1. ماذا يجب أن أفعل لإصلاح هذا الخطأ؟

تعمل Azure Notification Hubs على حل يقلل من عدد مرات ظهور "خطأ غير معروف". في غضون ذلك، يمكن لعملاء المستوى القياسي استخدام واجهة برمجة تطبيقات ملاحظات الإعلام لفحص الاستجابات.

كيف يمكن لعملاء Xamarin الترحيل إلى FCM v1؟

تم إهمال Xamarin الآن ويجب على عملاء Xamarin الترحيل إلى واجهة مستخدم التطبيق متعددة الأنظمة الأساسية .NET (.NET MAUI). بينما لا يتم توفير Azure Notification Hub SDKs محددة ل .NET ل Android و.NET لنظام التشغيل iOS و.NET MAUI، يمكن استخدام .NET SDK بواسطة التطبيقات التي تم إنشاؤها باستخدام .NET، بما في ذلك .NET MAUI. لمزيد من المعلومات، بما في ذلك إرسال إشعارات الدفع إلى تطبيق .NET MAUI عبر FCM v1، راجع إرسال إشعارات الدفع إلى تطبيقات .NET MAUI باستخدام Azure Notification Hubs عبر خدمة خلفية.

الخطوات التالية