clevertap_plugin

What's new

• [Android Platform]

  • Supports CleverTap Android SDK v8.3.0.

• [iOS Platform]

  • Supports CleverTap iOS SDK v7.7.1.
  • Silent-in-foreground push notifications via the wzrk_sif:true payload key — server-controlled, no app-side wiring needed when using autoIntegrate.

• [Android and iOS Platform]

  • App Inbox Cross-Device Sync — inbox state (read, deleted) syncs across a user's devices automatically. Includes a pull-to-refresh gesture in the built-in showInbox() view, throttled to once every 5 minutes.

• [Web Platform]

  • Supports CleverTap Web SDK v2.7.2
  • New API: getVariants() - Returns variants for the current user for A/B testing.

API changes

• [Android and iOS Platform]
  • New API: fetchInbox() - Triggers an on-demand App Inbox refresh (fire-and-forget), throttled to once every 5 minutes..
  • New API: fetchInboxWithCallback() - Triggers an on-demand App Inbox refresh and returns a Future<bool?> indicating success or failure, throttled to once every 5 minutes..
  • New API: pushDisplayUnitElementClickedEvent(unitId, additionalProperties) - Records a Notification Clicked event for a specific element within a Display Unit, enriched with caller-supplied additionalProperties.

Bug Fixes

• [iOS Platform]
  • Fixes a bug where server-side InApps evaluation IDs were being duplicated in UserDefaults.
  • Fixes a bug where apps were freezing when InApps were being shown in low network conditions.

What's new

• [Android Platform]

  • Supports CleverTap Android SDK v8.3.0.

• [iOS Platform]

  • Supports CleverTap iOS SDK v7.7.1.
  • Silent-in-foreground push notifications via the wzrk_sif:true payload key — server-controlled, no app-side wiring needed when using autoIntegrate.

• [Android and iOS Platform]

  • App Inbox Cross-Device Sync — inbox state (read, deleted) syncs across a user's devices automatically. Includes a pull-to-refresh gesture in the built-in showInbox() view, throttled to once every 5 minutes.

• [Web Platform]

  • Supports CleverTap Web SDK v2.7.2
  • New API: getVariants() - Returns variants for the current user for A/B testing.

API changes

• [Android and iOS Platform]
  • New API: fetchInbox() - Triggers an on-demand App Inbox refresh (fire-and-forget), throttled to once every 5 minutes..
  • New API: fetchInboxWithCallback() - Triggers an on-demand App Inbox refresh and returns a Future<bool?> indicating success or failure, throttled to once every 5 minutes..
  • New API: pushDisplayUnitElementClickedEvent(unitId, additionalProperties) - Records a Notification Clicked event for a specific element within a Display Unit, enriched with caller-supplied additionalProperties.

Bug Fixes

• [iOS Platform]
  • Fixes a bug where server-side InApps evaluation IDs were being duplicated in UserDefaults.
  • Fixes a bug where apps were freezing when InApps were being shown in low network conditions.

• Adds support for Android 11
• Reduces the SDK size and added performance improvements
• Removes the deprecated Product Experiences (Screen AB/Dynamic Variables) related code
• Removes support for JCenter
• Fixes a bug where Xiaomi, Huawei, Baidu and other push service tokens were not switched to new profiles when using onUserLogin

What's new

• [Web Platform]
  • Supports CleverTap Web SDK v2.7.1
  • Adds null check for setLibrary function

What's new

• [Web Platform]
  • Supports CleverTap Web SDK v2.7.1
  • Adds null check for setLibrary function

• Adds support for configurable CleverTap identifiers.
• Adds deprecation warnings for Product A/B Tests public methods.
• Fix for multiple App Launched and App Installed events in the first session.
• Fixes crash which occurred due to wrong classification of some mobile devices as tablets #116.
• Optimized proguard rules for better obfuscation.

Version 4.0.0 (23 April 2026)

What's new

