Last modified October 2, 2019 by Gordon Glauser

iOS SDK release notes

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

  • If using CocoaPods, add pod 'SwrveSDK' to your Podfile. The Swrve SDK is automatically downloaded and added to your project.
  • Download the SDK from the GitHub public repository.
  • Download a .zip file of the latest iOS SDK.

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

Release 5.3.3

Release date: October 3, 2019


  • Fixed a bug introduced in v5.3.2 that caused custom fonts in Conversations to not display correctly.
  • Fixed a bug introduced in v5.3.2 that caused spacing issues in some Conversations.
  • Fix duplicate assets car issue when building with CocoaPods.

Release 6.3

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 iOS integration guide.
  • Added new SwrveConfig property for hiding the status bar in Conversations. See property prefersConversationsStatusBarHidden.


  • Fixed an issue where custom buttons in push notifications wouldn’t display if there was no media URL.
  • Fixed a bug introduced in v6.2.1 that caused custom fonts in Conversations to not display correctly.
  • Fixed a bug introduced in v6.2.1 that caused spacing issues in some Conversations.
  • Fix duplicate assets car issue when building with CocoaPods.

Release 6.2.1 and 5.3.2

Release date: September 12, 2019


  • With Apple’s deprecation of the UIWebView API, migrated to the recommended WKWebView to prevent issues with submitting your app to the App Store. If you haven’t upgraded to version 6.0+ of our SDK yet, we’ve also released a hotfix for the 5.0 series of our SDK, v5.3.2.

Release 6.2

Release date: July 31, 2019


  • Added support for Swrve Geo SDK plugin v2.3, which supports geo notification cooldown periods at app-wide, individual geoplace, and campaign levels. Also includes support for adding geoplace opening hours via CSV upload or the Geoplace API. For more information, see the Swrve Geo SDK release notes.

Release 5.3.1 (5.X series hotfix)

Release date: July 16, 2019


  • Fixed a potential issue with the formatting of push tokens in iOS 13.
  • Fixed timing issue when displaying dynamic push buttons.

Release 6.1.4

Release date: July 4, 2019


  • Fixed an issue with missing push engage events while calling the SwrveSDK Identify API from the didFinishLaunchingWithOptions method.
  • Fixed an issue with Conversation videos not loading.

Release 6.1.3

Release date: June 13, 2019


  • Fixed Swrve Framework project compilation issue.
  • Fixed a potential issue with the formatting of push tokens in iOS 13.

Release 6.1.2

Release date: May 21, 2019


  • Fixed an issue with string parsing in push notifications linked to an in-app message or Conversation campaign.

Release 6.1.1

Release date: May 9, 2019


  • Fixed an issue with the text styling display on multi-page Conversation campaigns.

Release 6.1

Release date: April 5, 2019


  • Added support for iOS 12 Provisional Authorization for push notifications. For more information, see the iOS integration guide.
  • Added support for Swrve Geo SDK plugin v2.2, which supports triggering and delivering geo notifications when a device is offline. For more information, see the Swrve Geo SDK release notes.
  • Extended the custom button callback function for in-app message buttons to cover dismiss calls-to-action and include campaign data. For more information, see the iOS integration guide.
  • Added the ability to add custom payloads to a limited number of Swrve.* events used in Conversation responses. For more information, see the iOS integration guide.


  • Fixed an issue with the push notification completion handler being called too early when downloading push media.
  • Various minor fixes and improvements.

Release 6.0.2

Release date: February 8, 2019


  • Set UIWindow level priority for Conversation windows.


  • Fixed an issue with background image alignment for Conversations on iPhone X.

Release 6.0.1

Release date: December 18, 2018


  • Added some internal APIs to the Swrve Geo SDK plugin to improve performance.


  • Fixed versioning issue with internal event API.
  • Fixed an issue where the push permission was being requested again after having received a token.
  • Fixed an issue where an authenticated push was not showing when no media URL was present in the push payload.
  • Fixed an issue where the setEventQueuedCallback was blocking in-app messages from displaying.

Release 6.0

Release date: October 31, 2018


  • Added an API for handling User Identity. For more information, see the iOS integration guide. To be part of our Early Access program, contact your CSM at
  • Added ability for the SDK to send a targeted silent notification that confirms a user’s identity before displaying a push notification.
  • Added nullable annotations to public methods for better Swift compatibility.
  • Removed permissions code (camera, location, contacts, photo library) from the SDK. If you want to handle these permissions in the SDK, you must now implement the SwrvePermissionsDelegate. For more information, see the iOS integration guide.
  • Removed support for iOS 8 and 9. For devices running unsupported OS versions of the SDK, the SDK will start with a dummy implementation.
  • Removed support for Locations campaigns, which have now been replaced by our new geo-triggered campaigns. For more information, see Intro to geo-triggered campaigns.
  • Removed the launch options parameter from Swrve init methods.
  • Removed pre-iOS 10 push notification processing methods.
  • Removed Swrve user ID from the Swrve config.


  • Fixed an issue where a device token was not sent when a user enabled push notifications from their device settings.

