NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
pub.dev, #283 most downloaded on pub.dev
A crash reporting library for Dart that sends crash reports to Sentry.io. This library supports Dart VM and Web. For Flutter consider sentry_flutter instead.
Latest stable
10.6.0
Last release 2 days ago
20 Nov 2026
Ships on a steady schedule
a new release about every 2 weeks
Nearly every release is documented
notes for 60 of the last 60 stable releases
1 version withdrawn
withdrawn after publishing
9 years old
271 releases · first in 2017
Drag across the ruler to compare, or tap a release to open it.
False replay config restarts because of ScreenshotWidgetStatus equality issues
ScreenshotWidgetStatus equality issues (#3114)Debug meta not loaded for split debug info only builds
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Report Flutter framework feature flags
flutter:*LoggingIntegration support for SentryLog (#3050)enableNewTraceOnNavigation flag to SentryNavigatorObserver (#3096)
truefalse, e.g.:SentryNavigatorObserver(enableNewTraceOnNavigation: false)
Span ids not re-generating for headers created from scope
ScreenshotIntegration not being added for web (#3055)PropagationContext not being set when Scope is cloned resulting in different trace ids when using withScope (#3069)SPM should use exact instead of from when defining the sentry-cocoa package
exact instead of from when defining the sentry-cocoa package (#3065)SentryScreenshotWidget (#3046)SentryFlutterPlugin (#3036, #3039)isTerminating on captureReplay for Android (#3037)
Respect ancestor text direction in SentryScreenshotWidget
SentryScreenshotWidget (#3046)Add additional crashpad path candidate
Upgrade Kotlin languageVersion to 1.8
languageVersion to 1.8 (#3032)
2.2.0 which requires a languageVersion of 1.8 or higher1.8 or higherSentryFeedbackWidget constructor to SentryFlutterOptions:// configure your feedback widget
options.feedback.showBranding = false;
Add os and device attributes to Flutter logs
Flutter Web: add debug ids to events
3.0.0 or higher// Prerequisite: `SentryNavigatorObserver` is set up and routes you navigate to have unique names, e.g configured via `RouteSettings`
// Info: Stateless widgets will report TTFD automatically when wrapped with `SentryDisplayWidget` - no need to call `reportFullyDisplayed`.
// Method 1: wrap your widget that you navigate to in `SentryDisplayWidget`
SentryDisplayWidget(child: YourWidget())
// Then report TTFD after long running work (File I/O, Network) within your widget.
@override
void initState() {
super.initState();
// Do some long running work...
Future.delayed(const Duration(seconds: 3), () {
if (mounted) {
SentryDisplayWidget.of(context).reportFullyDisplayed();
}
});
}
// Method 2: use the API directly to report TTFD - this does not require wrapping your widget with `SentryDisplayWidget`:
@override
void initState() {
super.initState();
// Get a reference to the current display before doing work.
final currentDisplay = SentryFlutter.currentDisplay();
// Do some long running work...
Future.delayed(const Duration(seconds: 3), () {
currentDisplay?.reportFullyDisplayed();
});
}
message parameter to captureException() (#2882)SentryOptions.includeModuleInStackTrace = true to enable this. This may change grouping of exceptions.Version 9.0.0 marks a major release of the Sentry Dart/Flutter SDKs containing breaking changes.
Version 9.0.0 marks a major release of the Sentry Dart/Flutter SDKs containing breaking changes.
The goal of this release is the following:
3.5.0 and 3.24.0 respectivelyPlease carefully read through the migration guide in the Sentry docs on how to upgrade from version 8 to version 9
v3.5.0 and Flutter v3.24.0 (#2643)LoadImagesListIntegration to LoadNativeDebugImagesIntegration (#2833)crashpad by default and breakpad for Windows ARM64 (#2791)
SENTRY_NATIVE_BACKEND environment variable will override the defaults.attachScreenshotOnlyWhenResumed (#2664)beforeScreenshot (#2662)beforeCaptureScreenshotenableTracing (#2695)options.autoAppStart and setAppStartEnd (#2680)2.24.0 and use QueryInterceptor instead of QueryExecutor (#2679)BeforeSendTransactionCallback now has a Hint parameterdart:html usage in favour of package:web (#2710)Hint object, which can be read in beforeSend/beforeSendTransaction callbacks via hint.response.dio integration is supported.anrEnabled to true by default (#2878)const constructors anymore.copyWith and clone methods of SDK classes were deprecated.// old
options.beforeSend = (event, hint) {
event = event.copyWith(release: 'my-release');
return event;
}
// new
options.beforeSend = (event, hint) {
event.release = 'my-release';
return event;
}
SentryLogger has been renamed to SdkLogCallback and can be accessed through options.log now.Sentry.logger:// Enable in `SentryOptions`:
options.enableLogs = true;
// Use `Sentry.logger`
Sentry.logger.info("This is a info log.");
Sentry.logger.warn("This is a warning log with attributes.", attributes: {
'string-attribute': SentryLogAttribute.string('string'),
'int-attribute': SentryLogAttribute.int(1),
'double-attribute': SentryLogAttribute.double(1.0),
'bool-attribute': SentryLogAttribute.bool(true),
});
// Manually track a feature flag
Sentry.addFeatureFlag('my-feature', true);
// or use the Sentry Firebase Remote Config Integration (sentry_firebase_remote_config package is required)
// Add the integration to automatically track feature flags from firebase remote config.
await SentryFlutter.init(
(options) {
options.dsn = 'https://example@sentry.io/add-your-dsn-here';
options.addIntegration(
SentryFirebaseRemoteConfigIntegration(
firebaseRemoteConfig: yourFirebaseRemoteConfig,
),
);
},
);
SentryNavigatorObserver - each navigation event starts a new trace.SentryNavigatorObserver on non-web platforms - a new trace is started from app
lifecycle hooks.SentryNavigatorObserver - the same trace ID is reused until the page is
refreshed or closed.SentryNavigatorObserver;warning by default when debug = true (#2836)SentryLevel.errorSentryLevel.warningoptions.groupException = truefeedback client report for dropped feedback eventsfeedback client report for errors when using HttpTransportErrors caught by OnErrorIntegration should be unhandled by default
The copyWith and clone methods of SDK classes were deprecated.
SentryNavigatorObserver - each navigation event starts a new trace.SentryNavigatorObserver on non-web platforms - a new trace is started from app
lifecycle hooks.SentryNavigatorObserver - the same trace ID is reused until the page is
refreshed or closed.FeatureFlagIntegration (#2825)// Manually track a feature flag
Sentry.addFeatureFlag('my-feature', true);
// Add the integration to automatically track feature flags from firebase remote config.
await SentryFlutter.init(
(options) {
options.dsn = 'https://example@sentry.io/add-your-dsn-here';
options.addIntegration(
SentryFirebaseRemoteConfigIntegration(
firebaseRemoteConfig: yourFirebaseRemoteConfig,
),
);
},
);
const constructors anymore.copyWith and clone methods of SDK classes were deprecated.warning by default when debug = true (#2836)SentryLevel.errorSentryLevel.warninggroupExceptions=trueanrEnabled enabled per default (#2878)LoadImagesListIntegration to LoadNativeDebugImagesIntegration (#2833)other from SentryRequest (#2879)Add support for Flutter Web release health
SentryNavigatorObserver;crashpad by default and breakpad for Windows ARM64 (#2791)
SENTRY_NATIVE_BACKEND environment variable will override the defaults.flutter_context (#2751)Remove deprecated beforeScreenshot
SentryDisplayWidget and manual TTID implementation (#2668)attachScreenshotOnlyWhenResumed (#2664)beforeScreenshot (#2662)enableTracing (#2695)options.autoAppStart and setAppStartEnd (#2680)2.24.0 and use QueryInterceptor instead of QueryExecutor (#2679)BeforeSendTransactionCallback now has a Hint parameterdart:html usage in favour of package:web (#2710)Hint object, which can be read in beforeSend/beforeSendTransaction callbacks via hint.response.dio integration is supported.### Enhancements - Replay: Mask RichText Widgets
Sentry Structured Logs (#2919) ``dart // Enable in SentryOptions`: options.enableLogs = true;
// Enable in `SentryOptions`:
options.enableLogs = true;
// Use `Sentry.logger`
Sentry.logger.info("This is a info log.");
Sentry.logger.warn("This is a warning log with attributes.", attributes: {
'attribute1': SentryLogAttribute.string('string'),
'attribute2': SentryLogAttribute.int(1),
'attribute3': SentryLogAttribute.double(1.0),
'attribute4': SentryLogAttribute.bool(true),
});
feedback client report for dropped feedback eventsfeedback client report for errors when using HttpTransportSentryLogger has been renamed to SdkLogCallback and can be accessed through options.log now.Sentry.logger:// Enable in `SentryOptions`:
options.enableLogs = true;
// Use `Sentry.logger`
Sentry.logger.info("This is a info log.");
Sentry.logger.warn("This is a warning log with attributes.", attributes: {
'string-attribute': SentryLogAttribute.string('string'),
'int-attribute': SentryLogAttribute.int(1),
'double-attribute': SentryLogAttribute.double(1.0),
'bool-attribute': SentryLogAttribute.bool(true),
});
Add hasSize guard when using a renderObject in SentryUserInteractionWidget
hasSize guard when using a renderObject in SentryUserInteractionWidget (#2946)### Fixes - Fix feature flag model keys
9.0.0 is now a release candidate.
9.0.0 is now a release candidate.
Improve performance of frames tracking
Improve platform memory collection on windows/linux
Deprecate Drift SentryQueryExecutor
This release fixes an issue where Cold starts can be incorrectly reported as Warm starts on Android.
SentryUser is now guarded by sendDefaultPii (#2726)
options.sendDefaultPii = true or manually set the IP address of the SentryUser to {{auto}}sendDefaultPii (#2741)
options.sendDefaultPii = true if you want to have the device name reportedloadDebugImagesForAddresses API for Android (#2706)
loadDebugImagesForAddresses are empty, the SDK loads all debug images as fallbackScreenshotIntegration, WidgetsBindingIntegration and SentryWidget in multi-view apps #2366 (#2366)captureFailedRequests param to FailedRequestInterceptor (#2744)SentryWidgetsFlutterBinding in warning message in FramesTrackingIntegration (#2704)SentryQueryExecutor (#2715)
SentryQueryInterceptor in the next major v9// Example usage in Sentry Flutter v9
final executor = NativeDatabase.memory().interceptWith(
SentryQueryInterceptor(databaseName: 'your_db_name'),
);
final db = AppDatabase(executor);
autoAppStart and setAppStartEnd (#2681)Deprecate Drift SentryQueryExecutor
SentryUser is now guarded by sendDefaultPii (#2726)
options.sendDefaultPii = true or manually set the IP address of the SentryUser to {{auto}}sendDefaultPii (#2741)
options.sendDefaultPii = true if you want to have the device name reportedScreenshotIntegration, WidgetsBindingIntegration and SentryWidget in multi-view apps #2366 (#2366)loadDebugImagesForAddresses API for Android (#2706)
loadDebugImagesForAddresses are empty, the SDK loads all debug images as fallbackSentryWidgetsFlutterBinding in warning message in FramesTrackingIntegration (#2704)SentryQueryExecutor (#2715)
SentryQueryInterceptor in the next major v9// Example usage in Sentry Flutter v9
final executor = NativeDatabase.memory().interceptWith(
SentryQueryInterceptor(databaseName: 'your_db_name'),
);
final db = AppDatabase(executor);
autoAppStart and setAppStartEnd (#2681)This release fixes an issue where Cold starts can be incorrectly reported as Warm starts on Android.
> This release contains an issue where Cold starts can be incorrectly reported as Warm starts on Android. We recommend staying on version 8.12.0 or up
[!WARNING] This release contains an issue where Cold starts can be incorrectly reported as Warm starts on Android. We recommend staying on version
8.12.0or updating to8.13.3if you use this feature on Android. See issue #2769 for more details.
build_web_compiler error (#2736)
if (dart.library.html) instead of if (dart.html) for imports> This release contains an issue where Cold starts can be incorrectly reported as Warm starts on Android. We recommend staying on version 8.12.0 or up
[!WARNING] This release contains an issue where Cold starts can be incorrectly reported as Warm starts on Android. We recommend staying on version
8.12.0or updating to8.13.3if you use this feature on Android. See issue #2769 for more details.
navigation breadcrumb is missing to route info (#2720)> This release contains an issue where Cold starts can be incorrectly reported as Warm starts on Android. We recommend staying on version 8.12.0 or up
[!WARNING] This release contains an issue where Cold starts can be incorrectly reported as Warm starts on Android. We recommend staying on version
8.12.0or updating to8.13.3if you use this feature on Android. See issue #2769 for more details.
beforeCapture for View Hierarchy (#2523)
options.enableSentryJs = trueoptions.experimental.replay.quality) (#2582)options.debug when in debug mode (#2597)SentryAssetBundle (#2577)sentry_link to Sentry. You can view the changelog for the previous versions here (#2338)
Enable options.debug when in debug mode
Add SentryReplayQuality setting (options.experimental.replay.quality)
The Metrics product never reached maturity from beta and has officially ended in October 7th, 2024
beforeCapture for View Hierarchy (#2523)
options.enableSentryJs = trueMissing replay gestures on Android
SentryTracer type in TTFD tracker (#2508)Replay: device orientation change support & improve video size fit on Android (#2462)
Support custom Sentry.runZoneGuarded zone creation (#2088)
Sentry.runZonedGuarded creates a zone and also captures exceptions & breadcrumbs automatically.Sentry.runZonedGuarded(() {
WidgetsBinding.ensureInitialized();
// Errors before init will not be handled by Sentry
SentryFlutter.init(
(options) {
...
},
appRunner: () => runApp(MyApp()),
);
}, (error, stackTrace) {
// Automatically sends errors to Sentry, no need to do any
// captureException calls on your part.
// On top of that, you can do your own custom stuff in this callback.
});
Warning (in a debug build) if a potentially sensitive widget is not masked or unmasked explicitly (#2375)
Replay: ensure visual update before capturing screenshots (#2527)
Missing replay gestures on Android
SentryTracer type in TTFD tracker (#2508)Replay: device orientation change support & improve video size fit on Android
Sentry.runZoneGuarded zone creation (#2088)
Sentry.runZonedGuarded creates a zone and also captures exceptions & breadcrumbs automatically.Sentry.runZonedGuarded(() {
WidgetsBinding.ensureInitialized();
// Errors before init will not be handled by Sentry
SentryFlutter.init(
(options) {
...
},
appRunner: () => runApp(MyApp()),
);
} (error, stackTrace) {
// Automatically sends errors to Sentry, no need to do any
// captureException calls on your part.
// On top of that, you can do your own custom stuff in this callback.
});
Windows & Linux native crash handlers: add SENTRY_NATIVE_BACKEND env var with default setting of none. (#2522) Native crash reporting support with sen
Windows & Linux native crash handlers: add SENTRY_NATIVE_BACKEND env var with default setting of none. (#2522)
Native crash reporting support with sentry-native's crashpad was added in v8.11.0 and has caused build-time issues
for some users, because it required newer build tools (newer versions of MSVC/Clang/GCC) than base Flutter SDK.
This broke the ability to build the app for some users compiling Windows and Linux apps with older toolchains.
To avoid this issue, we're disabling the native crash handling by default for Linux and Windows for now.
You can enable it manually by setting the SENTRY_NATIVE_BACKEND=crashpad environment variable before running flutter build.
You can read more about available backends that fit your use-case in sentry-native docs.
We plan to change the default back to crashpad in the next major SDK release.
Check for type before casting in TTID
Replace deprecated BeforeScreenshotCallback with new BeforeCaptureCallback.
⚠️ We recommend skipping this version due to a possibility in the UI thread hanging on app start.
Android 15: Add support for 16KB page sizes (#3620)
Support for screenshot PII content masking (#2361)
By default, masking is enabled for SessionReplay. To also enable it for screenshots captured with events, you can specify options.experimental.privacy:
await SentryFlutter.init(
(options) {
...
// the defaults are:
options.experimental.privacy.maskAllText = true;
options.experimental.privacy.maskAllImages = true;
options.experimental.privacy.maskAssetImages = false;
// you cal also set up custom masking, for example:
options.experimental.privacy.mask<WebView>();
},
appRunner: () => runApp(MyApp()),
);
Actually, just accessing this field will cause it to be initialized with the default settings to mask all text and images:
await SentryFlutter.init(
(options) {
...
// this has a side-effect of creating the default privacy configuration, thus enabling Screenshot masking:
options.experimental.privacy;
},
appRunner: () => runApp(MyApp()),
);
Linux native error & obfuscation support (#2431)
Improve Device context on plain Dart and Flutter desktop apps (#2441)
Add debounce to capturing screenshots (#2368)
Per default, screenshots are debounced for 2 seconds.
If you need more granular screenshots, you can opt out of debouncing:
await SentryFlutter.init((options) {
options.beforeCaptureScreenshot = (event, hint, debounce) {
if (debounce) {
return true; // Capture screenshot even if the SDK wants to debounce it.
} else {
// check event and hint
...
}
};
});
Replace deprecated BeforeScreenshotCallback with new BeforeCaptureCallback.
Improve app start measurements by using addTimingsCallback instead of addPostFrameCallback to determine app start end (#2405)
Improve frame tracking accuracy (#2372)
Introduces SentryWidgetsFlutterBinding that tracks a frame starting from handleBeginFrame and ending in handleDrawFrame, this is approximately the buildDuration time
By default, SentryFlutter.init() automatically initializes SentryWidgetsFlutterBinding through the WidgetsFlutterBindingIntegration
If you need to initialize the binding before SentryFlutter.init, use SentryWidgetsFlutterBinding.ensureInitialized instead of WidgetsFlutterBinding.ensureInitialized:
void main() async {
// Replace WidgetsFlutterBinding.ensureInitialized()
SentryWidgetsFlutterBinding.ensureInitialized();
await SentryFlutter.init(...);
runApp(MyApp());
}
⚠️ Frame tracking will be disabled if a different binding is used
sentry frames if SDK falls back to current stack trace (#2351)
captureException, or captureMessage):
StackTrace.currenthandleBeginFrame and handleDrawFrame (#2446)1.4 to 1.6 (#2456){{auto}}) to transactions (#2395)
Replace deprecated BeforeScreenshotCallback with new BeforeCaptureCallback.
options.experimental.privacy:await SentryFlutter.init(
(options) {
...
// the defaults are:
options.experimental.privacy.maskAllText = true;
options.experimental.privacy.maskAllImages = true;
options.experimental.privacy.maskAssetImages = false;
// you cal also set up custom masking, for example:
options.experimental.privacy.mask<WebView>();
},
appRunner: () => runApp(MyApp()),
);
Actually, just accessing this field will cause it to be initialized with the default settings to mask all text and images:await SentryFlutter.init(
(options) {
...
// this has a side-effect of creating the default privacy configuration, thus enabling Screenshot masking:
options.experimental.privacy;
},
appRunner: () => runApp(MyApp()),
);
await SentryFlutter.init((options) {
options.beforeCaptureScreenshot = (event, hint, debounce) {
if (debounce) {
return true; // Capture screenshot even if the SDK wants to debounce it.
} else {
// check event and hint
...
}
};
});
BeforeScreenshotCallback with new BeforeCaptureCallback.handleBeginFrame and handleDrawFrame (#2446)1.4 to 1.6 (#2456)Windows native error & obfuscation support (#2286, #2426)
addTimingsCallback instead of addPostFrameCallback to determine app start end (#2405)
SentryWidgetsFlutterBinding that tracks a frame starting from handleBeginFrame and ending in handleDrawFrame, this is approximately the buildDuration timeSentryFlutter.init() automatically initializes SentryWidgetsFlutterBinding through the WidgetsFlutterBindingIntegrationSentryFlutter.init, use SentryWidgetsFlutterBinding.ensureInitialized instead of WidgetsFlutterBinding.ensureInitialized:void main() async {
// Replace WidgetsFlutterBinding.ensureInitialized()
SentryWidgetsFlutterBinding.ensureInitialized();
await SentryFlutter.init(...);
runApp(MyApp());
}
sentry frames if SDK falls back to current stack trace (#2351)
captureException, or captureMessage):
StackTrace.current{{auto}}) to transactions (#2395)
Android build error when compiling
Deprecated Sentry.captureUserFeedback, use captureFeedback instead.
Emit transaction.data inside contexts.trace.data (#2284)
Blocking app starts span if "appLaunchedInForeground" is false. (Android only) (#2291)
Replay: user-configurable masking (redaction) for widget classes and specific widget instances. (#2324) Some examples of the configuration:
await SentryFlutter.init(
(options) {
...
options.experimental.replay.mask<IconButton>();
options.experimental.replay.unmask<Image>();
options.experimental.replay.maskCallback<Text>(
(Element element, Text widget) =>
(widget.data?.contains('secret') ?? false)
? SentryMaskingDecision.mask
: SentryMaskingDecision.continueProcessing);
},
appRunner: () => runApp(MyApp()),
);
Also, you can wrap any of your widgets with SentryMask() or SentryUnmask() widgets to mask/unmask them, respectively. For example:
SentryUnmask(Text('Not secret at all'));
Support captureFeedback (#2230)
Sentry.captureUserFeedback, use captureFeedback instead.Hub.captureUserFeedback, use captureFeedback instead.SentryClient.captureUserFeedback, use captureFeedback instead.SentryUserFeedback, use SentryFeedback instead.Add SentryFeedbackWidget (#2240)
Navigator.push(
context,
MaterialPageRoute(
builder: (context) => SentryFeedbackWidget(associatedEventId: id),
fullscreenDialog: true,
),
);
Add screenshot to SentryFeedbackWidget (#2369)
SentryFlutter.captureScreenshot to create a screenshot attachmentSentryFeedbackWidget with this attachment to add it to the user feedbackfinal id = await Sentry.captureMessage('UserFeedback');
final screenshot = await SentryFlutter.captureScreenshot();
Navigator.push(
context,
MaterialPageRoute(
builder: (context) => SentryFeedbackWidget(
associatedEventId: id,
screenshot: screenshot,
),
fullscreenDialog: true,
),
);
SentryOptions.maxQueueSize. Default is 30.onErrorSampleRate is specified (#2306)fetchNativeAppStart should return null (#2340)Temporarily disable Windows native error & obfuscation support
Deprecated Sentry.captureUserFeedback, use captureFeedback instead.
Emit transaction.data inside contexts.trace.data (#2284)
Block reporting of app start metrics if "appLaunchedInForeground" is false. (Android only) (#2291)
Windows native error & obfuscation support (#2286)
Replay: user-configurable masking (redaction) for widget classes and specific widget instances. (#2324) Some examples of the configuration:
await SentryFlutter.init(
(options) {
...
options.experimental.replay.mask<IconButton>();
options.experimental.replay.unmask<Image>();
options.experimental.replay.maskCallback<Text>(
(Element element, Text widget) =>
(widget.data?.contains('secret') ?? false)
? SentryMaskingDecision.mask
: SentryMaskingDecision.continueProcessing);
},
appRunner: () => runApp(MyApp()),
);
Also, you can wrap any of your widgets with SentryMask() or SentryUnmask() widgets to mask/unmask them, respectively. For example:
SentryUnmask(Text('Not secret at all'));
Support captureFeedback (#2230)
Sentry.captureUserFeedback, use captureFeedback instead.Hub.captureUserFeedback, use captureFeedback instead.SentryClient.captureUserFeedback, use captureFeedback instead.SentryUserFeedback, use SentryFeedback instead.Add SentryFeedbackWidget (#2240)
Navigator.push(
context,
MaterialPageRoute(
builder: (context) => SentryFeedbackWidget(associatedEventId: id),
fullscreenDialog: true,
),
);
onErrorSampleRate is specified (#2306)fetchNativeAppStart should return null (#2340)SentryFlutter.reportFullyDisplayed() twice (#2339)Session replay Alpha for Android and iOS (#2208, #2269, #2236, #2275, #2270). To try out replay, you can set following options, now available in Beta
Session replay Alpha for Android and iOS (#2208, #2269, #2236, #2275, #2270). To try out replay, you can set following options, now available in Beta to organizations Free, Team and Business (except Enterprise, talk to you sales person)):
await SentryFlutter.init(
(options) {
...
options.experimental.replay.sessionSampleRate = 1.0;
options.experimental.replay.onErrorSampleRate = 1.0;
},
appRunner: () => runApp(MyApp()),
);
Support allowUrls and denyUrls for Flutter Web (#2227)
await SentryFlutter.init(
(options) {
...
options.allowUrls = ["^https://sentry.com.*\$", "my-custom-domain"];
options.denyUrls = ["^.*ends-with-this\$", "denied-url"];
},
appRunner: () => runApp(MyApp()),
);
Collect touch breadcrumbs for all buttons, not just those with key specified. (#2242)
Add enableDartSymbolication option to Sentry.init() for Flutter iOS, macOS and Android (#2256)
true by default but automatically set to false when using SentryFlutter.init() because the SentryFlutter fetches debug images from the native SDK integrations.hasSize is true (#2263)Session replay Alpha for Android and iOS (#2208, #2269, #2236, #2275, #2270). To try out replay, you can set following options (access is limited to early access orgs on Sentry. If you're interested, sign up for the waitlist):
await SentryFlutter.init(
(options) {
...
options.experimental.replay.sessionSampleRate = 1.0;
options.experimental.replay.onErrorSampleRate = 1.0;
},
appRunner: () => runApp(MyApp()),
);
Support allowUrls and denyUrls for Flutter Web (#2227)
await SentryFlutter.init(
(options) {
...
options.allowUrls = ["^https://sentry.com.*\$", "my-custom-domain"];
options.denyUrls = ["^.*ends-with-this\$", "denied-url"];
},
appRunner: () => runApp(MyApp()),
);
Collect touch breadcrumbs for all buttons, not just those with key specified. (#2242)
Add enableDartSymbolication option to Sentry.init() for Flutter iOS, macOS and Android (#2256)
true by default but automatically set to false when using SentryFlutter.init() because the SentryFlutter fetches debug images from the native SDK integrations.hasSize is true (#2263)Add SentryFlutter.nativeCrash() using MethodChannels for Android and iOS
SentryFlutter.nativeCrash() using MethodChannels for Android and iOS (#2239)
ignoreRoutes parameter to SentryNavigatorObserver. (#2218)
SentryNavigatorObserver(ignoreRoutes: ["/ignoreThisRoute"]),
Android replay touch tracking support
ignoreRoutes parameter to SentryNavigatorObserver. (#2218)
SentryNavigatorObserver(ignoreRoutes: ["/ignoreThisRoute"]),
If you keep using 8.7.0 in a Flutter project, your build will fail because sentry-cocoa 8.33.0 has been deprecated.
[!WARNING]
Due to a bug (https://github.com/getsentry/sentry-cocoa/issues/4280) insentry-cocoa 8.33.0used in this release, it is required to upgrade to 8.8.0 or newer for Flutter projects. If you keep using8.7.0in a Flutter project, your build will fail becausesentry-cocoa 8.33.0has been deprecated.
ignoreTransactions and ignoreErrors to options (#2207)await SentryFlutter.init(
(options) {
options.dsn = 'https://examplePublicKey@o0.ingest.sentry.io/0';
options.ignoreErrors = ["my-error", "^error-.*\$"];
options.ignoreTransactions = ["my-transaction", "^transaction-.*\$"];
...
},
appRunner: () => runApp(MyApp()),
);
SentryProxy object and set it on SentryFlutter.initimport 'package:flutter/widgets.dart';
import 'package:sentry_flutter/sentry_flutter.dart';
Future<void> main() async {
await SentryFlutter.init(
(options) {
options.dsn = 'https://example@sentry.io/add-your-dsn-here';
options.proxy = SentryProxy(
type: SenryProxyType.http,
host: 'localhost',
port: 8080,
);
},
// Init your App.
appRunner: () => runApp(MyApp()),
);
}
The enableTracing option has been deprecated and will be removed in the next major version. We recommend removing it in favor of the tracesSampleRate…
If you want to try Session Replay Android Alpha, see our alpha release: https://github.com/getsentry/sentry-dart/releases/tag/8.6.0-alpha.2
GA to FlutterError or minified:nE to FlutterErrorenableExceptionTypeIdentification to false in your Sentry options// How to add your own custom exception identifier
class MyCustomExceptionIdentifier implements ExceptionIdentifier {
@override
String? identifyType(Exception exception) {
if (exception is MyCustomException) {
return 'MyCustomException';
}
if (exception is MyOtherCustomException) {
return 'MyOtherCustomException';
}
return null;
}
}
SentryFlutter.init((options) =>
options..prependExceptionTypeIdentifier(MyCustomExceptionIdentifier()));
enableTracing (#2199)
enableTracing option has been deprecated and will be removed in the next major version. We recommend removing it
in favor of the tracesSampleRate and tracesSampler options. If you want to enable performance monitoring, please set
the tracesSampleRate to a sample rate of your choice, or provide a sampling function as tracesSampler option
instead. If you want to disable performance monitoring, remove the tracesSampler and tracesSampleRate options.To try out replay, you can set following options:
Android Session Replay Alpha (#2032)
To try out replay, you can set following options:
await SentryFlutter.init(
(options) {
...
options.experimental.replay.sessionSampleRate = 1.0;
options.experimental.replay.errorSampleRate = 1.0;
},
appRunner: () => runApp(MyApp()),
);
Access is limited to early access orgs on Sentry. If you're interested, sign up for the waitlist
Nothing published for this version
Add dart platform to sentry frames
ignoredExceptionsForType (#2150)
SentryOptions.addExceptionFilterForType(Type exceptionType)User segment is now deprecated and will be removed in version 9.0.0. Use a custom tag or context instead.
SentryFlutter.pauseAppHangTracking() and SentryFlutter.resumeAppHangTracking()reportViewHierarchyIdentifiers to enable or disable the optionautoAppStarts is false and setAppStartEnd has not been called, the app start event processor will now return early instead of waiting for getAppStartInfo to finishPlatform.version (#2156)User segment is now deprecated and will be removed in version 9.0.0. Use a custom tag or context instead.
SentryFlutter.pauseAppHangTracking() and SentryFlutter.resumeAppHangTracking()This is not a breaking change since we are using api internally that is only valid from that version.
Include sentry frames in stacktraces to enable SDK crash detection
autoAppStart is false (#2028)SentryNavigatorObserver is present (#2017)PlatformException title parsing (#2033)Set snapshot to true if stacktrace is not provided
true if stacktrace is not provided (#2000)
StackTrace.current and the snapshot will be set to true - this may change the grouping behaviorsnapshot = true means it's a synthetic exception, reflecting the current state of the thread rather than the stack trace of a real exceptionThis release contains breaking changes, please read the changelog carefully.
This release contains breaking changes, please read the changelog carefully.
Changes from the latest v7 release are included in this major release
handled: false (#1535)
hint non-nullable in BeforeSendCallback, BeforeBreadcrumbCall and EventProcessor (#1574)
BeforeSendCallbackThis will affect your release health data, and is therefore considered a breaking change.
handled: false (#1535)
hint non-nullable in BeforeSendCallback, BeforeBreadcrumbCall and EventProcessor (#1574)
BeforeSendCallbackThis release is replaced by 8.0.0-beta.2
This release is replaced by 8.0.0-beta.2
Event processor blocking transactions from being sent if autoAppStart is false
autoAppStart is false (#2045)One column per quarter.