الانتقال من OneSignal؟ 9 أدوات لترحيل SDK الإشعارات الفورية بأمان في التطبيقات الكبيرة

في التطبيق الصغير، يعني ترحيل OneSignal SDK استبدال استدعاء تهيئة واحد ومعالج نقرات. أما في التطبيق الكبير، فإن OneSignal موجود في عشرات الأماكن: وسوم تُضبط في وحدة الملف الشخصي، ومعرّف مستخدم خارجي في وحدة المصادقة، ومعالجات نقرات في التنقل، ومحفزات رسائل داخل التطبيق في مكان ما من صفحة الدفع.

افتقد واحداً من هذه الاستدعاءات ولن يتعطل شيء. لكن الشرائح تنحرف بصمت، والروابط العميقة تفتح الشاشة الرئيسية، والإشعار الذي كان يعيد المستخدمين يتوقف عن الوصول. وفي أسواق الشرق الأوسط وشمال أفريقيا، حيث تتجاوز حصة Android 70%، يكفي خطأ واحد في جانب Android ليصيب الشريحة الأكبر من جمهورك.

يغطي هذا الدليل 9 أدوات تجعل الاستبدال آمناً، مقسّمة حسب خطوات الترحيل الخمس: الرصد، والاستبدال، والاختبار، والإطلاق، والمراقبة.

أما جانب المزوّد، فراجع دليلنا الكامل للانتقال من OneSignal إلى Pushwoosh.

لماذا يتعطل ترحيل SDK الإشعارات الفورية في التطبيقات الكبيرة

يلمس SDK الإشعارات الفورية جزءاً من الشيفرة أكبر مما تلمسه معظم المكتبات الخارجية. وعادةً ما تسوء 4 أمور:

• استدعاءات متفرقة. الوسوم ومعرّفات المستخدمين الخارجية ومعالجات النقرات موجودة في وحدات مختلفة، وأحياناً في مستودعات مختلفة. البحث النصي عن «OneSignal» يجد الاستدعاءات الواضحة ويفوّت الأغلفة (wrappers).
• اعتماديات مخفية. أحداث التحليلات والروابط العميقة واختبارات A/B كثيراً ما تعتمد على callbacks الخاصة بـ SDK. احذف الـ callback، وستتوقف لوحة بيانات في مكان ما عن التحديث.
• SDK اثنان في بناء واحد. وجود SDK إشعارات اثنين في تطبيق واحد يجعلهما يتنافسان على callbacks الإشعارات نفسها. لهذا يوصي دليل الترحيل إلى Pushwoosh بإزالة OneSignal SDK في الإصدار نفسه الذي يضيف SDK الجديد.
• إخفاقات صامتة. الإشعار الذي لم يصل لا يرمي خطأً. وتقارير الأعطال تبقى نظيفة.

سير عمل الترحيل خطوة بخطوة

لكل خطوة نمط إخفاق خاص بها وأدوات خاصة بها.

9 أدوات لترحيل OneSignal SDK بأمان

الخطوة 1. ارصد كل استدعاء لـ OneSignal

1. CodeAlive: الأفضل لرصد استدعاءات SDK عبر قواعد الشيفرة الكبيرة ومتعددة المستودعات

تمنح CodeAlive وكلاء البرمجة بالذكاء الاصطناعي سياقاً دقيقاً عبر قاعدة الشيفرة كاملة، وتقلّل الرموز التي ينفقونها في البحث عنه. إنها محرك سياق مصمم لقواعد شيفرة تتجاوز مليون سطر: بحث دلالي إضافة إلى رسم بياني للعلاقات بين الملفات والرموز البرمجية والاستدعاءات والاعتماديات والاختبارات، يُقدَّم عبر MCP وAPI.

دورها في الترحيل: قبل أن يعدّل أحد الشيفرة، تسأل CodeAlive أين يُستخدم OneSignal وما الذي يعتمد عليه. يكشف رسم العلاقات استدعاءات تتجاوز الواضحة منها: الأغلفة، والـ callbacks التي تعتمد عليها التحليلات، والاختبارات التي تحاكي SDK. ويذهب السياق نفسه إلى وكيل الذكاء الاصطناعي الذي ينفّذ الاستبدال.

