Last modified November 8, 2021 by Shelly Wolfe

Android SDK release notes

Swrve has an open source SDK repository. There are two options for downloading the latest public Swrve Android SDK:

  • Download the SDK source from the GitHub public repository.
  • Integrate the SDK via Gradle by adding the following code to your build.gradle file.
    First, in the project build.gradle file, add the Maven Central repository:

    repositories { 

    Then, select a Swrve library to install, ensuring you include the latest SDK version number: 9.0.0
    Firebase – select if you use push notifications with Swrve, or any Firebase services like Firebase Cloud Messaging or Analytics.

    dependencies {
        implementation ''

    Amazon – select if you use Amazon Device Messaging.

    dependencies {
    	implementation ''

    Huawei – select if you use Huawei Push Service.

    dependencies {
    	implementation ''

    Basic – select only if you are not using Swrve push notifications, or any Firebase/Amazon/Huawei services.

    dependencies {
    	implementation ''

For upgrade instructions, see Android SDK upgrade guide. To view the feature support matrix, see SDK feature support matrix.

Warning: With the upcoming deprecation and retirement of Bintray/JCenter, version 7.6.0 is the last version published to Bintray/JCenter. We’ve moved our existing versions and all future releases will be available in Maven Central repository.

Release 9.0.0

Release date: November 8, 2021


  • Added support for Android 12. The minimum Android SDK compile version is now 31.
  • If using Google Play services advertising ID, you must now include the library dependency in your build.gradle. For more information, see the Android SDK upgrade guide.
  • Removed some internal deprecations.
  • Upgraded the following tools and services:
    • Android Gradle Build Tools plugin to version 7.0.3.
    • Android WorkManager runtime to version 2.7.0.
    • Huawei AppGallery Connect plugin to version
    • Huawei push kit to version
    • Timber logging to version 5.0.1.

Release 8.0.0

Release date: July 29, 2021


  • Made performance improvements to the SDK initialization. This should remove most strict mode issues on SDK start up.
  • Added a new API called stopTracking that stops the SDK from tracking a user’s activity and sending events until you call the identify or start API. For more information, see the Android integration guide.
  • Included personalization properties in the SwrveEmbeddedMessageListener and streamlined the process of applying personalization to message data. For more information, see the Android integration guide.
  • Renamed the ManagedModeAutoStartLastUser configuration in SwrveConfig to AutoStartLastUser and made it available to use to delay activity tracking until a user is identified. For more information, see the Android integration guide.
  • Removed the LoadCachedCampaignsAndResourcesOnUIThread configuration in SwrveConfig.
  • The SwrveLogger now uses Android log constant values instead of numbers. For more information on how to set the logging level from the command line, see How do I configure SDK device logging?


  • Fixed an issue with text alignment on Conversation buttons.
  • Huawei: Upgraded Push Kit to version, which resolves an issue about the call of implicit PendingIntent.

Release 7.6.1

Release date: April 27, 2021


  • Fixed an issue with Conversation custom fonts that caused the system font to display on devices running Android 11.

Release 7.6.0

Release date: March 31, 2021


  • Added support for Huawei Push Service.

Release 7.5.0

Release date: March 18, 2021


  • Added Activity Window Listener to SwrveInAppMessageConfig. This listener is invoked before the Activity is displayed and can be used to apply custom Window configurations such as displaying full screen.

Release 7.4.0

Release date: December 14, 2020


  • Added the ability to use Swrve triggering for your own application UI. For more information, see the Android integration guide.
  • Upgraded the following tools and services:
    • Firebase Cloud Messaging to version 21.0.0.
    • Android Gradle Build Tools plugin to version 4.1.1.
    • Gradle to version 6.5.0.

Release 7.3.2

Release date: November 3, 2020


  • Fixed a regression issue from 7.2.0+ that might cause ANRs when initializing.
  • Fixed ProGuard rules to include Notification classes.

Release 7.3.1

Release date: October 7, 2020


  • Fixed an issue with Conversations where videos weren’t respecting the height setting.
  • Fixed an issue with in-app message button QA logging.

Release 7.3.0

Release date: September 24, 2020


  • Internal changes to improve the reliability of sending the Push Delivered event.
  • Upgraded the following tools and services:
    • Firebase Cloud Messaging to version 20.2.4.
    • Android Gradle Build Tools plugin to version 4.0.1.
    • Gradle to version 6.1.1.
    • Android target SDK to 30.
    • Android build tools to 30.0.2.
  • Updated tracking of device OS and type for platform-specific delivery of in-app messages.

Release 7.2.1

Release date: September 4, 2020


  • Fixed an issue where a NullPointerException caused a crash on rare occasions when calling WakefulBroadcastReceiver.completeWakefulIntent. For issue tracking, see GitHub. Thanks to nimeacuerdo for your contribution!
  • Fixed an issue with logging enabled flag on QA devices.

Release 7.2.0

Release date: August 17, 2020


  • We’ve made several upgrades to the QA user feature, with richer logs now available in the QA user logging screen. QA log event showing event source and status Some highlights are:
    • Events display immediately in the QA user logging screen.
    • Event Source indicates the current progress of events from the SDK through to the Swrve servers.
    • A User Segment log displays details for all segments that user belongs to.
    • Alignment with iOS QA logs for consistency (iOS SDK v6.6.0).
    If your SDK integration uses the Identity API or a custom user ID, and you’re using both an old and new version of the SDK across different devices, once a QA user migrates to this version of the SDK, any logs sent from a device running an older version of the SDK will not display in the QA user logs. We recommend upgrading all of your devices to the latest version of the SDK.
  • Removed format, orientation, and size from the in-app message impression event payload.


  • Fixed the timing of refreshing campaigns to execute only when the SDK has recently sent an event. 
  • Fixed the order that the SDK was sending session start and campaign refresh events.
  • Fixed an issue where the SDK unnecessarily refreshed campaigns every time a new activity started.

Release 7.1.0

Release date: May 14, 2020


  • Mark Message Center campaigns as seen programmatically.
  • Upgraded the following tools and services:
    • Firebase Cloud Messaging to version 20.1.6.
    • Amazon Device Messaging to version 1.1.0 (Support for FireOS 7.0).
    • Google Services plugin to version 4.3.3.
    • Android Gradle Build Tools plugin to version 3.6.2.


  • Changed the default in-app message button click color back to gray instead of transparent (regression since 6.0 SDK).
  • Made performance improvements to dynamic text rendering code.

Release 7.0.0

Release date: March 10, 2020


  • Swrve now automatically tracks and logs when push notifications are delivered and displayed on each device. This data will be used to drive campaign reports, retargeting, and exports.
  • Changed the notification accent color configuration from RGB to Hex.
  • Added ability to set a custom registration ID for the Firebase service.
  • Added new SwrveInAppMessageConfig object used to configure global settings related to in-app messages. Some properties were moved from SwrveConfig.
  • Removed the previously deprecated SwrveNotificationCustomFilter.
  • Increase Android minimum SDK version from 14 to 16.
  • Upgraded the following tools and services:
    • firebase-messaging from 17.4.0 to 20.1.0.
    • play-services-ads-identifier from 16.0.0 to 17.0.0
    • Moved Android support libraries over to AndroidX.


  • Resolved an issue that caused an OOM exception in some instances when using a large image for rich notifications.
  • Fixed an issue that would prevent our SDK from tracking push influence.

Release 6.3.1

Release date: February 20, 2020


  • Fixed an issue that prevented Conversations from displaying correctly on wider devices.

Release 6.3.0

Release date: October 2, 2019


  • Added configuration options for delaying the start of the SDK and setting a custom user ID for tracking purposes. For more information, see the Android integration guide.
  • We have deprecated SwrveNotificationCustomFilter and will remove it in the next major release. Please use SwrveNotificationFilter instead, which exposes more details of the notification than its predecessor.
  • The SDK now sends the Firebase push token (swrve.gcm_token) separately to regular device updates, so it will never contribute to DAU.


  • Fixed an issue with custom notification filtering where SwrveNotificationCustomFilter wasn’t correctly sending payload values that weren’t part of a group.
  • Suppressed an android Oreo exception where JobIntentService was crashing internally. Issue tracked here. Thanks to HGyllensvard and GrinGraz for your contribution!

Previous releases summary

Date Version Features and Fixes
September 16, 2019 6.2.1 Bug fixes.
July 31, 2019 6.2.0 Added support for Swrve GeoSDK plugin v2.3, which supports geo notification cooldown periods. Also includes support for adding geoplace opening hours via CSV upload or the Geoplace API.
April 29, 2019 6.1.1 Bug fixes.
April 5, 2019 6.1.0 Added support for Geo SDK plugin v2.2. Upgrades to various build tools and services. Bug fixes.
February 21, 2019 6.0.2 Bug fixes.
November 30, 2018 6.0.1 Bug fixes.
October 31, 2018 6.0.0 Removed support for Google Cloud Messaging. Added an API for handling User Identity. Removed support for deprecated Locations campaigns.
September 21, 2018 5.3.2 Bug fixes.
September 17, 2018 5.3.1 Bug fixes.
September 3, 2018 5.3.0 Deprecated the swrve-google flavor of the SDK. Added support for linking push notifications to in-app campaigns and Swrve Geo SDK 2.0. Added new SwrveNotificationConfig object for configuring global settings for notifications and deprecated SwrveSDK.setPushNotificationListener(). Upgrades to various build tools and services. Bug fixes.
March 5, 2018 5.2.0 Added support for OTT platforms. You can now integrate the Swrve SDK into Android TV or Amazon Fire TV to do tracking, resource A/B testing and in-app messages.
January 15, 2018 5.1.1 Updated Multiple GCM Providers Sample project to make it compatible with Android O and added an API for disabling Logcat logging.
December 12, 2017 5.1.0 Various libraries and support tools upgrades.
 November 16, 2017 5.0.0 Refactors and code improvements. Added automatic activity tracking and support for nested push notification payload JSON.
October 16, 2017 4.11.3 Bug fixes.
September 20, 2017 4.11.2 Updated GCM and FCM libraries to 11.2.0 and added the ability to get the resource key set from a SwrveResource.
August 28, 2017 4.11.1 Bug fixes.
August 16, 2017 4.11.0 Several push notification enhancements, including support for creating rich notifications directly in Swrve, influenced metrics reporting, and Firebase Cloud Messaging. Also added support for Android O and a new API for extracting resource A/B test campaign information.
June 7, 2017 4.10.1 Bug fixes.
May 24, 2017 4.10.0 Added support for using silent push notifications to send background app content updates.
March 21, 2017 4.9.0 Minimum support changed to Android API Level 14. Upgrades to Android Gradle and build tools, support jars and Google Cloud Messaging libraries.
February 2, 2017 4.8.0 Various Conversation enhancements and fixes, including custom fonts and styling.
November 24, 2016 4.7.0 Added support for Amazon Device Messaging, for using date-type user properties to target your campaign audiences and for sending your own push engagement event.
November 7, 2016 4.6.2 Bug fixes.
September 12, 2016 4.6.1 Bug fixes.
August 31, 2016 4.6.0 SDK now uses HTTPS by default for all endpoints.
July 5, 2016 4.5.0 Conversations enhancements.
May 25, 2016 4.4.0 Added support for using event payload conditions to trigger in-app messages and Conversations campaigns.
May 9, 2016 4.3.1 Added dependancy to Locations SDK v1.1 on Swrve iOS SDK v4.3.1 or higher.
April 7, 2016 4.3.0 Added Star Rating survey template to Conversations.
February 11, 2016 4.2.0 Added Message Center API and updated Google Cloud Messaging libraries.
November 30, 2015 4.1.0 Restricted use of Swrve.* namespace for custom events.
November 5, 2015 4.0.5 Updated Google Cloud Messaging libraries.
October 21, 2015 4.0.4 Bug fixes.
October 15, 2015 4.0.3 Added compatibility with Android Marshmallow.
September 23, 2015 4.0.2 Updated push notification plugin to latest GCM library and increased HTTP default timeout.
August 18, 2015 4.0.1 Bug fixes.
July 7, 2015 4.0.0 Added support for Conversations and moved from JAR to AAR distribution.
April 8, 2015 3.4.0 Changed default background for in-app messages from solid black to transparent.
January 21, 2015 3.3.1 Added support to automatically capture and send referrer information.
November 11, 2014 3.3.0 Added support to log carrier information by default.
October 21, 2014 3.2.0 Added support to generate a random UUID if no custom user ID is provided at initialization.
July 30, 2014 3.1.0 Simplified Google Cloud Messaging push notification integration and added support for triggering in-app messages at session start.
May 27, 2014 3.0.1 Bug fixes.
May 15, 2014 3.0.0 Enhancements to real-time targeting and added separate JAR files for Google Play-flavored SDK.
April 3, 2014 2.10.1 Bug fixes.
April 1, 2014 2.10 Simplified in-app message actions and QA device registration.
March 4, 2014 2.9.0 Added support for push notifications for Android devices.
2.8.0 Added support for Swrve’s redesigned in-app messaging functionality and push notifications Beta.
2.7.1 Bug fixes.
2.7.0 Added support for auto-generation of user IDs and unified the in-app messaging and analytics SDKs.
November 12, 2013 2.6.0 Added support for extended IAP event and bug fixes.
October 16, 2013 2.5.0 Added support for in-app messaging per campaign dismissal rules and bug fixes.
September 17, 2013 2.4.0 Added support for in-app messaging QA logging.
August 20, 2013 2.3.0 Added support for in-app messaging QA user functionality.
July 26, 2013 2.2.0 Bug fixes.
July 2, 2013 2.1.0 Added support for app store filtering within in-app messaging.
May 22, 2013 2.0.1 Fixed possible crash while displaying messages whose images were not fully downloaded.
May 17, 2013 2.0.0 First public release.