cx_flutter_plugin 0.3.3

The Coralogix SDK for Flutter is designed to support various Flutter targets by leveraging the numerous platforms supported by Coralogix's native SDKs.

Changelog

0.3.3

Release Date: April 5, 2026

• Bug fix (release mode errors sent as log): In release builds, caught exceptions produced empty stack trace frames, causing the iOS bridge to fall through to reportError(message:data:) which the native SDK recorded as a log event instead of an error. The bridge now always routes through the error path when a parsed stack trace is present.
• Bug fix (release mode stack frames empty): The symbolicated frame regex required a column number, but Dart AOT (release) stack traces omit it. The parser now treats column numbers as optional so frames are populated correctly in release builds.
• version bump script: Added scripts/bump_version.sh to keep pubspec.yaml, lib/plugin_version.dart, and ios/cx_flutter_plugin.podspec in sync.
• Xcode ObfuscatedRelease configuration: Added ObfuscatedRelease build configuration to the example app for easy switching between symbolicated and obfuscated builds.

0.3.2

Release Date: March 31, 2026

• Bug fix (obfuscated stack traces): Frame addresses were always empty when reporting obfuscated Dart errors. The stack trace parser now correctly matches the Dart VM's abs-only frame format (introduced in Dart 3.x) and computes virtual addresses (abs − isolate_dso_base) expected by both the iOS and Android native SDKs.
• Bug fix (publish workflow): Release CI failed with a missing .env asset error when validating the example app. A stub .env file is now created before the validation step. (BUGV2-5531)

0.3.1

Release Date: March 26, 2026

• Bug fix: fragments field in network events was always empty. Both CxDioInterceptor and CxHttpClient now correctly report the URL path (e.g. /some/path) instead of the URI fragment. (BUGV2-5509)

0.3.0

Release Date: March 26, 2026

• Obfuscated error stack traces: Obfuscated stack traces now propagate and are exported correctly via the iOS bridge key centralisation.
• Performance (iOS): Fixed scroll lag caused by interaction tracking. The swipe-context widget tree walk is now performed once at pointer-down and cached, instead of running on every pointer-up/cancel. This eliminates main-thread jank during fast list scrolling when userActions is enabled.

0.2.0

Release Date: March 23, 2026

• CxDioInterceptor: New interceptor for Dio HTTP client. Add CxDioInterceptor() to your Dio instance to automatically capture network requests, generate RUM spans, and inject W3C traceparent headers — no migration from your existing networking layer required.
• NetworkCaptureRule: New networkCaptureConfig option on CXExporterOptions. Supply a list of CxNetworkCaptureRule objects to control which headers and payloads are captured per URL. Rules are matched in order (first match wins); when no rules are configured, no headers or payloads are captured. Bodies over 1024 characters are dropped entirely.
• Expanded network context: Both CxHttpClient and CxDioInterceptor now report status_text, request_headers, response_headers, request_payload, response_payload, and error_message. traceId/spanId are forwarded to the native Android SDK.
• beforeSend is now optional: When omitted, events are sent directly without a Dart-side round-trip, reducing platform channel overhead. Migration: if you relied on the implicit pass-through, set beforeSend: (event) => event explicitly.
• iOS setUserInteraction dispatched to main thread: Fixes Main Thread Checker warning caused by UIKit access on the background method-channel queue.
• iOS networkExtraConfig parsing: networkCaptureConfig rules are now parsed and forwarded to the native iOS SDK during initSdk.
• Performance (Android): CoralogixRum.initialize, Session Replay init, and captureScreenshot run on the main looper. reportError and sendCxSpanData run on a dedicated background executor.
• Performance (iOS): Method channel uses a background task queue when available. CoralogixRum initialization is dispatched to the main queue from background handlers.
• Native iOS SDK upgraded to 2.3.3
• Native Android SDK upgraded to 2.9.3

0.1.1

• Hybrid user interaction: When user enables userActions in options, Dart tracks click/scroll/swipe; iOS always receives userActions: false to avoid duplicate events.
• setUserInteraction: iOS forwards interaction payload to native SDK (2.2.0). Android forwards via reportUserInteraction (native SDK 2.9.0); returns error when event_name is missing or when SDK is not initialized (iOS).
• Context types aligned with native: EventContext source; DeviceContext operating_system/os_version, network_connection_type/network_connection_subtype, user_agent; ErrorContext exception_type; NetworkRequestContext request_headers/response_headers/request_payload/response_payload; InteractionContext target_element, element_classes, target_element_inner_text, scroll_direction with toJson() omitting nulls for beforeSend round-trip.
• Native iOS SDK 2.2.0; native Android SDK 2.9.0.
• Android: compileSdk 36 (plugin and example).