• [Android Platform]

  • Supports CleverTap Android SDK v8.1.0.
  • Deprecates ExoPlayer integration. Migration to Media3 is required before Android SDK v9.0.0.
  • Upgrades compileSDKVersion to 36

• [iOS Platform]

  • Supports CleverTap iOS SDK v7.6.0.

• [Android and iOS Platform]

  • Adds support for Picture-in-Picture (PiP) in-app notifications.
  • Adds support for GIF and video media in in-app notifications.
  • Adds support for App Inbox default media view.
  • Adds support for server-controlled mute durations via backend header.

API changes

• [Android and iOS Platform]
  • New API: unmute() - Resumes event tracking, overriding any active mute period.

Breaking Changes

• [Android Platform]
  • Raises minSdkVersion from 21 to 23. Devices running Android 5.x (API levels 21–22) are no longer supported.

Bug Fixes

• [iOS Platform]
  • Fixes a bug where onUserLogin was creating additional guids only for encryption level high.

What's new

• [Android Platform]

  • Supports CleverTap Android SDK v8.1.0.
  • Deprecates ExoPlayer integration. Migration to Media3 is required before Android SDK v9.0.0.
  • Upgrades compileSDKVersion to 36

• [iOS Platform]

  • Supports CleverTap iOS SDK v7.6.0.

• [Android and iOS Platform]

  • Adds support for Picture-in-Picture (PiP) in-app notifications.
  • Adds support for GIF and video media in in-app notifications.
  • Adds support for App Inbox default media view.
  • Adds support for server-controlled mute durations via backend header.

API changes

• [Android and iOS Platform]
  • New API: unmute() - Resumes event tracking, overriding any active mute period.

Breaking Changes

• [Android Platform]
  • Raises minSdkVersion from 21 to 23. Devices running Android 5.x (API levels 21–22) are no longer supported.

Bug Fixes

• [iOS Platform]
  • Fixes a bug where onUserLogin was creating additional guids only for encryption level high.

• Adds support for Android 10 and AndroidX support libraries.
• This is a major release, please find the list of all changes here

What's new

• [Web Platform]
  • Supports CleverTap Web SDK v2.5.5
  • Adds support for nested objects ingestion in event and profile properties

What's new

• [Web Platform]
  • Supports CleverTap Web SDK v2.5.5
  • Adds support for nested objects ingestion in event and profile properties

What's new

• [Android Platform]

  • Supports CleverTap Android SDK v7.8.0.

• [iOS Platform]

  • Supports CleverTap iOS SDK v7.5.0.

• [Android and iOS Platform]

  • Adds support for inaction in-app notifications. This server-side feature allows triggering in-app notifications when users do not perform specific actions within a defined timeframe.
  • Adds support for nested objects ingestion in event and profile properties, enabling more complex data structures for richer user profiling and event tracking.

What's new

• [Android Platform]

  • Supports CleverTap Android SDK v7.8.0.

• [iOS Platform]

  • Supports CleverTap iOS SDK v7.5.0.

• [Android and iOS Platform]

  • Adds support for inaction in-app notifications. This server-side feature allows triggering in-app notifications when users do not perform specific actions within a defined timeframe.
  • Adds support for nested objects ingestion in event and profile properties, enabling more complex data structures for richer user profiling and event tracking.

What's new

• [Android Platform]

  • Supports CleverTap Android SDK v7.7.1.

• [iOS Platform]

  • Supports CleverTap iOS SDK v7.4.2.

API changes

• [Android and iOS Platform]
  • New API: getVariants() - Returns experiment variant information for the current user for A/B testing.
  • Updates discardInAppNotifications({bool? dismissInAppIfVisible}) - Adds optional parameter to dismiss any currently visible In-App notification in addition to discarding queued notifications.

What's new

• [Android Platform]

  • Supports CleverTap Android SDK v7.7.1.

• [iOS Platform]

  • Supports CleverTap iOS SDK v7.4.2.

API changes

