Last modified October 24, 2023 by Shelly Wolfe

Cordova SDK upgrade guide

This guide provides information about how you can upgrade to the latest Swrve Cordova SDK plugin. For information about the changes that have been made in each Cordova SDK release, see Cordova SDK release notes.

To upgrade to the latest version of the Swrve Cordova SDK plugin, replace the cordova-plugin-swrve folder in your project with the one found in latest release on GitHub. Or use the following command:

cordova plugin add cordova-plugin-swrve

When you add the updated folder, we recommend using the Cordova platform remove and platform add commands to ensure all changes are fully moved over.


Release 6.0.1

There are no code changes required to upgrade to Swrve Cordova SDK plugin v6.0.1


Release 6.0.0

This section provides information for upgrading to Swrve Cordova SDK v6.0.0.

  • Support is dropped for NodeJs 14. The minimum supported version that Cordova requires is greater than or equal to 16.13.0.
  • Upgrade to cordova-android@12.0.1.
  • Upgrade to cordova-ios@7.0.1.

Release 5.0.0

This section provides information for upgrading to Swrve Cordova SDK v5.0.0.

  • Upgrade to cordova-android@11.0.0.

You must set the following configuration in your config.xml:

  • The Swrve SDK now has a minCompileSdk value of 31. Set the android-compileSdkVersion preference to 31.
  • If using Firebase push, set the Cordova GradlePluginGoogleServicesEnabled preference to true.
  • We’ve removed the swrve.googleServicesVersion preference. Use the Cordova GradlePluginGoogleServicesVersion preference instead.

Release 4.0.0

There are no code changes required to upgrade to Swrve Cordova SDK plugin v4.0.0. However, if you are using iOS push notifications, you may need to run pod install from your project’s platforms/ios directory.


Release 3.3.0

There are no code changes required to upgrade to Swrve Cordova SDK plugin v3.3.0.


Release 3.2.2

There are no code changes required to upgrade to Swrve Cordova SDK plugin v3.2.2.


Release 3.2.1

There are no code changes required to upgrade to Swrve Cordova SDK plugin v3.2.1.


Release 3.2.0

There are no code changes required to upgrade to Swrve Cordova SDK plugin v3.2.0.


Release 3.1.0

There are no code changes required to upgrade to Swrve Cordova SDK plugin v3.1.0.


Release 3.0.0

This section provides information for upgrading to Swrve Cordova SDK plugin v3.0.0.

Firebase Cloud Messaging library update

The Android native Swrve dependency uses Firebase Cloud Messaging version 20.1.6, which drops support for Android 14 and 15. When upgrading to Cordova SDK 3.0.0 ensure your minimum Android support is at 16.


Release 2.1.0

This section provides information for upgrading to Swrve Cordova SDK plugin v2.1.0.

Delayed initialization and custom user ID

For information about how to configure the SDK to delay initialization and set a custom user ID for tracking purposes, see the Cordova integration guide.


Release 2.0.1

There are no code changes required to upgrade to Swrve Cordova SDK plugin v2.0.1.


Release 2.0.0

This section provides information for upgrading to Swrve Cordova SDK plugin v2.0.0.

Geo-triggered campaigns

To use Swrve’s geo-triggered campaigns, you must integrate the Geo SDK plugin. For more information, see the Swrve Geo SDK Guide.


Previous versions

If you’re upgrading from a version older than 2.0.0, please refer to the Cordova integration guide.