الميزات الأساسية:

• استرجاع هجين: بحث دلالي ومطابقة نصية واجتياز للرسم البياني في استعلام واحد
• تحديث الفهرس مع كل push، فتبقى الخريطة حديثة بينما يتقدم فرع الترحيل
• أدوات MCP، منها semantic_search وgrep_search وchat، لـ Cursor وClaude Code وCodex وWindsurf وZed وContinue وCline
• مراجعة طلبات الدمج بالذكاء الاصطناعي مع مراعاة النظام بأكمله
• مزوّدو Git: GitHub وGitLab وBitbucket وAzure DevOps وGitea. بيئات التطوير: VS Code وJetBrains

الإيجابيات:

الخطوة 2. استبدل SDK وانقل الجمهور

2. Pushwoosh: الأفضل كمنصة مستهدفة مع استيراد الجمهور

Pushwoosh منصة تفاعل العملاء تجمع الإشعارات الفورية والرسائل داخل التطبيق والبريد الإلكتروني وSMS وWhatsApp. وأثناء الترحيل، يستورد فريق Pushwoosh جمهورك بينما يطلق مطوروك SDK الجديد.

دورها في الترحيل: تُستورد رموز الإشعارات على iOS وAndroid وHuawei وتستمر في العمل، لأن الرموز تخص تطبيقك ومفاتيحك. ويُنقل مشتركو البريد الإلكتروني وSMS ضمن الاستيراد أيضاً. ويُربط external_user_id بمعرّف المستخدم User ID في Pushwoosh (اطلب هذا العمود في تصدير OneSignal، فهو غير موجود في التصدير الافتراضي)، وتُعاد إنشاء الوسوم من التصدير. الاستثناء هو إشعارات الويب: لا يمكن لأي مزوّد نقل اشتراكات المتصفح، لذا يعيد Pushwoosh Web SDK اشتراك الزوار بصمت.

الميزات الأساسية:

• SDK لـ iOS وAndroid، إضافة إلى React Native وFlutter وUnity وCapacitor وCordova وMAUI وExpo وغيرها
• استيراد الجمهور بالتوازي مع إصدار SDK، فتبقى الأجهزة قابلة للوصول قبل أن يحدّث المستخدمون التطبيق
• أجهزة اختبار لمعاينة الإشعارات على جهاز حقيقي قبل الإرسال

الإيجابيات:

التسعير: خطة Push only بسعر $7 لكل 1,000 MAU، وأول 1,000 MAU مجاناً. قارن فاتورتك الحالية باستخدام حاسبة تكلفة OneSignal.

الخطوة 3. اختبر التسجيل والوصول

3. Apple Push Notifications Console: الأفضل لاختبار الوصول على iOS عبر APNs

Push Notifications Console أداة ويب من Apple لإرسال إشعارات تجريبية عبر APNs. وهي طريقة سريعة لاستبعاد المزوّد عندما لا يصل إشعار على iOS.

دورها في الترحيل: ترسل إشعاراً مباشرة إلى رمز جهاز وتتحقق مما إذا كان APNs قد قبله وأوصله. إذا وصل من هنا ولم يصل من مزوّدك الجديد، فتحقق من إعدادات المزوّد أولاً.

الميزات الأساسية:

• إشعارات تجريبية إلى جهاز، مع إعادة الإرسال بعد تغيير الخصائص
• سجلات الوصول التي تُظهر مسار الإشعار عبر APNs، لبيئة التطوير
• التحقق من الرموز لبيئة ونوع إشعار محددين
• مقاييس الوصول للإشعارات التجريبية وإشعارات الإنتاج

الإيجابيات:

4. Firebase Cloud Messaging: الأفضل لاختبار إشعارات Android حسب الرمز