• [Android and iOS Platform]
  • New API: getVariants() - Returns experiment variant information for the current user for A/B testing.
  • Updates discardInAppNotifications({bool? dismissInAppIfVisible}) - Adds optional parameter to dismiss any currently visible In-App notification in addition to discarding queued notifications.

What's new

• [Android Platform]
  • Supports CleverTap Android SDK v7.6.0.

What's new

• [Android Platform]
  • Supports CleverTap Android SDK v7.6.0.

• [Web Platform]

  • Supports CleverTap Web SDK v2.3.0
  • Fixed a bug where the method 'addKVDataChangeListener()' was not returning the kv data.

• [Android Platform]

  • Supports CleverTap Android SDK v7.5.2.

• [iOS Platform]

  • Supports CleverTap iOS SDK v7.3.3.

What's new

• [Web Platform]

  • Supports CleverTap Web SDK v2.3.0
  • Fixed a bug where the method 'addKVDataChangeListener()' was not returning the kv data.

• [Android Platform]

  • Supports CleverTap Android SDK v7.5.2.

• [iOS Platform]

  • Supports CleverTap iOS SDK v7.3.3.

What's new

• [Android Platform]
  • Supports CleverTap Android SDK v7.5.1.

What's new

• [Android Platform]
  • Supports CleverTap Android SDK v7.5.1.

What's new

• [Web Platform]

  • Supports CleverTap Web SDK v2.1.2

• [iOS Platform]

  • Supports CleverTap iOS SDK v7.3.2.

What's new

• [Web Platform]

  • Supports CleverTap Web SDK v2.1.2

• [iOS Platform]

  • Supports CleverTap iOS SDK v7.3.2.

• [Android Platform]

  • Supports CleverTap Android SDK v7.5.0.

• [iOS Platform]

  • Supports CleverTap iOS SDK v7.3.1.

• [Web Platform]

  • Supports CleverTap Web SDK v1.17.0
  • Removes the method 'enableWebPushNotifications()' as 'enableWebPush()' method handles custom web push prompt
  • Removed js package dependency as it is discontinued.
  • Supports Web Assembly(WASM) build

API changes

• [Android and iOS Platform]
  • Updates the setOptOut(userOptOut) API. This upgraded API improves GDPR opt-out functionality by allowing you to control whether critical system events (such as app installs, uninstalls, and push notification registration) are still sent to CleverTap, even when a user has opted out of tracking. This helps you respect user privacy choices while still maintaining essential app functionality and compliance with regulations. This is non-breaking change.
    • setOptOut(userOptOut, allowSystemEvents)

Bug Fixes

• [iOS Platform]
  • Fixes a No new templates are synced error while syncing new custom templates.
  • Fixes a Local Push Primer crash when asking for push permission using promptForPushPermission.

What's new

• [Android Platform]

  • Supports CleverTap Android SDK v7.4.1.

• [iOS Platform]

  • Supports CleverTap iOS SDK v7.2.1.

What's new

• [iOS Platform]
  • Supports CleverTap iOS SDK v7.1.1.
  • Adds dismissInAppNotification action to dismiss custom HTML in-Apps

Bug Fixes

• [Android Platform]

  • Fixes an issue where images failed to render in push templates when using a custom FCM integration.

• [iOS Platform]

  • Fixes app freezing issue when using await with defineVariables().
  • Fixes custom in-app device orientation check.

⚠️ NOTE
Please refer to this guide for changed integration steps for Huawei PushProvider.

What's new

• [Android Platform]
  • Supports CleverTap Android SDK v7.3.1.
  • Adds new API to register push tokens for providers other than FCM
    • pushRegistrationToken(String value, Map<String, String> pushType): Register the token for the specified PushType. Refer here for example usage.

Breaking API Changes

• [Android Platform]
  • Removes: The legacy token registration APIs have been removed to make push providers injectable. The removed APIs include:
    • setBaiduPushToken(String value)
    • setHuaweiPushToken(String value)

⚠️ NOTE After upgrading the SDK to v3.2.0, don't downgrade in subsequent app releases. If you encounter any issues, please contact the CleverTap support team for assistance.