Release 5.3

Release date: September 3, 2018


  • Added support for displaying a Swrve in-app message or Conversation campaign directly after a customer engages with a push notification. For more information, see Linking push notifications to in-app campaigns.
  • Added support for the release of Swrve Geo SDK plugin v2.0. This includes a new workflow for setting up your geo-triggered campaigns. For more information, see Creating geo-triggered campaigns.
  • Updated and revamped the Swrve sample projects in GitHub, including a new MinimalIntegration project.
  • Various refactors and improvements to how Notifications are built.


  • Fixed an issue that caused an app to crash if the adSource value was null when sending an internal event.

Release 5.2.2

Release date: April 4, 2018


  • Fixed compilation issues caused by Xcode 9.3 and Swift 4.1.
  • Fixed a bug where the Resource Diff file was pointing to the wrong resource file.

Release 5.2.1

Release date: March 13, 2018


  • Fixed an issue affecting devices running iOS 8 where the SDK would cause a hard crash on displaying an in-app message.

Release 5.2

Release date: March 5, 2018


  • Added support for OTT platforms. You can now integrate the Swrve SDK into tvOS to do tracking, resource A/B testing and in-app messages. Conversations and push notifications are not currently supported. For more information, see Swrve OTT Integrations.
  • Updated OCMock libraries.

Release 5.1.1

Release date: January 25, 2018


  • Fixed an issue in Conversations where margins were cutting of some of the text when using a custom font.

Release 5.1

Release date: December 12, 2017


  • Includes updates required for Locations SDK 2.0. For more information, see the Locations SDK Release Notes.


  • Fixed a bug in version 4.11.4 where the optional functions in SwrvePushResponseDelegate were causing crashes if not both implemented.

Release 5.0

Release date: November 16, 2017


  • All interaction with the Swrve SDK, including initialization, is via a new class called SwrveSDK. For more information, see the iOS SDK 5.0 Upgrade Guide.
  • Includes refactors to safely persist data per User ID.
  • With the exception of push notifications, we have changed the process to exclude optional iOS frameworks from your app. Now, rather than adding a Preprocessor Macro to exclude the framework, you must add them to include the framework in your Swrve integration. For more information, see How Do I Exclude Optional iOS Frameworks?
  • Improved Conversations compatibility for the iPhone X.


  • It is no longer possible to use internal Swrve.* events to trigger in-app messages or conversations.

