Changelog

• Bug fix
  • SessionReplay: Fixed an Android issue that could affect the positioning of certain elements.

• Analytics:
  • Introduce Heatmap feature
• Session Replay:
  • Added new APIs to start Session Replay on demand
• Native SDKs:
  • Android: 4.40.0 → 4.41.0
• 🚨 Minimum iOS and Flutter version
  • Contentsquare plugin now requires Flutter SDK 3.19.6 or later

• Native SDKs:
  • iOS: 4.42.2 → 4.43.0
  • Android: 4.39.1 → 4.40.0
• Session Replay:
  • Support fl_chart ↗ widgets and masking
  • Support Image/Text remote masking configuration in the CSQ Console
  • Added new APIs to support Event-Triggered Replays
• 🚨 Minimum iOS and Flutter version announcement
  • Starting with the next release (3.19.0), Contentsquare plugin will require Flutter SDK to be 3.19.0 or later

• Native SDKs:
  • iOS: 4.42.0 → 4.42.2

• Session Replay
  • Improve stability on very heavy screens
• 🚨 Minimum Flutter and iOS version change
  • Contentsquare plugin now requires Flutter SDK 3.16.9 or later
  • Contentsquare plugin now requires iOS 13.0 or later
• Native SDKs:
  • iOS: 4.40.2 → 4.42.0
  • Android: 4.36.1 → 4.39.1

• Bug fix
  • Android: Fixed an issue that could affect remote full masking based on the app version.

• Session Replay
  • Support all ExcludeSemantics widgets
  • Support IgnorePointer and AbsorbPointer widgets

• Bug fix:
  • Fix an Android bug where API changed in Android 15 crash with java.lang.NoSuchMethodError from java.util.List.
• Native SDK update
  • Android: 4.36.0 → 4.36.1

• Session Replay
  • Support full remote masking configuration by APP/SDK versions through the CSQ Console
  • Support Session Replay gestures in the player’s event stream
  • Add the ability to mask CustomPaint
  • Android Webviews in Session Replay have now the expected sizes
• Snapshot
  • Fix a crash that could occur when taking a snapshot on Android
• API
  • Contentsquare.start and ContentsquareNavigatorObserver are now officially supported. The @experimental annotation has been removed.
• 🚨 Minimum iOS and Flutter version announcement
  • Starting with the next release (3.17.0), Contentsquare plugin will require iOS version to be 13.0 or later
  • Starting with the next release (3.17.0), Contentsquare plugin will require Flutter SDK to be 3.16.9 or later
• Native SDK update
  • iOS: 4.38.2 → 4.40.2
  • Android: 4.34.0 → 4.36.0

• Bug fix:
  • Fixed a bug, where an improperly tracked tap could create an exception.

• Bug fix:
  • Fixed a bug, when unable to zone bottom bar
  • Fixed a bug on iOS, when the webview zones become displaced when snapshot is scrolled
  • Fixed a bug, when bottom dialog shows up after the language changes

• Zoning
  • Fixed a bug where ReliableTargets could be not properly tracked in some cases, when multiple lists containing a Reliable Target in the same index, are switched in the same area of the screen.

• 🚨 Minimum Flutter version announcement
  • Starting with the next release (3.16.0), Contentsquare plugin will require Flutter SDK 3.13.9 or later
• Experience Analytics
  • Introduce collection of Flutter errors feature
• Session Replay
  • Support Text widgets when they are wrapped with Semantics or contain semanticsLabel
  • Improve performance and stability
  • Support Opacity widget
  • Fix a bug in onSessionReplayLinkChange for android where the link is not updated after the app returns from background
• Other
  • Resolve an issue that could prevent building obfuscated Android applications with Android Gradle Plugin (AGP) versions 8.4.0 and later

• Native SDK update
  • iOS: 4.37.2 → 4.38.2
  • Android: 4.33.2 → 4.34.0

• WebView support:
  • Improve support for WebViews
• Logging:
  • Fix an issue where warning logs were incorrectly displayed as error logs
