Weg von OneSignal? 9 Tools für eine sichere Push-SDK-Migration in großen Apps

In einer kleinen App bedeutet eine OneSignal SDK Migration, 1 Init-Aufruf und einen Click-Handler auszutauschen. In einer großen App steckt OneSignal an Dutzenden Stellen: Tags im Profilmodul, eine External User ID in der Authentifizierung, Click-Handler in der Navigation, In-App-Trigger irgendwo im Checkout.

Übersehen Sie 1 dieser Aufrufe, stürzt nichts ab. Segmente verschieben sich unbemerkt, Deep Links öffnen den Startbildschirm, und der Push, der Nutzer bisher zurückgeholt hat, kommt nicht mehr an.

Für Teams im DACH-Raum ist ein Anbieterwechsel zudem eine Datenschutzentscheidung: Mit dem Push-Dienst ändern sich auch der Ort der Datenverarbeitung und der Auftragsverarbeitungsvertrag. Dieser Leitfaden stellt 9 Tools vor, die den Wechsel absichern, gegliedert nach den 5 Schritten einer Migration: erfassen, ersetzen, testen, ausrollen und überwachen.

Die Anbieterseite behandelt unser vollständiger Leitfaden zur Migration von OneSignal zu Pushwoosh.

Warum Push-SDK-Migrationen in großen Apps scheitern

Ein Push SDK berührt mehr Code als die meisten Drittanbieter-Bibliotheken. Typischerweise gehen 4 Dinge schief:

• Verstreute Aufrufe. Tags, External User IDs und Click-Handler liegen in unterschiedlichen Modulen, teils in unterschiedlichen Repositories. Eine Textsuche nach „OneSignal” findet die offensichtlichen Stellen und übersieht Wrapper.
• Versteckte Abhängigkeiten. Analytics-Events, Deep Links und A/B-Tests hängen oft an SDK-Callbacks. Entfernen Sie den Callback, flacht ein nachgelagertes Dashboard ab.
• 2 SDKs, 1 Build. 2 Push SDKs in 1 App konkurrieren um dieselben Notification-Callbacks. Deshalb empfiehlt der Pushwoosh-Migrationsleitfaden, das OneSignal SDK im selben Release zu entfernen, in dem das neue hinzukommt.
• Stille Fehler. Ein nicht zugestellter Push wirft keinen Fehler. Die Crash-Reports bleiben sauber.

Der Migrationsablauf Schritt für Schritt

Jeder Schritt hat sein eigenes Fehlerrisiko und seine eigenen Tools.

9 Tools für eine sichere OneSignal SDK Migration

Schritt 1. Jeden OneSignal-Aufruf erfassen

1. CodeAlive: ideal, um SDK-Aufrufe in großen Codebasen und über mehrere Repositories hinweg zu erfassen

CodeAlive liefert KI-Coding-Agenten präzisen Kontext über die gesamte Codebasis und reduziert die Tokens, die sie für die Suche danach verbrauchen. Es ist eine Context Engine für Codebasen ab 1 Mio. Zeilen: semantische Suche plus ein Beziehungsgraph aus Dateien, Symbolen, Aufrufen, Abhängigkeiten und Tests, bereitgestellt über MCP und API.

Was es bei der Migration leistet: Bevor jemand Code ändert, fragen Sie CodeAlive, wo OneSignal verwendet wird und was davon abhängt. Der Beziehungsgraph zeigt auch Aufrufe jenseits der offensichtlichen: Wrapper, Callbacks, an denen Analytics hängt, Tests, die das SDK mocken. Derselbe Kontext geht an den KI-Agenten, der den Austausch vornimmt.

Wichtige Funktionen:

• Hybride Suche: semantische Suche, lexikalischer Abgleich und Graph-Traversierung in 1 Abfrage
• Index wird bei jedem Push aktualisiert, sodass die Übersicht aktuell bleibt, während sich der Migrations-Branch weiterentwickelt
• MCP-Tools, darunter semantic_search, grep_search und chat, für Cursor, Claude Code, Codex, Windsurf, Zed, Continue und Cline
• KI-gestütztes Pull-Request-Review, das das gesamte System berücksichtigt
• Git-Anbieter: GitHub, GitLab, Bitbucket, Azure DevOps, Gitea. IDEs: VS Code und JetBrains

Vorteile:

Schritt 2. SDK ersetzen und Zielgruppe übertragen

2. Pushwoosh: ideal als Zielplattform mit Zielgruppenimport

Pushwoosh ist eine Plattform für Kundenbindung mit Push, In-App, E-Mail, SMS und WhatsApp. Bei einer Migration importiert das Pushwoosh-Team Ihre Zielgruppe, während Ihre Entwickler das neue SDK ausliefern. Für Teams mit Datenschutzanforderungen relevant: Pushwoosh ist DSGVO-konform, nach ISO 27001:2022 und SOC 2 Type II zertifiziert und betreibt Rechenzentren in der EU und den USA.