What's new

• [Android Platform]
  • Supports CleverTap Android SDK v7.2.2.
  • Adds support for Android 15, making it compliant with Android 15 requirements. Details here.
  • Upgrades the algorithm used for encryption of PII data, making it compliant with OWASP. Uses AndroidKeyStore for securely backing up encryption key on API levels 23+.
  • Updates minSdkVersion to API 21 (Android 5.0).
  • Upgrades Android Gradle Plugin (A.G.P) to 8.6.1 as recommended for Android 15

What's new

• [Android Platform]

  • Supports CleverTap Android SDK v7.1.2.
  • Adds support for Flutter 3.29 by removing Embedding v1 support, which was deprecated long ago. If your project still relies on Embedding v1, follow the migration guide to update it. (by @rwrz)
  • Adds support to hide large icon in android notifications by sending wzrk_hide_large_icon key in notification payload.

• [iOS Platform]

  • Supports CleverTap iOS SDK v7.1.0.

• [Android and iOS Platform]

  • Adds support for triggering InApps based on first-time event filtering in multiple triggers. Now you can create campaign triggers that combine recurring and first-time events. For example: Trigger a campaign when "Charged" occurs (every time) OR "App Launched" occurs (first time only).

  • Adds new user-level event log tracking system to store and manage user event history. New APIs include:

    • getUserEventLog(<eventName>): Get details about a specific event
    • getUserEventLogCount(<eventName>): Get count of times an event occurred
    • getUserLastVisitTs(): Get timestamp of user's last app visit
    • getUserAppLaunchCount(): Get total number of times user has launched the app
    • getUserEventLogHistory(): Get full event history for current user

  • API Changes

    • Deprecates: The old event tracking APIs tracked events at the device level rather than the user level, making it difficult to maintain accurate user-specific event histories, especially in multi-user scenarios. The following methods have been deprecated in favor of new user-specific event tracking APIs that provide more accurate, user-level analytics. These deprecated methods will be removed in future versions with prior notice:
      • eventGetDetail(): Use getUserEventLog() instead for user-specific event details
      • eventGetOccurrences(): Use getUserEventLogCount() instead for user-specific event counts
      • eventGetFirstTime(): Use getUserEventLog() instead for user-specific first occurrence timestamp
      • eventGetLastTime(): Use getUserEventLog() instead for user-specific last occurrence timestamp
      • sessionGetPreviousVisitTime(): Use getUserLastVisitTs() instead for user-specific last visit timestamp
      • sessionGetTotalVisits(): Use getUserAppLaunchCount() instead for user-specific app launch count
      • getEventHistory(): Use getUserEventLogHistory() instead for user-specific event history

What's new

• [Android Platform]

  • Supports CleverTap Android SDK v7.0.3.
  • Adds support for custom handshake domain configuration in android manifest.

• [iOS Platform]

  • Supports CleverTap iOS SDK v7.0.3.
  • Adds support for custom handshake domains.

• [Android and iOS Platform]

  • Adds support for File Type Variables in Remote Config. Please refer to the Remote Config Variables doc to read more on how to integrate this in your app.
  • Adds support for Custom Code Templates. Please refer to the CustomCodeTemplates.md doc to read more on how to integrate this in your app.
  • Adds support for custom code in-app templates definitions through a json scheme.

Bug Fixes

• [Android Platform]
• Fixes #275 - Fixes NPE when casting object to string for PN clicked event.

What's new

• [Android Platform]

  • Supports CleverTap Android SDK v7.0.1.
  • Adds support for triggering InApps based on user attribute changes.
  • Removes character limit of maximum 3 lines from AppInbox messages.
  • Adds support for AndroidX Media3 in lieu of the deprecation of ExoPlayer. While Clevertap continues to support ExoPlayer, migration is recommended. For migration refer here.

• [iOS Platform]

  • Supports CleverTap iOS SDK v7.0.1.
  • Adds support for triggering in-app notifications on User Attribute Change.