• Dependencies:
  • Updated protobuf dependency in pubspec.yaml to >=2.0.0 <4.0.0

• Privacy
  • Fix a bug occurring to resumeTracking when CSInApp is enabled
• Native SDKs:
  • Android: 4.33.1 → 4.33.2

• API
  • Adds ContentsquareNavigatorObserver to automatically track screen changes (as an experimental feature)
  • Adds start method to manually start the SDK (as an experimental feature)
• Session Replay:
  • Adds more fidelity in replays
    • Texts and icons have now high fidelity
    • Font uploading is no longer needed for android and iOS
• 🚨 Minimum Flutter version change
  • Contentsquare plugin now requires Flutter SDK 3.10.6 or later
• Native SDKs:
  • iOS: 4.36.0 → 4.37.2
  • Android: 4.32.1 → 4.33.1

• 🚨 Minimum Flutter version announcement

  • Starting with the next release (3.14), Contentsquare plugin will requires Flutter SDK 3.10.1 or later

• Analytics:

  • Fix an issue occurring on iOS Zoning snapshot when a custom root ViewController is used

• Session Replay:

  • Fix an issue occurring in Session Replay when a CustomPainter animation is disposed

• Native SDKs:

  • iOS: 4.36.0 → 4.36.1

• WebViews

  • Improved webViews tracking with the new widget ContentsquareWebViewWrapper

• Native SDKs:

  • iOS: 4.35.0 → 4.36.0
  • Android: 4.31.0 → 4.32.1

• Session Replay:
  • Support dynamic QualityLevels in the SessionReplay (low, medium and high)
  • Improve SessionReplay performance
  • Fidelity improvements
    • Support CustomPaint
    • Support borders
    • Support checkboxes, radio buttons, and switches
    • Support SVG images (for flutter_svg package)
    • Additional support for Decorations
  • Fixed error that occurs when RichText is masked
• Native SDKs:
  • iOS: 4.33.1 → 4.35.0
  • Android: 4.29.1 → 4.31.0

• Native SDKs:
  • iOS: 4.33.0 → 4.33.1
  • Android: 4.29.0 → 4.29.1

• Session Replay:
  • Improve fidelity
  • Support images and gradient colors in ShapeDecoration
• ApiErrors:
  • Introduce a gentle HttpOverride
  • Fix a bug with tracking requests in dio package
• Native SDKs:
  • iOS: 4.32.0 → 4.33.0
  • Android: 4.28.0 → 4.29.0

• Session Replay:
  • Added support for WidgetSpan
• Native SDKs:
  • iOS: 4.31.2 → 4.32.0
  • Android: 4.27.1 → 4.28.0
• 🚨 Minimum Flutter version change
  • Contentsquare plugin now requires Flutter SDK 3.3.10 or later.

• Session Replay:
  • Add public API: onSessionReplayLinkChange to listen to Session Replay URL changes during app lifecycle
  • Deprecate public API: currentSessionReplayUrl
  • Performance improvement in Android Session Replay
  • Partially support gradient colors in Session Replay as solid color
  • Fix a bug happening when CS in-app is opened while Session Replay is running, on Android
  • Fix a minor bug displaying a warning as an error during Session Replay
• Platform support:
  • Contentsquare SDK is now completely disabled on unsupported platforms (Desktop and Web) and non mobile apps can now be built safely.
• Native SDKs:
  • iOS: 4.30.2 → 4.31.2
  • Android: 4.26.0 → 4.27.1

• API:
  • forgetMe has been deprecated
• Session Replay:
  • Fix a bug that could occur when using the span widget
  • Fix a bug that stops the Session Replay when translation animation is set to infinity, that could happen if BottomNavigationBar’s selectedFontSize is set to 0
• Analytics:
  • Fix an issue in webviews using the tracking tag that impacted the launch of Analytics
• Snapshot:
  • Fixed a bug that could lead to a restart of the app state during the usage of CS in-app tool
• Native SDKs:
  • iOS: 4.29.1 → 4.30.2
  • Android: 4.24.1 → 4.26.0
    • ⚠️ compileSdkVersion requirement has fallen back to 33
    • Added support to use ProGuard for minification and shrinking

