3.2.0

New Features

Android Specific

• Supports CleverTap Android SDK v6.2.1.
• Supports Android 14, made it compliant with Android 14 requirements. Details here.
• Extends the push primer callback to notify permission denial when cancel button is clicked on PromptForSettings alert dialog.
• Adds Accessibility ids for UI components of SDK.
• Migrates JobScheduler to WorkManager for Pull Notifications.

Bug Fixes

Android Specific

• Fixes #239, an issue where the onPushNotification callback was not triggered when notification was tapped from the killed state on capacitor apps.
• Fixes InApps crash in a rare activity destroyed race condition.
• Fixes Potential ANR in a race condition of SDK initialisation in multithreaded setup.
• Fixes a bug in Client Side InApps with regards to frequency limits.
• Fixes a crash due to NullPointerException related to deviceInfo.deviceId.
• Fixes an ANR related to isMainProcess check.
• Fixes an ANR due to eager initialisation of CtApi triggered by DeviceId generation.

Breaking API Changes

• Removes all Xiaomi related public methods as the Xiaomi SDK has been discontinued. Details here.

3.1.0

Version 3.1.0 (April 27, 2024)

New Features

iOS specific

• Supports CleverTap iOS SDK v6.2.1.
• Adds privacy manifests.

Bug Fixes

iOS specific

• Fixes crash due to out of bounds in NSLocale implementation.
• Fixes a bug where client side in-apps were not discarded when rendering status is set to "discard".

3.0.0

New Features

Android specific

• Supports CleverTap Android SDK v6.0.0.
• Adds support for exoplayer v2.19.1.

iOS specific

• Supports CleverTap iOS SDK v6.0.0.

Common for both android and iOS

• Adds new public APIs, fetchInApps and clearInAppResources to support client-side in-apps.

Bug Fixes

Android specific

• Fixes no empty message for app inbox without tabs
• Removes onClickListener for Image of Cover InApp

iOS specific

• Fixes a bug where some in-apps were not being dismissed

2.7.2

Android specific

• Supports CleverTap Android SDK v5.2.1. This supported version includes support for Custom Proxy Domain functionality. Check usage for cordova android here.

iOS specific

• Supports CleverTap iOS SDK v5.2.2. This supported version includes support for Custom Proxy Domain functionality. Check usage for cordova ios here.

Bug Fixes

• Fixes a crash in iOS 17/Xcode 15 related to alert inapps.

Common for both android and iOS

• Adds new public API setLocale(String locale) for in-built support to send the custom locale(i.e.language and country) data to the dashboard.
• Adds support for Integration Debugger to view errors and events on the dashboard when the debugLevel is set to 3.

2.7.1

New Features

Android specific

• Supports CleverTap Android SDK v5.2.0. This supported version includes encryption feature for PII data. Check encryption usage for cordova android here.

iOS specific

• Supports CleverTap iOS SDK v5.2.0. This supported version includes encryption feature for PII data. Check encryption usage for cordova ios here.

Bug Fixes

• Fixes NSInvalidArgumentException for getDisplayUnitForId and getInboxMessageForId in iOS.

2.7.0

New Features

Android specific

• Supports CleverTap Android SDK v5.1.0.
• Supports cordova android 12.0.0
• deleteInboxMessagesForIds(messageIDs) is now supported in Android as well.
• New callback onCleverTapInAppNotificationShow(JSONObject)
• Behavioral change of onCleverTapInboxItemClick:
  • Previously, the callback was raised when the App Inbox Item is clicked.
  • Now, it is also raised when the App Inbox button and Item is clicked.
• Fixes an XSS vulnerability - https://fluidattacks.com/advisories/maiden/ We recommend all users to update to v2.7.0 or above.

iOS specific

• Supports CleverTap iOS SDK v5.1.2.
• Supports cordova ios 7.0.0

Common for both android and iOS

• Adds below new public APIs for supporting Android 13 notification runtime permission
  • isPushPermissionGranted(successCallback) Usage can be found here
  • promptPushPrimer(JSONObject) Usage can be found here
  • promptForPushPermission(boolean) Usage can be found here
  • New callback onCleverTapPushPermissionResponseReceived available which returns after user Allows/Denies notification permission Usage can be found here
• Adds support for Remote Config Variables. Please refer to the Variables.md file to
  read more on how to integrate this to your app.
• Adds new API, markReadInboxMessagesForIds(messageIDs) to mark read an array of
  Inbox Messages.
• Adds new API, dismissInbox() to dismiss the App Inbox.

API Changes

• Deprecated: The following methods and callbacks related to Product Config and Feature Flags have
  been marked as deprecated in this release, instead use new remote config variables feature. These
  methods and callbacks will be removed in the future versions with prior notice.

  • Product config

    • setDefaultsMap()
    • fetch()
    • fetchWithMinimumFetchIntervalInSeconds()
    • activate()
    • fetchAndActivate()
    • setMinimumFetchIntervalInSeconds()
    • getLastFetchTimeStampInMillis()
    • getString()
    • getBoolean()
    • getLong()
    • getDouble()
    • reset()
    • callback onCleverTapProductConfigDidInitialize
    • callback onCleverTapProductConfigDidFetch
    • callback onCleverTapProductConfigDidActivate

  • Feature flags

    • getFeatureFlag()
    • callback onCleverTapFeatureFlagsDidUpdate

Breaking API Changes

• Return value change of onCleverTapInboxItemClick callback in android and messageDidSelect callback in iOS: callback returns JSONObject with below entries
  • data corresponds to the payload of clicked inbox item
  • The contentPageIndex corresponds to the page index of the content, which ranges from 0 to the total number of pages for carousel templates. For non-carousel templates, the value is always 0, as they only have one page of content.
  • The buttonIndex represents the index of the App Inbox button clicked (0, 1, or 2). A value of -1 indicates the App Inbox item is clicked.

2.6.2

• Fixed compilation errors in xcode 14.3+ in iOS.
• Supports CleverTap iOS SDK v4.2.2.

2.6.1

• Fixes a compilation error with iOS app inbox callback method messageDidSelect.

2.6.0

• Supports CleverTap Android SDK v4.6.6
• Supports cordova android 11.0.0
• Supports Android exoplayer v2.17.1. Note : this upgrade will result in minor ui changes for interstitial in app and inbox notifications that uses exoplayer.
• Adds new callback onCleverTapInboxItemClick to receive inbox item click.
• Breaks Android setPushXiaomiToken() API where new changes adds region as second mandatory parameter to specify server region.If you are using this method make sure you pass region while calling setPushXiaomiToken().
• Supports CleverTap iOS SDK v4.2.0.
• Adds a public method deleteInboxMessagesForIds() for deleting multiple App Inbox messages by passing a collection of messageIDs. Please note that this is only for iOS, and NO-OP for Android as of now.

2.5.2

• Fixes an iOS bug where onDeepLink callback wasn't being called when triggered from killed state.
• Supports CleverTap iOS SDK v4.1.1.