• [Web Platform]

  • Adds the method 'enableWebPushNotifications()' to support custom Web Push Prompt
  • Supports CleverTap Web SDK v1.11.2

Bug Fixes

• [All Platforms]

  • Fixes #260 - an issue related when running pub get from a Windows Machine

• [Android Platform]

  • Fixes an ANR caused by extremely old InApp campaigns.
  • Fixes an issue where incorrect callbacks were sent for InApps when the phone was rotated.
  • Fixes an issue where an InApp was displayed even after all the campaigns were stopped.
  • Fixes an issue where the InApp image was not shown when the phone was rotated to landscape.
  • Fixes an issue where certain URLs loaded incorrectly in custom HTML InApp templates.

• [iOS Platform]

  • Fix HTML view controller CTInAppHTMLViewController presented before scene became active. Use keyWindow supported orientations for CTInAppDisplayViewController.

Bug Fixes

• [Web Platform]

  • Adds the method 'addKVDataChangeListener()' to get the custom KV Pair data
  • Supports CleverTap Web SDK v1.9.1

• [Android Platform]

  • Fixes a date conversion issue for dates before January 1, 1970.
  • Fixes a ClassCastException for setMinimumFetchIntervalInSeconds in ProductConfig.
  • Fixes the missing support for profileGetProperty.

• [iOS Platform]

  • Fixes iOS platform channel messages must be sent on the platform thread issue.
  • Fixes the missing support for profileGetProperty.

What's new

• [Web Platform]
  • Added the method 'recordChargedEvent' for web

Bug Fixes

• [Web Platform]

  • Added JS package dependency to handle latest versions.

• [Android Platform]

  • Fixes #114 - an issue related to callbacks from native to dart when a 3rd party plugin like flutter_workmanager is used.

Bug Fixes

• [Web Platform]
  • Removes JS package dependency

What's new

• [Web Platform]

  • Supports CleverTap Web SDK v1.7.3.
  • Adds support for Remote Config Variables. Please refer to the Remote Config Variables doc to read more on how to integrate this to your app.

• [Android Platform]

  • Supports CleverTap Android SDK v6.2.1.

• [iOS Platform]

  • Supports CleverTap iOS SDK v6.2.1.

Breaking Changes

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

Bug Fixes

• [Android Platform]

  • Extends the push primer callback to notify permission denial when cancel button is clicked on PromptForSettings alert dialog.
  • 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.

• [iOS Platform]

  • Fixes a build error related to privacy manifests when statically linking the SDK using Cocoapods.

What's new

• [Android Platform]

  • Supports CleverTap Android SDK v6.1.1.
  • Supports Android 14, made it compliant with Android 14 requirements. Details here
  • Upgrades AGP to 8.3.0 for building the SDK and adds related consumer proguard rules
  • Deprecates Xiaomi public methods as we are sunsetting SDK. Details here.
  • Adds Accessibility ids for UI components of SDK
  • Migrates JobScheduler to WorkManager for Pull Notifications.

• [iOS Platform]

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

Bug Fixes

• [Android Platform]

  • Fixes InApps crash in a rare activity destroyed race condition
  • Fixes Potential ANR in a race condition of SDK initialisation in multithreaded setup
  • Fixes #211

• [iOS Platform]

  • Fixes crash due to out of bounds in NSLocale implementation.

What's new

• [Android Platform]

  • Supports CleverTap Android SDK v6.0.0.

• [iOS Platform]

  • Supports CleverTap iOS SDK v6.0.0.

• [Android and iOS Platform]

  • Adds support for client-side in-apps.
  • Adds new API clearInAppResources(boolean) to delete images and gifs which are preloaded for inapps in cs mode
  • Adds new API fetchInApps() to explicitly fetch InApps from the server

Bug Fixes