Previous releases summary

  • October 6, 2017 – v4.11.4 – Bug fixes.
  • September 20, 2017 – v4.11.3 – Added support for Carthage and bug fixes.
  • August 29, 2017 – v4.11.2 – Bug fixes.
  • August 23, 2017 – v4.11.1 – Improved thread safety in the Swrve Permissions manager and bug fixes.
  • August 16, 2017 – v4.11 – Several push notification enhancements, including support for creating rich notifications directly in Swrve and influenced metrics reporting. Also a new API for extracting resource A/B test campaign information.
  • August 1, 2017 – v4.10.2 – Added new user property to track permission of background app refresh setting and bug fixes.
  • July 4, 2017 – v4.10.1 – Bug fixes.
  • May 24, 2017 – v4.10 – Added support for using silent push notifications to send background app content updates.
  • April 25, 2017 – v4.9.2 – Bug fixes.
  • April 11, 2017 – v4.9.1 – Deprecated the SWRVE_NO_PUSH flag and bug fixes.
  • March 21, 2017 – v4.9 – Updated minimum OS support to iOS 8 and bug fixes.
  • January 26, 2017 – v4.8 – Various Conversation enhancements and fixes, including custom fonts and styling.
  • December 13, 2016 – v4.7.1 – Improved the Swrve SDK support for iOS apps building with a high Data Protection entitlement.
  • November 24, 2016 – v4.7 – Added support for using date-type user properties to target your campaign audiences and for sending your own push engagement event.
  • November 3, 2016 – v4.6.2 – Bug fixes.
  • October 13, 2016 – v4.6.1 – Added a feature flag to remove the Photo Camera Access API for users who don’t use photo camera access.
  • August 31, 2016 – v4.6 – SDK now uses HTTPS by default for all endpoints.
  • August 18, 2016 – 4.5.2 – Moved relevant frameworks out of Required and into Optional to prevent iOS 7 and iOS 8 compatibility issues when using Swift.
  • July 27, 2016 – v4.5.1 – Bug fixes.
  • July 5, 2016 – v4.5 – Conversations enhancements.
  • June 27, 2016 – v4.4.2 – Bug fixes.
  • June 16, 2016 – v4.4.1 – Bug fixes.
  • May 25, 2016 – v4.4 – Added support for using event payload conditions to trigger in-app messages and Conversations campaigns.
  • May 9, 2016 – v4.3.1 –  Added dependancy to Locations SDK v1.1 on Swrve iOS SDK v4.3.1 or higher.
  • April 7, 2016 – v4.3 – Added Star Rating survey template to Conversations.
  • February 11, 2016 – v.4.2 – Added Message Center API and ability to exclude optional iOS frameworks.
  • December 3, 2015 – v4.1.1 – Bug fixes.
  • November 30, 2015 – v4.1 – Restricted use of Swrve. namespace for custom events.
  • October 9, 2015 – v4.0.5 – Bug fixes.
  • October 1, 2015 – v4.0.4 – Bug fixes.
  • September 17, 2015 – v4.0.3 – Increased HTTP default timeout and added support for a new UIWindow when displaying Conversations.
  • August 21, 2015 – v4.0.2 – Bug fixes.
  • August 18, 2015 – v4.0.1 – Added support for iOS 9 and logging device region.
  • July 7, 2015 – v4.0 – Added support for Conversations and requesting device permissions.
  • April 8, 2015 – v3.4 – Changed default background for in-app messages from solid black to transparent.
  • January 21, 2015 – v3.3.1 – Bug fixes.
  • November 11, 2014 – v3.3 – Added support for iOS 8 interactive push notifications and to log carrier information by default.
  • October 21, 2014 – v3.2 – Added support for CocoaPods and random generation of UUID if no custom user ID is provided at initialization.
  • September 12, 2014 – v3.1.3 – Production support for iOS 8.
  • August 29, 2014 – v3.1.2 Beta – Beta support for testing devices running iOS 8 Beta 5.
  • August 8, 2014 – v3.1.1 Beta – Beta support for iOS 8 push registration method.
  • July 30, 2014 – v3.1 – Added support for triggering in-app messages at session start and bug fixes.
  • May 30, 2014 – v3.0.2 – Bug fixes.
  • May 27, 2014 – v3.0.1 – Bug fixes.
  • May 15, 2014 – v3.0 – Real-time targeting enhancements.
  • April 18, 2014 – v2.2.1 – Bug fixes.
  • April 1, 2014 – v2.2 – Updates to iOS receipt validation process and bug fixes.
  • March 4, 2014 – v2.1 – Improved processing of campaign, user resources and saved events.
  • v2.0.1 – Bug fixes.
  • v2.0 – Various updates to event handling and user properties.
  • v1.13 – Push notification enhancements and bug fixes.
  • November 12, 2013 – v1.12 – Added support for extended IAP event and bug fixes.
  • October 18, 2013 – v1.11.1 – Bug fixes.
  • October 16, 2013 – v1.11 – Added support for in-app messaging per campaign dismissal rules and bug fixes.
  • September 18, 2013 – v1.10.1 – Bug fixes.
  • September 17, 2013 – v1.10 – Added support for in-app messaging QA logging.
  • August 20, 2013 – v1.9 – Added support for in-app messaging QA users.
  • July 26, 2013 – v 1.8 – Added support for server side IAP validation.
  • July 2nd, 2013 – v 1.7 – Added support for app store filtering in in-app messaging.
  • May 8, 2013 – v1.6 – Removed UDID system calls from libReceiptVerification.multi.a library. You must use this library if submitting to Apple after May 1, 2013. This library is compatible with the v1.4 SDK.
  • April 15, 2013 – v1.5 – Major update – in-app messaging added.
  • March 19, 2013 – v1.4 – Added client-side IAP validation and third-party ID tracking.
  • November 8, 2012 – Fix bug where user_resources call returned incorrect results when called with no network connection.
  • November 2, 2012 – Add user_resources call (in parallel to& user_resources_diff).
  • August 24, 2012 – Fixing a small timestamp bug effecting session length and playtime.
  • April 17, 2012 – Add support for joined field to A/B Test call in iOS SDK.
  • December 1, 2011 – Adding currency_given API support.
  • September 30, 2011 – First public release.