Flutter SDK compatibility

This page describes the Flutter SDK support scope and current limits so you can determine whether your project meets the requirements before integration.

Support scope

Item	Support
SDK version	`flashcat_flutter_plugin` 0.2.1
Target platforms	iOS and Android (Flutter Web / Desktop not supported)
Flutter / Dart	Flutter ≥ 3.27.0, Dart ≥ 3.6.0
iOS	Deployment target ≥ 12.0
Android	`minSdkVersion` ≥ 23
RUM data source	Events always write `source: "flutter"`
Data upload	`POST /api/v2/rum`

Packages and capabilities

Package	pub name	Description
RUM / Core / Crash	`flashcat_flutter_plugin`	Initialization, configuration, RUM (view / action / resource / error / session), and native crash collection
HTTP tracking	`flashcat_tracking_http_client`	Automatically records `dart:io` / `http` requests as resources and injects trace headers
WebView tracking	`flashcat_webview_tracking`	Correlates RUM data inside WebViews

Dart class names begin with Datadog*, and the site enum is FlashcatSite. Use the default .cn site for customer-facing production environments; configure the full customEndpoint for on-premises deployments. The DatadogSdk, DatadogConfiguration, DatadogRumConfiguration, DatadogNavigationObserver, and other classes in the documentation examples are the actual exported class names.

Supported automatic collection

Capability	Support	Description
Automatic views	Supported	Requires a `DatadogNavigationObserver` on `MaterialApp`
Automatic actions	Supported	Requires wrapping the subtree with `RumUserActionDetector`; `trackFrustrations` is enabled by default
Automatic resources	Supported (requires companion package)	Through `enableHttpTracking()` from `flashcat_tracking_http_client`
Unhandled exceptions	Supported	When using `DatadogSdk.runApp`, automatically takes over `FlutterError.onError` / `PlatformDispatcher.onError`
Native crashes	Supported	Requires `nativeCrashReportEnabled: true`
Distributed tracing	Supported	Injects W3C `traceparent` for hosts that match `firstPartyHosts`
Native mobile performance metrics	Supported	Collects app start (TTID), refresh rate, and memory by default
Hang detection	Supported	Android supports ANRs; iOS supports App Hangs after you set `appHangThreshold`

Current limits

Limit	Description
Platform scope	iOS / Android only; Flutter Web and Desktop are not supported
Logs	Log reporting is not supported (`DatadogLoggingConfiguration` is a no-op)
Session Replay	Not supported
dio / gql / grpc	The corresponding interceptor packages are not supported
Flutter rendering timings	`reportFlutterPerformance` is disabled by default; it controls only Flutter build / raster timings and does not affect the native mobile performance metrics collected by default

Symbolication compatibility

Flutter crash stacks can contain both Dart and native frames. Dart frames symbolicate on Android; iOS Dart frames are not supported yet. For the files to upload and the CLI command, see Flutter SDK advanced configuration.

Quick Start

Analytics

SDK Integration

Performance

Error Tracking

Explorer

Session Replay

Best Practices

Others

Support scope

Packages and capabilities

Supported automatic collection

Current limits

Symbolication compatibility

​Support scope

​Packages and capabilities

​Supported automatic collection

​Current limits

​Symbolication compatibility

Support scope

Packages and capabilities

Supported automatic collection

Current limits

Symbolication compatibility