• [Android Platform]

  • Fixes a bug where JavaScript was not working for custom-html InApp header/footer templates.
  • Fixes an NPE related to AppInbox APIs.
  • Fixes a ClassCastException in defineVariable API of Product Experiences.
  • Fixes a resource name conflict with the firebase library in fcm_fallback_notification_channel_label
  • Fixes a StrictMode Violation spawning from ctVariables.init().
  • Removes use of lossy conversions leading to an issue in PushTemplates.
  • Handles an edge case related to migration of encryption level when local db is out of memory

• [iOS Platform]

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

What's new

• [Web Platform]
  • Supports CleverTap Web SDK v1.6.10.

Bug Fixes

• [Web Platform]
  • Fixes #213 - Event structure invalid error.

What's new

• [iOS Platform]

  • Supports CleverTap iOS SDK v5.2.2

• [Web Platform]

  • Supports CleverTap Web SDK v1.6.9. Please refer to Usage-Web.md to integrate and use Clevertap Web SDK in flutter.

What's new

• [Android Platform]

  • Supports CleverTap Android SDK v5.2.1.
  • Adds Custom Proxy Domain functionality for Push Impressions and Events raised from CleverTap Android SDK. Please refer to Usage.md file to read more on how to configure custom proxy domains in Android.

• [iOS Platform]

  • Supports CleverTap iOS SDK v5.2.1.
  • Adds support to enable NSFileProtectionComplete to secure App’s document directory.

• [Android and iOS Platform]

  • Adds in-built support to send the default locale(i.e.language and country) data to the dashboard and exposed public API CleverTapPlugin.setLocale(Locale locale) to set the custom locale, for LP Parity.
  • Adds support for Integration Debugger to view errors and events on the dashboard when the debugLevel is set to 3 using CleverTapPlugin.setDebugLevel(3).

Changes

• [iOS Platform]
  • Updated logic to retrieve country code using NSLocale above iOS 16 as CTCarrier is deprecated above iOS 16 with no replacements, see Apple Doc.
  • Updated logic to not send carrier name above iOS 16 in CTCarrier field.

Bug Fixes

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

What's new

• [Android Platform]

  • Supports CleverTap Android SDK v5.2.0.

• [iOS Platform]

  • Supports CleverTap iOS SDK v5.2.0.

• [Android and iOS Platform]

  • Adds support for encryption of PII data wiz. Email, Identity, Name and Phone. Please refer to Usage.md file to read more on how to enable/disable encryption of PII data.
  • Adds support for custom KV pairs common to all inbox messages in App Inbox.

Bug Fixes

• [Android Platform]
  • Fixes #393 - push permission flow crash when context in CoreMetadata is null.
  • Fixes a bug where addMultiValueForKey and addMultiValuesForKey were overwriting the current values of the user properties instead of appending it.

What's new

• Supports CleverTap iOS SDK v5.1.2

Bug Fixes

• [iOS Platform]
  • Fixed a bug where the App Inbox would appear empty.

What's new

• Supports CleverTap Android SDK v5.1.0
• Supports CleverTap iOS SDK v5.1.1
• Note: RenderMax Push SDK functionality is now supported directly within the CleverTap Core SDK. Please remove the integrated RenderMax SDK before you upgrade to CleverTap Flutter SDK for this 1.8.0 version.
• Adds support for notification click handling when the app is terminated or killed. The CleverTap plugin provides two ways to handle user interactions with notifications, depending on whether the app needs to perform UI or non-UI operations.
  • Use CleverTapPlugin.getAppLaunchNotification() to perform UI impacting operation like redirecting the user to a specific page.
  • Use CleverTapPlugin.onKilledStateNotificationClicked(_onKilledStateNotificationClickedHandler) to perform non-UI operation like performing HTTP requests, IO operations with local storage etc. Please refer to the Notification Click Handling to learn more about properly handling notification clicks.
• [Android Platform]: Adds support for developer defined default notification channel. Please refer to the Usage.md file to read more on how to setup default channel in your app.Also please note that this is only supported for clevertap core notifications. Support for push templates will be released soon.

Changes

