Marketing Cloud Personalization iOS SDK Release Notes

Released April 2026

• Added the Evergage isServerConfigLoaded property to check whether server configuration is loaded and events are campaign-eligible.
• Added the EVGNotificationServerConfigLoaded notification to alert your app when the server configuration is ready and campaigns are active.
• Updated the Mobile Data Campaigns Guide to include the recommended pattern to defer campaign handler registration until the SDK server is fully configured.
• Event capture is now gated behind [Evergage startWithClientConfiguration:] to support a consent-first initialization and strengthen privacy compliance.
  • Tracking calls made before initialization are no longer recorded, ensuring no device identifiers or events are captured before user consent.
  • Lifecycle events such as App Launch, App Install, and App Upgrade are now triggered automatically when start is invoked.
  • Push token registration is deferred until the SDK starts. If tokens are received beforehand, the SDK automatically recovers and registers them when start is invoked. This approach makes sure that push notification functionality remains unaffected as long as SDK is started within the same session.

Released March 2026

• Resolved App Store Connect validation errors for arm64e architecture by rebuilding the project with Xcode 16 (iOS SDK 26).
• This update contains no functional changes or API modifications.

Released September 2024

• Added a privacy manifest file
• Removed support for iOS versions below 12 due to the latest Xcode build system requirements
• Improved detection of iOS simulators on Apple Silicon machines
• Updated documentation for Firebase key configuration

Released August 2023

• Added [EVGContext removeFromCart:] and [EVGContext viewCart:]

Released June 2023

• OS:
  • Removed support for iOS < 11, due to latest Xcode build system
• Updated documentation:
  • Added details to [Evergage globalContext]
  • Added Firebase details to Push Notifications Guide and [Evergage(Swizzling) setFirebaseToken:]
  • User consent should be obtained before calling [Evergage startWithClientConfiguration:]
• Push notifications:
  • Support automatically fetching token in more recent Firebase Cloud Messaging versions
  • Verify user has granted notification permissions via UNNotificationSettings before accepting any push tokens

Released June 2021

• Removed support for iOS 7 and 8. The minimum supported iOS version is now iOS 9.
• Increased robustness of the UI around In-App Message campaigns for building-against/running-on iOS 13 and newer
• ZIP distributable now contains both static and dynamic variants of new XCFramework, also supporting simulator on Apple Silicon
• Podspec requires CocoaPods version 1.10+ for XCFramework support
• Documentation updates, including the Integration Guide

Released December 2019

• Includes module maps for Swift

Released December 2018

• New feature: mobile push notification campaigns, supporting APNS and Firebase Messaging, see the Push Notifications Guide
• Automatically gather time zone, to support time zone specific scheduling of push notification campaigns
• Expanded app-defined EVGClientConfiguration provided on [Evergage startWithClientConfiguration:]
• Ability to disable most Swizzling, see [Evergage(Swizzling) swizzlingEnabled]
• Support accumulating time viewed via [EVGContext viewCategory:] and [EVGContext viewTag:], as was already done for [EVGContext viewItem:] and [EVGContext viewItemDetail:]
• Support optional different action name in view APIs, via
  • [EVGContext viewItem:actionName:]
  • [EVGContext viewItemDetail:actionName:]
  • [EVGContext viewCategory:actionName:]
  • [EVGContext viewTag:actionName:]
• Added [EVGItem location], [EVGItem rating], [EVGItem numRatings]

Released July 2017

• Reduce harmless compiler warnings from using the SDK across integration styles (zip/pod ObjC/Swift).

Released July 2017

• Fix: After [Evergage reset], the SDK needs to once again automatically fetch the initial configuration from the server
• Improved control over expiration of configurations fetched from the server
• Documentation updates

Released May 2016

• New feature: In-App Message campaigns
• Ability to control testing non-published campaigns via URLs, see Testing Guide
• Added EVGContext, [Evergage globalContext], and [Evergage reset]
• Documentation updates

Released January 2016

• Now supports CocoaPods

Released November 2015

First GA public release

• Network: Queueing, connectivity monitoring
• Tracking: APIs, app lifecycle monitoring ("foreground", "background", etc)
• Mobile Data campaigns
• Mapping screens to actions, see Tracking Guide