3.0.0
Version 3.0.0 marks a major release of the Sentry Dart Plugin containing breaking changes for Flutter Web.
Breaking Changes
- Automatic Debug-ID Injection
- What’s new: By default, the plugin now embeds Debug IDs into your generated source maps.
- Why it matters: Debug IDs make symbolication of Flutter Web stack traces far more stable and reliable.
- Minimum Flutter SDK Requirement
- The Debug-ID feature only works with Sentry Flutter SDK 9.1.0 or newer.
- If you’re on 9.0.0 (or below), you won’t get Debug IDs automatically.
- Legacy Symbolication Mode
- If you cannot upgrade to Flutter SDK ≥ 9.1.0 yet, add this flag to your Sentry Dart Plugin config:
sentry: # ... other config legacy_web_symbolication: true
- This switches back to the “classic” source-map symbolication method you’ve been using.
Features
- Support injecting debug ids for Flutter Web (#319)
- Debug id loading will be the default symbolication in v3
- We have added the new field
legacy_web_symbolicationwhich you can set totrueif you want to keep using the old symbolication. It is set tofalseby default.
Enhancements
- Improve Flutter Web stacktraces by stripping verbose source prefixes (#320)
- This is only applied if you use the debug id symbolication which is enabled by default.
- This will not work with the legacy web symbolication.