• The CleverTapPlugin.createNotification(data) API now supports rendering push template notifications and handling VoIP push for the SignedCall SDK.

Bug Fixes

• [iOS Platform]
  • Fixed Cocoapods generated duplicate UUIDs warnings.
  • Mitigates potential App Inbox errors.
• [Android Platform]
  • Fixes #428 - Race-condition when detecting if an in-app message should show.
  • Fixes Push primer alert dialog freeze behavior, which became unresponsive when clicked outside the window.

What's new

• Adds support for Remote Config Variables. Please refer to the Remote Config Variables doc to read more on how to integrate this to your app.
• Adds new API dismissInbox() to dismiss the App Inbox screen.
• Adds new APIs, markReadInboxMessagesForIDs(List<String>) and deleteInboxMessagesForIDs(List<String>) to mark read and delete an array of Inbox Messages respectively.
• Supports CleverTap Android SDK v5.0.0
• Supports CleverTap iOS SDK v5.0.1

API Changes

Deprecated: The following methods and classes 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 classes will be removed in the future versions with prior notice.

• Product config

  • setDefaultsMap
  • fetch
  • activate
  • fetchAndActivate
  • setMinimumFetchIntervalInSeconds
  • resetProductConfig
  • getProductConfigString
  • getProductConfigBoolean
  • getNumber
  • getLastFetchTimeStampInMillis

• Feature flags

  • getFeatureFlag

Breaking Change

• Streamlines the payload for various callbacks across Android and iOS platform. Refer doc for detailed changes.
• [Android and iOS platforms] Signature change of the CleverTapInboxNotificationMessageClickedHandler callback]: It is changed from CleverTapInboxNotificationMessageClickedHandler(Map<String, dynamic>? data) to CleverTapInboxNotificationMessageClickedHandler(Map<String, dynamic>? data, int contentPageIndex, int buttonIndex). 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 contentPageIndex value is always 0, as they only have one page of content. The buttonIndex corresponds to the the App Inbox button clicked (0, 1, or 2). A value of -1 in buttonIndex field indicates the entire App Inbox Item is clicked.

Changes

• [Android Platform] Behavioral change of CleverTap.CleverTapInboxMessageTapped listener: Previously, the callback was raised when the App Inbox item is clicked. Now, it is also raised when the App Inbox button is clicked. It matches the behavior in iOS platform.

Bug Fixes

• Fixes a bug where App Inbox was not respecting the App Inbox background color when no tabs are provided.
• Fixes the non-EU retry mechanism bug.
• Fixes the data handling exception that is thrown by the processPushNotification(dynamic data) API.

• Fixed compilation errors in Xcode 14.3+ in iOS.
• Streamlined the argument of onDisplayUnitsLoaded callback method in iOS to directly pass display unit array.
• Supports CleverTap iOS SDK v4.2.2

• Adds below new public APIs to support CleverTap Android SDK v4.7.4 and CleverTap iOS SDK v4.2.0
  • getPushNotificationPermissionStatus(), promptPushPrimer(object), promptForPushNotification(boolean)
• Adds push permission callback method setCleverTapPushPermissionResponseReceivedHandler which returns true/false after user allows/denies the notification permission.
• Adds setCleverTapInAppNotificationShowHandler to handle InApp notification shown - Only for Android.
• Streamlined the format of native display payload across Android and iOS.
• Fixes the FCM Plugin's onBackgroundMessage handler bug which was breaking the CleverTap Plugin's platform channel for sending method calls from Android.

Added

• Supports CleverTap Android SDK v4.6.9
• Supports CleverTap iOS SDK v4.2.2
• Adds the new public API dismissInbox() to dismiss the App Inbox.
• Note: This release is being done for Android 12 targeted users.

Changed