تمر إشعارات Android على الأجهزة التي تعمل بخدمات Google Play عبر Firebase Cloud Messaging (أما أجهزة Huawei التي لا تملك خدمات Google فتستخدم HMS Push Kit). ويمكن لـ Firebase console إرسال رسالة تجريبية إلى رمز تسجيل واحد، ما يجعلها أداة بسيطة لاختبار الإشعارات الفورية في إصدارات Android.

دورها في الترحيل: بعد أن يسجّل SDK الجديد جهازاً، تلصق رمز FCM الخاص به في الـ console وترسل اختباراً. إذا وصل، فالرمز وإعداد Firebase سليمان.

الميزات الأساسية:

• Send test message إلى رمز تسجيل FCM محدد من الـ console
• دون شيفرة للفحص السريع، باستثناء قراءة الرمز من الجهاز

الإيجابيات:

5. Proxyman: الأفضل لفحص حركة SDK ومحتوى الطلبات

Proxyman وكيل HTTP لتصحيح الأخطاء على macOS وWindows وLinux. يُظهر ما يرسله SDK الإشعارات فعلياً: استدعاءات التسجيل، وتحديثات معرّف المستخدم، وطلبات الوسوم.

دورها في الترحيل: تشغّل التطبيق مع SDK الجديد وتراقب طلباته. إذا لم يغادر وسمٌ الجهاز أبداً، فستراه هنا، قبل وقت طويل من ظهور شريحة فارغة.

الميزات الأساسية:

• التقاط حركة HTTPS من التطبيقات على الأجهزة والمحاكيات
• التقاط بنقرة واحدة من iOS Simulator وAndroid Emulator في الخطط المدفوعة
• نقاط توقف وMap Local/Remote لتعديل الطلبات والاستجابات

الخطوة 4. أطلق على مراحل

6. fastlane: الأفضل لأتمتة الإصدارات المرحلية

fastlane منصة مفتوحة المصدر لأتمتة نشر تطبيقات iOS وAndroid. وقيمتها في الترحيل تكمن في معاملين يمكنك برمجتهما في مسار الإصدار.

دورها في الترحيل: يقبل upload_to_app_store المعامل phased_release: true، الذي يطلق التحديث على مدى 7 أيام. ويقبل upload_to_play_store قيمة rollout، أي نسبة المستخدمين الذين يحصلون على البناء (0.1 تعني 10%؛ و1 تُكمل الإطلاق). وهكذا يتبع إصدار الترحيل المسار المرحلي نفسه في كل مرة، ولا ينسى أحد خانة الاختيار.

الميزات الأساسية:

• deliver / upload_to_app_store مع phased_release
• supply / upload_to_play_store مع rollout وrelease_status (بما في ذلك halted)
• مسار (lane) واحد للمتجرين

الإيجابيات:

7. App Store phased release وGoogle Play staged rollouts: الأفضل لتقليص نطاق الضرر

يمكن للمتجرين إطلاق التحديث لجزء من المستخدمين أولاً. وأياً كانت أدوات الإصدار التي تستخدمها، فهذه هي شبكة الأمان عند استبدال SDK الإشعارات.

دورها في الترحيل: يصل البناء الجديد مع Pushwoosh إلى نسبة صغيرة من المستخدمين. إذا بدت معدلات الوصول أو الأعطال غير طبيعية، توقف الإطلاق قبل أن يصل إلى الجميع. وفي الأثناء، يواصل OneSignal الإرسال إلى المستخدمين الذين لم يحدّثوا التطبيق، فلا تفوت أحداً أي حملة.

الميزات الأساسية:

• App Store: يُطلق على مدى 7 أيام لـ 1% ثم 2% و5% و10% و20% و50%، ثم 100% من المستخدمين الذين فعّلوا التحديثات التلقائية. يمكنك الإيقاف المؤقت لمدة تصل إلى 30 يوماً إجمالاً أو الإطلاق للجميع في أي وقت
• Google Play: تحدد النسبة وترفعها يدوياً. يمكنك إيقاف الإطلاق واستئنافه، ويحتفظ المستخدمون الذين حدّثوا بالبناء
• اختيار عشوائي للمستخدمين في المتجرين