• Snapshots:
  • A bug provoking state restart while taking snapshots from CS in-app is fixed
  • A bug provoking state restart of ContentsquareRoot when displaying CS in-app is fixed
• Session Replay
  • Fix an issue on Android Session Replays
  • Support of webviews was added to the Session Replay for both Android and iOS platforms (check the documentation for additional implementation steps)
  • From now on, the masking configuration can be changed dynamically during the Session Replay on the Flutter elements
• Native SDKs:
  • iOS: 4.27.0 → 4.29.1
  • Android: 4.23.1 → 4.24.1
    • ⚠️ compileSdkVersion should be bumped to 34

• [🚨 Maximum Flutter version]
  • Add support of the latest Flutter version (3.16 and later)

• API Errors:
  • Support of the API Errors feature has been added to Android platform
• Session Replay
  • Support of the Session Replay feature has been added to Android platform
• Reliable Targets
  • Support of the Reliable Targets feature has been added to both Android and iOS platforms
• User Identifier
  • Support of the User Identifier feature has been added to both Android and iOS platforms
• Native SDKs:
  • Android: 4.21.0 → 4.23.1
  • iOS: 4.25.0 → 4.27.0
• [🚨 Maximum Flutter version]
  • Currently, the maximum Flutter version supported by the plugin is 3.13.9.
  • Support of the Flutter version 3.16 and later is added back in the plugin 3.5.1. Update the plugin if you are using Flutter 3.16 or later.

• Custom Variables:
  • Support of the Custom Variables feature has been added to Android
• API Errors:
  • Support of the API Errors feature has been added to iOS
• Session Replay
  • Minor fidelity improvements
• Native SDKs:
  • Android: 4.20.0 → 4.21.0
  • iOS: 4.24.0 → 4.25.0
• [🚨 Maximum Flutter version]
  • Currently, the maximum Flutter version supported by the plugin is 3.13.9.
  • Support of the Flutter version 3.16 and later is added back in the plugin 3.5.1. Update the plugin if you are using Flutter 3.16 or later.

• Native SDKs:
  • Android: 4.19.0 → 4.20.0
  • iOS: 4.23.0 → 4.24.0
• Session Replay
  • Minor fidelity improvements
• Custom Variables:
  • Support of the Custom Variables feature has been added to iOS
• API Errors:
  • Added a log when API Errors collection is enabled or disabled in iOS (for future usage)
• [🚨 Maximum Flutter version]
  • Currently, the maximum Flutter version supported by the plugin is 3.13.9.
  • Support of the Flutter version 3.16 and later is added back in the plugin 3.5.1. Update the plugin if you are using Flutter 3.16 or later.

• Bug fix:
  • Fixed an issue on Android, causing a crash during the initialization of the SDK. Bug was introduced since the release of 3.1.0
• [🚨 Maximum Flutter version]
  • Currently, the maximum Flutter version supported by the plugin is 3.13.9.
  • Support of the Flutter version 3.16 and later is added back in the plugin 3.5.1. Update the plugin if you are using Flutter 3.16 or later.

• Bug fix: Fix critical bug for clients who use Flutter < 3.0 introduced in the CS SDK release 3.1.0
• API:
  • New method getter currentSessionReplayUrl (iOS Only)
• Session Replay fidelity improvements:
  • Shadows
  • Clipping
  • Radius
  • Transparency
  • Blur
• [🚨 Maximum Flutter version]
  • Currently, the maximum Flutter version supported by the plugin is 3.13.9.
  • Support of the Flutter version 3.16 and later is added back in the plugin 3.5.1. Update the plugin if you are using Flutter 3.16 or later.

• Native SDKs:
  • Android: 4.18.1 → 4.19.0
  • iOS: 4.22.1 → 4.23.0
• Session Replay improvements:
  • Added icons support
  • Performance improvement for unmasked images
