Repository navigation
Releases
Releases · getsentry/sentry-dart
10.5.0
Fixes
Flutter
- Parent HTTP spans to the new route after navigating away from the initial route, instead of to the app-start
root /transaction until its TTFD timeout (#4154) by @buenaflor, @codex and 2 others in #4155 pushReplacement/replaceof the current route now starts aui.loadtransaction (static) or route span (streaming), likepushby @buenaflor, @codex and 2 others in #4155- With
enableAutoTransactionsdisabled, navigating to a named route now ends the app-start display (TTID/TTFD end asdeadline_exceededin static mode), so spans from later screens no longer attach to the app start by @buenaflor, @codex and 2 others in #4155 - Use a writable native database directory on Windows when
nativeDatabasePathisn't set, so native crashes from packaged (MSIX/Microsoft Store) apps are captured. by @lucas-zimerman and @claude in #4156
Other
- (dart) Avoid mutating flags of captured events by @buenaflor and @claude in #4169
Dependencies
Deps
- chore(deps): update JavaScript SDK to v11.13.0 by @buenaflor with @github-actions in #4177
- chore(deps): update Cocoa SDK to v9.35.0 by @github-actions in #4176
Internal Changes
- (agents) Disable AI attribution in commits by @buenaflor with @sentry-junior in #4170
- (android) Upgrade Flutter example toolchain by @buenaflor in #4171
10.4.0
Fixes
- (flutter) Fetch sentry-native as a release zip on Windows by @lucas-zimerman and @claude in #4110
- (link) Set span attributes on creation by @awishere, @codex and @buenaflor in #4044
- (replay) Mask correctly during zoom page transitions by @lucas-zimerman, @claude and @buenaflor in #4130
Enhancements
- Lower the minimum Android SDK version for Flutter from API 26 to API 24, matching Flutter's default
minSdk. by @buenaflor and @lucas-zimerman with @sentry-junior in #4150
Dependencies
Deps
- chore(deps): update JavaScript SDK to v11.12.0 by @buenaflor and @codex with @github-actions in #4161
- chore(deps): update Cocoa SDK to v9.34.0 by @buenaflor and @codex with @github-actions in #4162
- chore(deps): update Android SDK to v8.64.0 by @buenaflor and @codex with @github-actions in #4163
- chore(deps): update Native SDK to v0.17.6 by @buenaflor with @github-actions in #4144
Internal Changes
- (release) Bump craft to 3.9.0 and update config by @BYK with @sentry-junior in #4140
- (warden) Enable incremental review by @Jeffreyhung with @sentry-junior in #4145
- Ask Junior to recheck native SDK bumps by @buenaflor with @sentry-junior in #4149
- Expand platform and tooling ignore rules by @philprime in #4148
- Point Sentry Conventions links to conventions.sentry.dev by @cleptric and @claude in #4146
10.3.0
Features
Flutter
- Add experimental Session Replay support for Flutter Web with widget masking. Opt in with
options.replay.enableWebReplay = truealong withreplay.sessionSampleRateorreplay.onErrorSampleRate. Requires the CanvasKit or Skwasm renderer.SentryFlutter.replaystart/stop/flush also work on web, and the Dart scope (user, tags, extras, contexts, breadcrumbs) now syncs to the JS SDK on web (#2897) by @lucas-zimerman in #4059 - Add
addUserInteractionWidgettoSentryFlutterOptionsto track taps on widgets the SDK doesn't recognize, like those frommaterial_uiandcupertino_ui. Tooltip labels now come fromRawTooltip, somaterial_uitooltips get labels too. by @dawid-niedzwiecki in #4069
Fixes
- (dart) Count streamed spans in client reports by @sentry-junior in #4097
- (flutter) Use static SwiftPM binaries by @philprime in #4118
Dependencies
Deps
- chore(deps): update Cocoa SDK to v9.32.0 by @github-actions in #4128
- chore(deps): update Native SDK to v0.17.5 by @github-actions in #4127
- chore(deps): update Android SDK to v8.62.0 by @github-actions in #4124
Internal Changes
- (flutter) Use Cocoa internal serializer by @philprime in #4100
- Use dark-mode-aware Sentry logo in READMEs by @sentry-junior in #4123
10.2.0
Features
- Report the generation of the cellular network technology in
device.connection_effective_typeon Android and iOS, for example4gor5g. On Android 11 and earlier, the app must have theREAD_PHONE_STATEpermission. by @alwx in #4066
Fixes
Flutter
- Support JNI 1.1 by @Carapacik in #4099
- Allow empty associatedEventId in SentryFeedbackForm by @lucas-zimerman in #4108
Other
- (ios) Avoid deprecated windows in refresh rate by @ananyateklu in #4111
Dependencies
Deps
- chore(deps): update Android SDK to v8.61.1 by @github-actions in #4114
- chore(deps): update Cocoa SDK to v9.31.0 by @github-actions in #4112
- chore(deps): update Native SDK to v0.17.4 by @github-actions in #4093
Internal Changes
- Pin Java 17 for Android updater by @buenaflor in #4113
10.1.0
Features
- Session Replays on iOS now include trace IDs, so they can be found by searching for a trace ID in Sentry by @antonis in #4083
Fixes
- Deobfuscate the Java frames of Dart-captured
PlatformExceptionevents on Android by attaching the ProGuard debug image, and keep existing debug images when loading native ones. by @xelarich in #4081 - (app-start) Keep builds and deduplicate TTFD by @buenaflor in #4079
- (flutter) Don't report feedback success when send fails by @lucas-zimerman in #4043
- (replay) Link errors to manual replays by @buenaflor in #4078
Dependencies
Deps
- chore(deps): update Android SDK to v8.61.0 by @github-actions in #4090
- chore(deps): update Cocoa SDK to v9.30.2 by @github-actions in #4089
- chore(deps): update Native SDK to v0.17.3 by @github-actions in #4082
Internal Changes
- Remove Collect App Metrics jobs by @buenaflor in #4091
10.0.0
Version 10.0.0 marks a major release of the Sentry Dart/Flutter SDKs containing breaking changes.
How To Upgrade
Please carefully read through the migration guide in the Sentry docs on how to upgrade from version 9 to version 10
Breaking Changes
- Default to streaming traces (
SentryTraceLifecycle.stream), sending spans as they finish. UseSentry.startSpaninstead ofSentry.startTransactionandISentrySpan.startChild, which are no-ops in streaming mode. Setoptions.traceLifecycle = SentryTraceLifecycle.staticto keep using the transaction APIs. (#4057) - Require Dart 3.12.0 or newer and Flutter 3.44.0 or newer. (#3784, 98581ac)
- Raise the minimum Android SDK version for Flutter from API 21 to API 26. Set your app's Android
minSdkto 26 or higher. (#4049) - Remove CocoaPods support. Flutter apps targeting Apple platforms must use Swift Package Manager. (#3879)
- Remove
enableLogsandenableMetrics. Logs and metrics are always enabled. The logging integration forwards Sentry logs by default; adjustminSentryLogLevelor set it toLevel.OFFto disable forwarding. (#3983) - Remove
enableStandaloneAppStartTracing. When tracing is enabled, app start is always reported as a standaloneapp.startroot on Android and iOS. (#3981) - Make native failed-request capture opt-in. (#3885)
- Run error sampling after event processors and
beforeSend. These callbacks now also run for events that are subsequently sampled out. (#3955) - Require
traceIdonSentryLog, make logger methods returnvoid, and removeSentryLogAttribute. (#3842, #3852, #3843) - Add a
Hintparameter to the before-send callbacks for logs, metrics, and spans. (#3847) - Make feature flags hub/scope-based. (#3848)
- Remove SDK profiling and deprecated performance collectors. (#3891, #3850)
- Remove deprecated
copyWithAPIs and protocol clones, and makeclone()internal. (#3877, #3845) - Remove the deprecated
SentryFeedbackWidget. (#3844) - Replace
options.logwith internal logging and makeBindingWrapperandbindingUtilsinternal. (#3932, #3940) - Align span attributes with Sentry Conventions and remove
file.asyncfrom file instrumentation. (#3805, #3841) - Use Breakpad as the default native crash backend on Windows and Linux. (#4045)
Features
- Add manual Session Replay controls on Android and iOS through
SentryFlutter.replay:start,startBuffering,pause,resume,stop, andflush. Explicitly started replays work even when both automatic sample rates are0. (#4010) - Improve startup frame spans, and remove the pre-init and Sentry initialization spans from startup traces. (#4018, 6aad048)
- Include sampled-out errors in release health, and report unhandled Flutter errors as unhandled sessions rather than crashes. (#4008, #4007)
- Mask
SensitiveContentby default in Session Replay. (#3973) - Graduate mature v10 APIs from experimental status. (#3940)
Enhancements
- Migrate the Android plugin to Flutter’s built-in Kotlin support. (#3961)
Fixes
- Isolate failures in user-provided callbacks. (#4026)
- Default event trace context status to
okwhile preserving explicit span statuses. (#4035) - Exclude later frame builds from startup timing. (8ee2d41)
- Align HTTP client error type and value. (#3934)
Dependencies
10.0.0-rc.2
Breaking Changes
- Default
traceLifecycletoSentryTraceLifecycle.stream, sending spans as they finish instead of as transactions. Errors, messages, and feedback captured inside an active streaming span now link to it. Setoptions.traceLifecycle = SentryTraceLifecycle.staticto keep the previous transaction-based behavior. (#4057)
10.0.0-rc.1
Breaking Changes
- Raise the minimum Android SDK version for Flutter from API 21 to API 26. Set your app's Android
minSdkto 26 or higher. (#4049)
Fixes
10.0.0-rc.0
Breaking Changes
- Require Dart 3.12.0 or newer and Flutter 3.44.0 or newer. (#3784)
- Remove CocoaPods support. Flutter apps targeting Apple platforms must use Swift Package Manager. (#3879)
- Remove
enableLogsandenableMetrics. Logs and metrics are always enabled. The logging integration forwards Sentry logs by default; adjustminSentryLogLevelor set it toLevel.OFFto disable forwarding. (#3983) - Remove
enableStandaloneAppStartTracing. When tracing is enabled, app start is always reported as a standaloneapp.startroot on Android and iOS. (#3981) - Make native failed-request capture opt-in. (#3885)
- Run error sampling after event processors and
beforeSend. These callbacks now also run for events that are subsequently sampled out. (#3955) - Require
traceIdonSentryLog, make logger methods returnvoid, and removeSentryLogAttribute. (#3842, #3852, #3843) - Add a
Hintparameter to the before-send callbacks for logs, metrics, and spans. (#3847) - Make feature flags hub/scope-based. (#3848)
- Remove SDK profiling and deprecated performance collectors. (#3891, #3850)
- Remove deprecated
copyWithAPIs and protocol clones, and makeclone()internal. (#3877, #3845) - Remove the deprecated
SentryFeedbackWidget. (#3844) - Replace
options.logwith internal logging and makeBindingWrapperandbindingUtilsinternal. (#3932, #3940) - Align span attributes with Sentry Conventions and remove
file.asyncfrom file instrumentation. (#3805, #3841) - Use Breakpad as the default native crash backend on Windows and Linux. (#4045)
Features
- Add manual Session Replay controls on Android and iOS through
SentryFlutter.replay:start,startBuffering,pause,resume,stop, andflush. Explicitly started replays work even when both automatic sample rates are0. (#4010) - Add app-start extension APIs and lifecycle-specific span getters, and improve startup frame spans. (#3896, #3918, #4018)
- Include sampled-out errors in release health, and report unhandled Flutter errors as unhandled sessions rather than crashes. (#4008, #4007)
- Mask
SensitiveContentby default in Session Replay. (#3973) - Record Android replay segment names and span segment-name sources. (#3897, #3904)
- Support array attributes in telemetry and attach feature flags to the hub span. (#3778, #3806)
- Graduate span streaming and other mature v10 APIs from experimental status. (#3756, #3940)
Enhancements
- Improve Android scope synchronization and replay screenshot transfer performance. (#3924)
- Support 64-bit integer values from Sentry Native. (#3760)
- Migrate the Android plugin to Flutter’s built-in Kotlin support. (#3961)
Fixes
- Isolate failures in user-provided callbacks. (#4026)
- Close background JNI workers when their owning isolate exits while preserving native reporting across cached-engine view detachment and reattachment. (#3987)
- Await in-flight replay captures during scheduler shutdown and skip new captures while the app is not resumed. (#3935)
- Prevent delayed-frame state errors and guard script completion. (#3876, #3912)
- Add the app-start screen attribute and exclude later frame builds from startup timing. (#3893, 8ee2d41)
- Align HTTP client error type and value. (#3934)
- Accept double timestamps in Android network breadcrumbs. (#3859)
- Read normalized rate-limit headers and report missing metric byte outcomes. (#3883, #3905)
Dependencies
10.0.0-beta.0
Features
- (flutter) Default desktop to Breakpad by @buenaflor in #4045
Dependencies
- (flutter) Bump JS to 11.0.0 by @buenaflor in #4032