OneSignal से migrate कर रहे हैं? बड़े ऐप में सुरक्षित push SDK migration के 9 tools

छोटे ऐप में OneSignal SDK migration का मतलब है 1 init call और 1 click handler बदलना। बड़े ऐप में OneSignal दर्जनों जगह बैठा होता है: profile module में tags, auth में external user ID, navigation में click handlers, और checkout में कहीं in-app triggers। भारत में जहां ज़्यादातर यूज़र्स Android पर हैं, एक Android पुश नोटिफिकेशन flow टूटने का मतलब है लगभग पूरी audience तक पहुंच खो देना।

इनमें से 1 call भी छूट जाए, तो कुछ crash नहीं होता। Segments चुपचाप बिगड़ते हैं, deep links home screen खोलने लगते हैं, और जो push यूज़र्स को वापस लाता था, वह आना बंद हो जाता है।

यह गाइड 9 tools कवर करती है जो इस swap को सुरक्षित बनाते हैं, migration के 5 steps के हिसाब से: map, replace, test, roll out और monitor।

Provider की तरफ का पूरा काम देखने के लिए हमारी OneSignal से Pushwoosh migration की पूरी गाइड पढ़ें।

बड़े ऐप्स में push SDK migration क्यों टूटता है

Push SDK ज़्यादातर third-party libraries से ज़्यादा codebase को छूता है। आमतौर पर 4 चीज़ें गलत होती हैं:

• बिखरे हुए calls. Tags, external user IDs और click handlers अलग-अलग modules में रहते हैं, कभी-कभी अलग repositories में भी। “OneSignal” के लिए text search साफ़ दिखने वाले calls तो ढूंढ लेता है, पर wrappers छोड़ देता है।
• छिपी dependencies. Analytics events, deep links और A/B tests अक्सर SDK callbacks पर टिके होते हैं। Callback हटाइए, और downstream कोई dashboard flat हो जाता है।
• 2 SDKs, 1 build. 1 ऐप में 2 push SDKs एक ही notification callbacks के लिए आपस में टकराते हैं। इसीलिए Pushwoosh migration गाइड कहती है कि OneSignal SDK उसी release में हटाएं जिसमें नया SDK जोड़ रहे हैं।
• Silent failures. Deliver न हुआ push कोई error नहीं फेंकता। Crash reports साफ़ रहते हैं।

Migration workflow: चरण-दर-चरण

हर step का अपना failure mode है और अपने tools।

सुरक्षित OneSignal SDK migration के लिए 9 tools

Step 1. हर OneSignal call को map करें

1. CodeAlive: बड़े और multi-repo codebases में SDK calls map करने के लिए बेस्ट

CodeAlive AI coding agents को पूरे codebase का सटीक context देता है और उसे ढूंढने में खर्च होने वाले tokens कम करता है। यह 1M+ lines वाले codebases के लिए बना context engine है: semantic search के साथ files, symbols, calls, dependencies और tests का relationship graph, जो MCP और API के ज़रिए मिलता है।

Migration में यह क्या करता है: कोड में कोई बदलाव करने से पहले आप CodeAlive से पूछते हैं कि OneSignal कहां इस्तेमाल हुआ है और उस पर क्या निर्भर है। Relationship graph साफ़ दिखने वाले calls से आगे के calls भी दिखाता है: wrappers, वे callbacks जिन पर analytics टिका है, और वे tests जो SDK को mock करते हैं। यही context उस AI agent को जाता है जो replacement करता है।

मुख्य फीचर्स:

• Hybrid retrieval: semantic search, lexical matching और graph traversal, 1 query में
• हर push पर index refresh, ताकि migration branch आगे बढ़ते हुए भी map अप-टू-डेट रहे
• MCP tools, जिनमें semantic_search, grep_search और chat शामिल हैं, Cursor, Claude Code, Codex, Windsurf, Zed, Continue और Cline के लिए
• AI pull request review जो पूरे system को ध्यान में रखता है
• Git providers: GitHub, GitLab, Bitbucket, Azure DevOps, Gitea। IDEs: VS Code और JetBrains

फायदे:

Step 2. SDK बदलें और audience को move करें

2. Pushwoosh: audience import वाले target platform के लिए बेस्ट

Pushwoosh एक कस्टमर एंगेजमेंट प्लेटफॉर्म है जिसमें push, in-app, email, SMS और WhatsApp हैं। Migration के दौरान Pushwoosh टीम आपकी audience import करती है, जबकि आपके developers नया SDK ship करते हैं।