0.1.0

Added Android support for allowedTracingUrls in TraceParentInHeader configurations Native Android SDK upgraded to 2.7.2 Native iOS SDK upgraded to 2.1.0

0.0.21

Added support for session replay

0.0.20

Added the AP3 domain as an option for initializing the SDK with

0.0.19

Breaking Change: Flutter SDK Requirement

• The package now requires Flutter >=3.27.0 (as specified in pubspec.yaml environment: flutter: '>=3.27.0')
• This requirement is necessary to support the modern Color.withValues(alpha: ...) API, which replaced the deprecated Color.withOpacity() method
• The example app has been updated to use Color.withValues() for future compatibility
• Native iOS SDK upgraded to 1.5.3
• Bug fix: https://github.com/coralogix/cx-flutter-plugin/issues/37#issue-3715310863 Release Date: Jan 21, 2026

0.0.18

Release Date: Dec 10, 2025

Fix bug BUGV2-1468 Native android SDK upgraded to 2.6.3

0.0.17

Release Date: Nov 13, 2025

Fix bug BUGV2-1474 Native iOS SDK upgraded to 1.4.0

0.0.16

Release Date: Sep 28, 2025

Add sendCustomMeasurement Native iOS SDK upgraded to 1.2.6

0.0.15

Release Date: Sep 21, 2025

Native iOS SDK upgraded to 1.2.5

0.0.14

Release Date: Aug 10, 2025

Native iOS SDK upgraded to 1.1.2

0.0.13

Release Date: July 24, 2025

• fix: Android plugin now respect setting the userActions interaction to false and thus actually turning it off Native Android SDK upgraded to 2.4.44

0.0.12

Release Date: unknown

• New Feature add support for proxyUrl
• New Feature traceParentInHeader (iOS Only) Native iOS SDK upgraded to 1.0.26

0.0.11

Release Date: June 22, 2025

• Bug fixes Native iOS SDK upgraded to 1.0.24

0.0.10

Release Date: June 17, 2025

• Bug fixes - beforeSend not sending instrumentation in android and iOS
• Crash fix on Android

Native Android SDK upgraded to 2.4.41 Native iOS SDK upgraded to 1.0.23

0.0.9

Release Date: May 28, 2025

• Added Android support for the beforeSend operation
• Bug fixes and improvements

Native Android SDK upgraded to 2.4.4

0.0.8

Release Date: May 27, 2025

Added Android support for newly added methods:

• getLabels()
• getSessionId()
• isInitialized()
• setApplicationContext()
• Disable swizzling for iOS (NetworkOnly)

Added Android support for the beforeSend callback Breaking changes:

• The 'CxExporterOptions' class 'beforeSend' callback is now asynchronous.

Native iOS SDK upgraded to 1.0.22 Native Android SDK upgraded to 2.4.3

0.0.7

Release Date: May 8, 2025

Implemented the following:

• Before Send
• getLabels()
• getSessionId()
• isInitialized()
• setApplicationContext()

Native SDK upgraded to 1.0.21

0.0.6

Release Date: April 24, 2025

Fix Crash related to URLSessionInstrumentation. Navigation instrument was removed from CoralogixOptions Native SDK upgraded to 1.0.20

0.0.5

Release Date: April 8, 2025

Fix issue related to CustomDomainUrl was removed. Native SDK upgraded to 1.0.18

0.0.4

Release Date: February 10, 2025

Fixed bug preventing data to be sent if no custom url was set on Android.

0.0.3

Release Date: December 15, 2024

Android implementation added

0.0.2

Release Date: November 25, 2024

Enhancements SDK Initialization Sampling: Introduced sdkSampler, allowing configuration of the SDK's initialization rate as a percentage (0-100%).

FPS Sampling Rate Configuration: Added mobileVitalsFPSSamplingRate to set the frequency of FPS sampling per hour, with a default of once every minute.

Instrumentation Control: Implemented instrumentations, enabling selective activation or deactivation of specific instruments during runtime. By default, all instrumentations are active.

IP Data Collection Toggle: Added collectIPData to control the collection of user IP addresses and geolocation data, defaulting to true.

0.0.1

Added Android support for allowedTracingUrls in TraceParentInHeader configurations Native Android SDK upgraded to 2.7.2 Native iOS SDK upgraded to 2.1.0