• [Breaking change to the signature of the CleverTapInboxNotificationMessageClickedHandler callback]: It is changed from CleverTapInboxNotificationMessageClickedHandler(Map<String, dynamic>? data) to CleverTapInboxNotificationMessageClickedHandler(Map<String, dynamic>? data, int contentPageIndex, int buttonIndex). 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 contentPageIndex value is always 0, as they only have one page of content. The buttonIndex corresponds to the the App Inbox button clicked (0, 1, or 2). A value of -1 in buttonIndex field indicates the entire App Inbox Item is clicked.
• [Behavioral change of the CleverTapInboxNotificationMessageClickedHandler callback]: Previously, the callback was raised when the App Inbox Item is clicked. Now, it is also raised when the App Inbox button is clicked besides the item click.
• [Native Display parity changes]:
  • Streamlines the format of native display payload across Android and iOS.
  • Streamlines the argument of onDisplayUnitsLoaded callback method in iOS to pass the list of displayUnits.

Fixed

• Fixes the FCM Plugin's onBackgroundMessage handler bug which was breaking the CleverTap Plugin's platform channel for sending method calls from Android to Dart platform.
• Fixes the Xcode 14.3+ compilation errors in iOS.

• Adds fix for closing App Inbox controller when deeplink is present in iOS.
• Supports add-to-app feature for Android platform to embed the CleverTap plugin in a flutter module.

• Supports CleverTap iOS SDK v4.1.4

• Fixes incorrect API being called in profileAddMultiValues in iOS.

• Supports CleverTap Android SDK v4.6.3
• [Breaking Change] setXiaomiPushToken API has been modified to accept region to comply with new Mi Push Region changes. Refer to CleverTap Xiaomi Push SDK v1.5.0 Changelog
• Supports CleverTap iOS SDK v4.1.2

• Adds the missing getter methods for Product Config in iOS.

• Supports CleverTap Android SDK v4.4.0
• Supports CleverTap iOS SDK v4.0.0

• Adds fix for NPE #61
• Adds result.success(null) for all method calls #81
• Supports CleverTap Android SDK v4.3.1

• Adds public methods for suspending, discarding & resuming InApp Notifications
• Adds public methods to increment/decrement values set via User properties
• Deprecates profileGetCleverTapID() and profileGetCleverTapAttributionIdentifier() methods
• Adds a new public method getCleverTapID() as an alternative to above deprecated methods
• Supports CleverTap iOS SDK v3.10.0

• Supports CleverTap Android SDK v4.2.0
• Adds fix for NPE #58
• Adds fix for recordScreen NPE #54

• Supports CleverTap Android SDK v4.1.1
• Supports CleverTap iOS SDK v3.9.4
• Removes Product A/B Testing (Dynamic Variables) code
• Removes profileSetGraphUser method
• Adds pushNotificationViewedEvent and pushNotificationClickedEvent

• Update and Freeze CleverTap Plugin Podspec to a specific version of a CleverTap iOS SDK

• Supports CleverTap Android SDK v4.0.0
• Supports CleverTap iOS SDK v3.9.1

• Supports CleverTap Android SDK v3.8.2

• Use v1.1.4
• Adds a callback to provide Push Notifications custom key-value pairs
• Supports CleverTap Android and iOS SDK v3.8.1
• Sample App Updated

• Use v1.1.4
• Adds support for Product Config and Feature Flags
• Adds support for Custom Handling Push Amplification Campaigns
• Supports CleverTap Android and iOS SDK v3.8.0

• Use v1.1.4
• Adds support for Custom App Inbox
• Adds support for InApp/Inbox button click listeners
• Adds support for Notification Clicked/Viewed for App Inbox
• Adds support for passing Xiaomi/Baidu tokens.
• Supports CleverTap Android SDK v3.7.2
• Supports CleverTap iOS SDK v3.7.3

• Adds support for Dynamic Variables & Native Display
• Adds support for Google Play Install Referrer Library v1.0
• Supports CleverTap Android SDK v3.6.4
• Supports CleverTap iOS SDK v3.7.2

• Initial Release.
• Supports CleverTap Android SDK v3.6.1
• Supports CleverTap iOS SDK v3.7.2