Migration में यह क्या करता है: iOS, Android और Huawei push tokens import होते हैं और काम करते रहते हैं, क्योंकि tokens आपके ऐप और आपकी keys के होते हैं। Email और SMS subscribers भी import में आ जाते हैं। external_user_id, Pushwoosh User ID पर map होता है (अपने OneSignal export में यह column मांगें, यह default export में नहीं होता), और tags आपके export से दोबारा बनाए जाते हैं। Web push अपवाद है: browser subscriptions को कोई भी provider transfer नहीं कर सकता, इसलिए Pushwoosh Web SDK visitors को चुपचाप re-subscribe करता है।

मुख्य फीचर्स:

• SDKs iOS और Android के लिए, साथ ही React Native, Flutter, Unity, Capacitor, Cordova, MAUI, Expo और भी बहुत कुछ
• Audience import जो SDK release के साथ-साथ चलता है, ताकि यूज़र्स के update करने से पहले ही devices तक पहुंचा जा सके
• Test devices ताकि भेजने से पहले असली device पर push का preview देख सकें

फायदे:

Pricing: push-only plan $7 प्रति 1,000 MAU है, और पहले 1,000 MAU free हैं। अपने मौजूदा bill की तुलना OneSignal cost calculator से करें।

Step 3. Registration और delivery टेस्ट करें

3. Apple Push Notifications Console: APNs के ज़रिए iOS delivery टेस्ट करने के लिए बेस्ट

Push Notifications Console, APNs के ज़रिए test notifications भेजने का Apple का web tool है। जब कोई iOS push नहीं पहुंचता, तो provider को कारण के रूप में खारिज करने का यह तेज़ तरीका है।

Migration में यह क्या करता है: आप सीधे किसी device token पर push भेजते हैं और देखते हैं कि APNs ने उसे accept और deliver किया या नहीं। अगर यहां से push पहुंच जाता है लेकिन नए provider से नहीं, तो पहले provider configuration जांचें।

मुख्य फीचर्स:

• Test notifications किसी device पर, attributes बदलने के बाद resend के साथ
• Delivery logs जो development environment के लिए APNs से होकर notification का रास्ता दिखाते हैं
• Token validation किसी खास environment और push type के लिए
• Delivery metrics test और production notifications के लिए

फायदे:

4. Firebase Cloud Messaging: token से Android pushes टेस्ट करने के लिए बेस्ट

Google Play services वाले devices पर Android pushes, Firebase Cloud Messaging से होकर जाते हैं (Google services के बिना Huawei devices इसकी जगह HMS Push Kit इस्तेमाल करते हैं)। Firebase console 1 registration token पर test message भेज सकता है, जिससे यह Android builds के लिए एक आसान push notification tester बन जाता है। Android-first भारतीय ऐप्स के लिए यही सबसे ज़रूरी check है।

Migration में यह क्या करता है: नया SDK किसी device को register करने के बाद, आप उसका FCM token console में paste करके test भेजते हैं। अगर push पहुंच जाता है, तो token और Firebase setup ठीक हैं।

मुख्य फीचर्स:

• Send test message console से किसी खास FCM registration token पर
• कोई code नहीं चाहिए quick check के लिए, सिवाय device से token पढ़ने के

फायदे:

5. Proxyman: SDK traffic और payloads inspect करने के लिए बेस्ट

Proxyman, macOS, Windows और Linux के लिए एक HTTP debugging proxy है। यह दिखाता है कि push SDK असल में क्या भेजता है: registration calls, user ID updates, tag requests।

Migration में यह क्या करता है: आप नए SDK के साथ ऐप चलाते हैं और उसकी requests देखते हैं। अगर कोई tag device से कभी निकलता ही नहीं, तो आप यहां देख लेते हैं, segment खाली आने से बहुत पहले।

मुख्य फीचर्स:

• HTTPS traffic capture devices, simulators और emulators पर चल रहे ऐप्स से
• One-click iOS Simulator और Android Emulator capture paid plans पर
• Breakpoints और Map Local/Remote requests और responses edit करने के लिए

Step 4. Stages में roll out करें

6. fastlane: staged releases automate करने के लिए बेस्ट

fastlane, iOS और Android deployment automate करने का एक open source platform है। Migration के लिए इसकी value 2 parameters में है, जिन्हें आप अपनी release lane में script कर सकते हैं।

Migration में यह क्या करता है: upload_to_app_store में phased_release: true दिया जाता है, जो update को 7 दिनों में release करता है। upload_to_play_store में rollout value दी जाती है, यानी यूज़र्स का वह हिस्सा जिसे build मिलता है (10% के लिए 0.1; 1 से rollout पूरा होता है)। Migration release हर बार उसी staged रास्ते से जाती है, और कोई checkbox भूलता नहीं।

मुख्य फीचर्स:

• deliver / upload_to_app_store phased_release के साथ
• supply / upload_to_play_store rollout और release_status के साथ (halted सहित)
• 1 lane दोनों stores के लिए

फायदे:

7. App Store phased release और Google Play staged rollouts: नुकसान का दायरा सीमित करने के लिए बेस्ट

दोनों stores पहले आपके यूज़र्स के एक हिस्से तक update भेज सकते हैं। आप कोई भी release tooling इस्तेमाल करें, push SDK swap के लिए यही safety net है। भारत में Android audience बड़ी होने से Google Play staged rollout यहां सबसे अहम लीवर है।

Migration में यह क्या करता है: Pushwoosh वाला नया build यूज़र्स के छोटे हिस्से तक पहुंचता है। अगर deliveries या crash rates गड़बड़ दिखें, तो सब तक पहुंचने से पहले आप rollout रोक देते हैं। इस बीच OneSignal उन यूज़र्स को भेजता रहता है जिन्होंने update नहीं किया, ताकि कोई campaign मिस न हो।

मुख्य फीचर्स:

• App Store: automatic updates वाले यूज़र्स को 7 दिनों में 1%, 2%, 5%, 10%, 20%, 50%, फिर 100% तक release। आप कुल मिलाकर 30 दिनों तक pause कर सकते हैं या किसी भी समय सबके लिए release कर सकते हैं
• Google Play: आप percentage सेट करते हैं और उसे manually बढ़ाते हैं। आप rollout halt और resume कर सकते हैं, और जिन यूज़र्स ने पहले ही update कर लिया, उनके पास build बना रहता है
• Random sampling दोनों stores में यूज़र्स की

फायदे:

Step 5. Crashes और delivery monitor करें

8. Firebase Crashlytics: swap के बाद crashes पकड़ने के लिए बेस्ट

Firebase Crashlytics, Android, Apple, Flutter और Unity ऐप्स से crashes और non-fatal errors report करता है। इसे पूरे rollout के दौरान चलाएं और नए build की तुलना पिछले build से करें।

Migration में यह क्या करता है: notification handler में या SDK init के दौरान crash सबसे पहले यहीं दिखता है। Non-fatal events शांत समस्याओं में मदद करते हैं: push registration fail होने पर non-fatal log करें, और आप उसे हर build के हिसाब से देख पाएंगे।

मुख्य फीचर्स:

• Crash reports issues में grouped, build के हिसाब से filter करने लायक
• Non-fatal events, device पर log होकर अगले app launch पर भेजे जाते हैं
• Official SDKs Android, Apple, Flutter और Unity के लिए

9. Pushwoosh message statistics: silent delivery drops पकड़ने के लिए बेस्ट

Crash reports आपको यह नहीं बताएंगे कि pushes आना बंद हो गए हैं। Pushwoosh push statistics बताएंगे।

Migration में यह क्या करता है: हर push के लिए आप platform के हिसाब से audience से sent, deliveries और opens तक का funnel देखते हैं, साथ में अलग errors tab। Switch के बाद के पहले campaigns की तुलना पहले के अपने OneSignal numbers से करें। अगर iOS deliveries, Android से पीछे हैं, तो code से पहले credentials जांचें।

बड़े ऐप्स के लिए 5-step migration plan

कोड छूने से पहले हर OneSignal call की लिस्ट बनाएं

सभी repositories में हर SDK call, wrapper, callback और test की लिस्ट बनाएं। यही लिस्ट replacement और code review की checklist बनती है।

Push को 1 internal interface के पीछे रखें

हर push call को एक single internal service से route करें: login, logout, tags, notification handling। तब migration 50 call sites की जगह 1 implementation बदलता है, और अगली बार provider बदलना भी आसान हो जाता है।

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

SDKs को 1 release में swap करें

Pushwoosh SDK जोड़ें और OneSignal SDK उसी build में हटाएं। 1 ऐप में 2 push SDKs, notification callbacks के लिए टकराते हैं। जब तक नया build roll out हो रहा है, पुराने version वाले यूज़र्स को OneSignal से भेजते रहें।

Stages में release करें और delivery metrics की तुलना करें

Phased release या staged rollout के ज़रिए यूज़र्स के छोटे हिस्से से शुरुआत करें। Crashlytics में crashes और Pushwoosh statistics में deliveries देखें, फिर rollout बढ़ाएं।

Delivery verify होने के बाद ही OneSignal sends बंद करें

जब तक आप OneSignal से भेजना बंद नहीं करते, rollback का मतलब है OneSignal से भेजते रहना। Pushwoosh delivery और audience import दोनों confirm होने पर ही इसे बंद करें।

FAQ