الإيجابيات:

الخطوة 5. راقب الأعطال والوصول

8. Firebase Crashlytics: الأفضل لرصد الأعطال بعد الاستبدال

تُبلغ Firebase Crashlytics عن الأعطال والأخطاء غير القاتلة في تطبيقات Android وApple وFlutter وUnity. شغّلها طوال فترة الإطلاق وقارن البناء الجديد بالسابق.

دورها في الترحيل: أي عطل في معالج الإشعارات أو أثناء تهيئة SDK يظهر هنا أولاً. وتساعد الأحداث غير القاتلة في المشكلات الأهدأ: سجّل حدثاً غير قاتل عند فشل تسجيل الإشعارات، وستراه لكل بناء.

الميزات الأساسية:

• تقارير الأعطال مجمّعة في مشكلات، مع فلترة حسب البناء
• أحداث غير قاتلة تُسجّل على الجهاز وتُرسل عند التشغيل التالي للتطبيق
• SDK رسمية لـ Android وApple وFlutter وUnity

9. إحصائيات رسائل Pushwoosh: الأفضل لرصد انخفاضات الوصول الصامتة

لن تخبرك تقارير الأعطال بأن الإشعارات توقفت عن الوصول. أما إحصائيات الإشعارات الفورية في Pushwoosh فستخبرك.

دورها في الترحيل: لكل إشعار، ترى المسار من الجمهور إلى الإرسال ثم الوصول والفتح، حسب المنصة، إضافة إلى تبويب منفصل للأخطاء. قارن الحملات الأولى بعد الانتقال بأرقام OneSignal السابقة. إذا تأخر الوصول على iOS عن Android، فتحقق من بيانات الاعتماد قبل أن تتحقق من الشيفرة.

خطة ترحيل من 5 خطوات للتطبيقات الكبيرة

اجرد كل استدعاء لـ OneSignal قبل أن تلمس الشيفرة

أدرج كل استدعاء لـ SDK، وكل غلاف وcallback واختبار، عبر جميع المستودعات. تصبح هذه القائمة قائمة التحقق للاستبدال ولمراجعة الشيفرة.

اجمع الإشعارات خلف واجهة داخلية واحدة

مرّر كل استدعاء للإشعارات عبر خدمة داخلية واحدة: تسجيل الدخول، وتسجيل الخروج، والوسوم، ومعالجة الإشعارات. وبذلك يغيّر الترحيل تنفيذاً واحداً بدلاً من 50 موضع استدعاء، ويصبح تغيير المزوّد التالي أسهل أيضاً.

protocol PushService {
    func login(userId: String)
    func setTags(_ tags: [String: Any])
    func handleNotificationOpen(_ payload: [AnyHashable: Any])
}

استبدل SDK في إصدار واحد

أضف Pushwoosh SDK وأزل OneSignal SDK في البناء نفسه. وجود SDK إشعارات اثنين في تطبيق واحد يجعلهما يتنافسان على callbacks الإشعارات. وأثناء إطلاق البناء الجديد، واصل الإرسال من OneSignal إلى المستخدمين على الإصدار القديم.

أطلق على مراحل وقارن مقاييس الوصول

ابدأ بنسبة صغيرة من المستخدمين عبر phased release أو staged rollout. راقب الأعطال في Crashlytics والوصول في إحصائيات Pushwoosh، ثم وسّع الإطلاق. وإذا تزامن الترحيل مع موسم ذروة مثل رمضان أو الجمعة البيضاء، فخطّط لإكماله قبل بدء الحملات الكبرى.

أوقف الإرسال من OneSignal فقط بعد التحقق من الوصول

إلى أن توقف الإرسال من OneSignal، فإن التراجع يعني ببساطة مواصلة الإرسال منه. أوقفه بعد تأكيد الوصول عبر Pushwoosh واكتمال استيراد الجمهور.

الأسئلة الشائعة