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 ofExoPlayer
. While Clevertap continues to supportExoPlayer
, 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
- Fixes #260 - an issue related when running
-
[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
forsetMinimumFetchIntervalInSeconds
inProductConfig
. - 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.
- Fixes #114 - an issue related to callbacks from native to dart when a 3rd party plugin like
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 todeviceInfo.deviceId
. - Fixes an ANR related to
isMainProcess
check. - Fixes an ANR due to eager initialisation of
CtApi
triggered by DeviceId generation.
- Extends the push primer callback to notify permission denial when cancel button is clicked on
-
[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)
.
- Adds in-built support to send the default locale(i.e.language and country) data to the dashboard and exposed public API
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.
- Updated logic to retrieve country code using NSLocale above iOS 16 as
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.
- Use
- [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>)
anddeleteInboxMessagesForIDs(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 fromCleverTapInboxNotificationMessageClickedHandler(Map<String, dynamic>? data)
toCleverTapInboxNotificationMessageClickedHandler(Map<String, dynamic>? data, int contentPageIndex, int buttonIndex)
. ThecontentPageIndex
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, thecontentPageIndex
value is always 0, as they only have one page of content. ThebuttonIndex
corresponds to the the App Inbox button clicked (0, 1, or 2). A value of -1 inbuttonIndex
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.
- 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.
- [Breaking change to the signature of the
CleverTapInboxNotificationMessageClickedHandler
callback]: It is changed fromCleverTapInboxNotificationMessageClickedHandler(Map<String, dynamic>? data)
toCleverTapInboxNotificationMessageClickedHandler(Map<String, dynamic>? data, int contentPageIndex, int buttonIndex)
. ThecontentPageIndex
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, thecontentPageIndex
value is always 0, as they only have one page of content. ThebuttonIndex
corresponds to the the App Inbox button clicked (0, 1, or 2). A value of -1 inbuttonIndex
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.
- 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()
andprofileGetCleverTapAttributionIdentifier()
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
andpushNotificationClickedEvent
- 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