Was es bei der Migration leistet: Push Tokens für iOS, Android und Huawei werden importiert und funktionieren weiter, denn Tokens gehören zu Ihrer App und Ihren Schlüsseln. E-Mail- und SMS-Abonnenten werden ebenfalls importiert. Die external_user_id wird der Pushwoosh User ID zugeordnet (fordern Sie diese Spalte in Ihrem OneSignal-Export an, im Standardexport fehlt sie), und Tags werden aus Ihrem Export neu angelegt. Die Ausnahme ist Web Push: Browser-Abonnements kann kein Anbieter übertragen, daher meldet das Pushwoosh Web SDK Besucher im Hintergrund erneut an.

Wichtige Funktionen:

• SDKs für iOS und Android sowie React Native, Flutter, Unity, Capacitor, Cordova, MAUI, Expo und weitere
• Zielgruppenimport parallel zum SDK-Release, sodass Geräte erreichbar sind, bevor Nutzer aktualisieren
• Testgeräte, um Pushes vor dem Versand auf einem echten Gerät zu prüfen

Vorteile:

Preise: Der Push-only-Tarif kostet 7 $ pro 1.000 MAU, die ersten 1.000 MAU sind kostenlos. Vergleichen Sie Ihre aktuelle Rechnung mit dem OneSignal-Kostenrechner.

Schritt 3. Registrierung und Zustellung testen

3. Apple Push Notifications Console: ideal, um die iOS-Zustellung über APNs zu testen

Die Push Notifications Console ist Apples Web-Tool zum Senden von Testbenachrichtigungen über APNs. Damit schließen Sie schnell den Anbieter als Ursache aus, wenn ein iOS-Push nicht ankommt.

Was es bei der Migration leistet: Sie senden einen Push direkt an ein Device Token und prüfen, ob APNs ihn angenommen und zugestellt hat. Kommt er hier an, aber nicht über Ihren neuen Anbieter, prüfen Sie zuerst die Konfiguration beim Anbieter.

Wichtige Funktionen:

• Testbenachrichtigungen an ein Gerät, mit erneutem Senden nach Änderung der Attribute
• Zustellungslogs, die den Weg einer Benachrichtigung durch APNs zeigen, für die Entwicklungsumgebung
• Token-Validierung für eine bestimmte Umgebung und einen bestimmten Push-Typ
• Zustellungsmetriken für Test- und Produktionsbenachrichtigungen

Vorteile:

4. Firebase Cloud Messaging: ideal, um Android-Pushes per Token zu testen

Android-Pushes auf Geräten mit Google Play-Diensten laufen über Firebase Cloud Messaging (Huawei-Geräte ohne Google-Dienste nutzen stattdessen HMS Push Kit). Die Firebase Console kann eine Testnachricht an 1 Registration Token senden und ist damit ein einfacher Push-Tester für Android-Builds.

Was es bei der Migration leistet: Nachdem das neue SDK ein Gerät registriert hat, fügen Sie dessen FCM Token in die Console ein und senden einen Test. Kommt er an, sind Token und Firebase-Setup in Ordnung.

Wichtige Funktionen:

• Testnachricht senden an ein bestimmtes FCM Registration Token direkt aus der Console
• Kein Code nötig für eine schnelle Prüfung, abgesehen vom Auslesen des Tokens auf dem Gerät

Vorteile:

5. Proxyman: ideal, um SDK-Traffic und Payloads zu untersuchen

Proxyman ist ein HTTP-Debugging-Proxy für macOS, Windows und Linux. Er zeigt, was das Push SDK tatsächlich sendet: Registrierungsaufrufe, User-ID-Updates, Tag-Anfragen.

Was es bei der Migration leistet: Sie starten die App mit dem neuen SDK und beobachten deren Requests. Verlässt ein Tag das Gerät nie, sehen Sie das hier, lange bevor ein Segment leer bleibt.

Wichtige Funktionen:

• Mitschnitt von HTTPS-Traffic aus Apps auf Geräten, Simulatoren und Emulatoren
• Mitschnitt von iOS Simulator und Android Emulator per Klick in den kostenpflichtigen Tarifen
• Breakpoints und Map Local/Remote, um Requests und Responses zu bearbeiten

Schritt 4. Stufenweise ausrollen

6. fastlane: ideal, um gestaffelte Releases zu automatisieren

fastlane ist eine Open-Source-Plattform zur Automatisierung von iOS- und Android-Deployments. Für eine Migration liegt ihr Wert in 2 Parametern, die Sie in Ihre Release-Lane schreiben können.

Was es bei der Migration leistet: upload_to_app_store akzeptiert phased_release: true, wodurch das Update über 7 Tage ausgerollt wird. upload_to_play_store akzeptiert einen rollout-Wert, also den Anteil der Nutzer, die den Build erhalten (0.1 für 10 %; 1 schließt den Rollout ab). Das Migrations-Release folgt so jedes Mal demselben gestaffelten Weg, und niemand vergisst das Häkchen.

Wichtige Funktionen:

• deliver / upload_to_app_store mit phased_release
• supply / upload_to_play_store mit rollout und release_status (einschließlich halted)
• 1 Lane für beide Stores

Vorteile:

7. App Store Phased Release und Google Play Staged Rollouts: ideal, um den Schadensradius zu begrenzen

Beide Stores können ein Update zunächst an einen Teil Ihrer Nutzer ausliefern. Unabhängig von Ihren Release-Tools ist das das Sicherheitsnetz beim Wechsel des Push SDK.

Was es bei der Migration leistet: Der neue Build mit Pushwoosh erreicht einen kleinen Teil der Nutzer. Sehen Zustellungen oder Absturzraten auffällig aus, stoppen Sie den Rollout, bevor er alle erreicht. In der Zwischenzeit sendet OneSignal weiter an Nutzer, die noch nicht aktualisiert haben, sodass niemand eine Kampagne verpasst.

Wichtige Funktionen:

• App Store: Auslieferung über 7 Tage an 1 %, 2 %, 5 %, 10 %, 20 %, 50 % und dann 100 % der Nutzer mit automatischen Updates. Sie können insgesamt bis zu 30 Tage pausieren oder jederzeit an alle freigeben
• Google Play: Sie legen den Prozentsatz fest und erhöhen ihn manuell. Sie können den Rollout anhalten und fortsetzen, und Nutzer, die bereits aktualisiert haben, behalten den Build
• Zufällige Auswahl der Nutzer in beiden Stores

Vorteile:

Schritt 5. Abstürze und Zustellung überwachen

8. Firebase Crashlytics: ideal, um Abstürze nach dem Wechsel zu erkennen

Firebase Crashlytics meldet Abstürze und nicht schwerwiegende Fehler aus Android-, Apple-, Flutter- und Unity-Apps. Lassen Sie es während des gesamten Rollouts laufen und vergleichen Sie den neuen Build mit dem vorherigen.

Was es bei der Migration leistet: Ein Absturz in einem Notification-Handler oder bei der SDK-Initialisierung taucht hier zuerst auf. Non-Fatal-Events helfen bei den leiseren Problemen: Protokollieren Sie ein Non-Fatal-Event, wenn die Push-Registrierung fehlschlägt, und Sie sehen es pro Build.

Wichtige Funktionen:

• Crash-Reports, zu Issues gruppiert und nach Build filterbar
• Non-Fatal-Events, auf dem Gerät protokolliert und beim nächsten App-Start gesendet
• Offizielle SDKs für Android, Apple, Flutter und Unity

9. Pushwoosh-Nachrichtenstatistik: ideal, um stille Zustellungseinbrüche zu erkennen

Crash-Reports sagen Ihnen nicht, dass Pushes nicht mehr ankommen. Die Pushwoosh-Push-Statistik schon.

Was es bei der Migration leistet: Für jeden Push sehen Sie den Funnel von der Zielgruppe über Sendungen und Zustellungen bis zu Öffnungen, nach Plattform, plus einen separaten Tab für Fehler. Vergleichen Sie die ersten Kampagnen nach dem Wechsel mit Ihren OneSignal-Zahlen von davor. Hinken die iOS-Zustellungen hinter Android hinterher, prüfen Sie zuerst die Credentials und erst dann den Code.

Ein Migrationsplan in 5 Schritten für große Apps

Jeden OneSignal-Aufruf inventarisieren, bevor Sie Code anfassen

Listen Sie jeden SDK-Aufruf, jeden Wrapper, jeden Callback und jeden Test über alle Repositories hinweg auf. Diese Liste wird zur Checkliste für den Austausch und für das Code-Review.

Push hinter 1 internes Interface kapseln

Leiten Sie jeden Push-Aufruf über einen einzigen internen Service: Login, Logout, Tags, Notification-Handling. Die Migration ändert dann 1 Implementierung statt 50 Aufrufstellen, und auch der nächste Anbieterwechsel wird einfacher.

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

SDKs in 1 Release tauschen

Fügen Sie das Pushwoosh SDK hinzu und entfernen Sie das OneSignal SDK im selben Build. 2 Push SDKs in 1 App konkurrieren um die Notification-Callbacks. Während der neue Build ausgerollt wird, senden Sie über OneSignal weiter an Nutzer der alten Version.

Stufenweise releasen und Zustellungsmetriken vergleichen

Beginnen Sie über Phased Release oder Staged Rollout mit einem kleinen Teil der Nutzer. Beobachten Sie Abstürze in Crashlytics und Zustellungen in der Pushwoosh-Statistik und erweitern Sie dann den Rollout.

OneSignal-Versand erst nach verifizierter Zustellung stoppen

Solange Sie den Versand über OneSignal nicht gestoppt haben, bedeutet ein Rollback einfach, weiter über OneSignal zu senden. Schalten Sie OneSignal ab, sobald sowohl die Zustellung über Pushwoosh als auch der Zielgruppenimport bestätigt sind.

FAQ