Cordova apps

Step-by-step instructions to migrate your cross-platform Cordova app to WonderPush

Already have a push provider? Migrating to WonderPush is easy, in most cases all you have to do is remove your existing provider, add WonderPush to your app and publish a new version to the AppStore.
When users install the new version, they will automatically be added to WonderPush.

📘

We've put together specific instructions for OneSignal users, Batch users and Accengage users.

This guide will help you remove your existing push provider from your app and add WonderPush.

Step 1. Removing your existing provider's Cordova plugin

List the contents of the plugins folder at the root of your project and identify your existing provider's plugin name.

For example: onesignal-cordova-plugin.

Adapt EXISTING_PROVIDER_PLUGIN_NAME in the following command line and type it in a shell:

cordova plugin rm EXISTING_PROVIDER_PLUGIN_NAME

Step 2. Remove your existing provider's code

In the www folder of your cordova app, identify and remove all the code related to your existing provider.

For example, remove such entries:

var notificationOpenedCallback = function(jsonData) {
    console.log('notificationOpenedCallback: ' + JSON.stringify(jsonData));
  };

window.plugins.OneSignal
  .startInit("YOUR_APPID")
  .handleNotificationOpened(notificationOpenedCallback)
  .endInit();

Step 3. Remove your existing provider's notification extension (iOS only)

If your existing provider had you install an iOS notification extension, remove it. Open your Xcode workspace (adapt MyApp):

open platforms/ios/MyApp.xcworkspace

In the Xcode project's General tab, identify the notification service extension entry. This entry will have an icon that looks like this: .

If you do not find this target, skip to the next step.

Select the NotificationServiceExtension target and click Edit / Delete.

In the Xcode navigator (left hand-side panel), find the source files and the Info.plist file of the notification extension. They are usually named after the target you just deleted. Select the files or the enclosing folder and choose Edit / Delete. When asked if you want to remove the references or the files choose Move to trash.

Step 4. Add WonderPush

Follow our Cordova Quickstart to add WonderPush to your app.

👍

That's it, test and publish this new version of your app and watch your users automatically migrate to WonderPush as they install it.