• [🚨 Maximum Flutter version]
  • Currently, the maximum Flutter version supported by the plugin is 3.13.9.
  • Support of the Flutter version 3.16 and later is added back in the plugin 3.5.1. Update the plugin if you are using Flutter 3.16 or later.

• Native SDKs:
  • Android: 4.17.0 → 4.18.1
  • iOS: 4.21.0 → 4.22.1
• Session Replay feature is available for iOS only. For more information, reach out to your Contentsquare contact.
• [🚨 Maximum Flutter version]
  • Currently, the maximum Flutter version supported by the plugin is 3.13.9.
  • Support of the Flutter version 3.16 and later is added back in the plugin 3.5.1. Update the plugin if you are using Flutter 3.16 or later.

• Native SDKs:
  • Android: 4.16.0 → 4.17.0
  • iOS: 4.20.0 → 4.21.0

• Native SDKs:
  • Android: 4.15.0 → 4.16.0

• Native SDKs:
  • iOS: 4.18.0 → 4.20.0

• Bug fix: Track Transactions now supports any value while it would previously fail if the given transaction value contained decimals.

• WebView Tracking:
  • [🚨 Breaking Change 🚨] Feature: You can now use the SDK with any version of the webview_flutter plugin. However to do so we had to remove the first party support for this plugin. You can still use the generic webview tracking API. See the updated documentation for concrete implementation examples.
  • [🚨 Breaking Change 🚨] Refactoring: JavascriptChannel has been renamed to ContentsquareJavascriptChannel to avoid naming conflicts with other plugins.
  • Refactoring: tracker.initializeWebViewTracking has been renamed to tracker.startPageTracking. Using tracker.initializeWebViewTracking is deprecated and will be removed in a future release.

• Native SDKs:
  • Android: 4.14.0 → 4.15.0
  • iOS: 4.17.0 → 4.18.0
• Fix: Bump the lowest supported Dart SDK version from 2.12.0 to 2.15.0

• Native SDKs:
  • Android: 4.13.1 → 4.14.0
  • iOS: 4.13.0 → 4.17.0

• Snapshots: Beta third-party WebView tracking support (see flutter_inappwebview ↗)

• Snapshots: Beta WebView tracking support (only for the official WebView plugin ↗)

• Fix: Update dependency of contentsquare on contentsquare_plugin_interface

⚠️ This version is deprecated due to bad dependency which prevents the plugin from compiling. Use the latest version of the plugin instead.

• License: License update

• Bug fix: Fixed an issue on Android, where CS in-app features menu caused a crash while using the opt-out and opt-in operations
• Native SDKs: Android 4.11.0

• Error when building in profile mode: Bump compileSdkVersion to 31 to support Gradle version >= 4.2.0

• Snapshots:
  • Stability improvement for Navigator pushed screens

• Snapshots:
  • Fix issue on generating accurate targets for gestures
  • Only include widgets which are currently visible
• Native SDKs: Android 4.9.0 and iOS 4.13.0

• Snapshots: Fixed an issue where snapshot captured was not rendering the right screen.
• Gesture tracking: Fixed an issue on our gesture detector that could cause an exception to be thrown in edge cases.
• Native SDKs: Android 4.8.0 and iOS 4.12.0

• Snapshots: Fixed snapshot capture infinite loading on Android caused by WebView; fixed snapshot capture infinite loading on iOS caused by conflict with background_locator plugin; fixed visual bug with the app bar; fixed empty snapshot on iOS related to autostart disabled.
• Native SDKs: Android 4.8.0 and iOS 4.11.0

• Crash at app launch on Android: Fixed a bug introduced crashing the app on Android, at app start.

• Gesture tracking: Gesture tracking optimization; fixed issue preventing scrolling in WebView;
• Snapshots: Size Optimization.
• Native SDKs: Android 4.7.0 and iOS 4.11.0

• Native SDKs: Android 4.7.0 and iOS 4.10.1

• Gesture tracking: Fixed performance issue related to gesture tracking
• Snapshots: Support snapshot capture on iOS
• Native SDKs: Android 4.3.0 and iOS 4.10.0

• Gesture tracking: Now support gesture tracking accurately.