sentry_dart_plugin 3.2.0
sentry_dart_plugin: ^3.2.0 copied to clipboard
Uploads debug symbols to Sentry for server-side symbolication.
Changelog #
3.2.0 #
Features #
- Upload Dart symbol mapping file (#347)
- Enables symbolication of Flutter issue titles for obfuscated builds.
- Supported: Android and iOS
- Not supported (yet): macOS, Linux and Windows.
- Generate the mapping file: Add
--extra-gen-snapshot-options=--save-obfuscation-map=<path>when building. Example:flutter build apk --obfuscate --split-debug-info=build/symbols --extra-gen-snapshot-options=--save-obfuscation-map=build/mapping.json - Configure the plugin: Set
dart_symbol_map_path: build/mapping.json - Important:
dart_symbol_map_pathmust point directly to the mapping file (absolute or relative path), not a directory.
3.2.0-beta.1 #
Features #
- Upload Dart symbol mapping file (#347)
- Enables symbolication of Flutter issue titles for obfuscated builds.
- Supported: Android and iOS
- Not supported (yet): macOS, Linux and Windows.
- Generate the mapping file: Add
--extra-gen-snapshot-options=--save-obfuscation-map=<path>when building. Example:flutter build apk --obfuscate --split-debug-info=build/symbols --extra-gen-snapshot-options=--save-obfuscation-map=build/mapping.json - Configure the plugin: Set
dart_symbol_map_path: build/mapping.json - Important:
dart_symbol_map_pathmust point directly to the mapping file (absolute or relative path), not a directory.
3.1.0 #
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: dart_plugin: legacy_web_symbolication: true- This switches back to the “classic” source-map symbolication method you’ve been using.
- If you cannot upgrade to Flutter SDK ≥ 9.1.0 yet, add this flag to your Sentry Dart Plugin config:
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.
2.4.0 #
2.3.0 #
2.2.0 #
Changes #
- Upload debug symbols for known release build paths and the configured
symbols_path(#277) Previously, all debug symbols recognized by Sentry CLI were uploaded (starting in the current directory by default). Now, the plugin checks the paths whereflutter buildoutputs debug symbols for release builds and only uploads those.
Features #
- Add urlPrefix to sentry configuration (#253)
Fixes #
- Only upload
.dartfiles withupload-sourcemapswhenupload_sourcesis enabled (#247)- Enable
upload_sourcesto opt in to Flutter web source context
- Enable
Dependencies #
2.1.0 #
2.0.0 #
Breaking Changes #
- Update env/config
releaseanddistbehaviour (#217)- Default release: automatically constructs the release identifier from pubspec.yaml using the format:
name@version. If a build number is included in the version, it is utilized as dist. - Custom release can be specified via an environment variable or plugin configuration. Once set, it is used as is without further modification.
- Custom dist can also be set via environment variables or plugin configuration. It replaces or adds to the build number in the default release.
- Environment variables:
SENTRY_RELEASEandSENTRY_DISTenvironment variables take precedence over plugin config values.
- Default release: automatically constructs the release identifier from pubspec.yaml using the format:
Features #
- Custom
distoverrides version build number (#216)- For instance, if the initial release version is
release@1.0.0+1, specifying a custom dist value of 2 will update the version torelease@1.0.0+2.
- For instance, if the initial release version is
- Add option to provide alternative binary directory (#214)
- Support configuration arguments via
--sentry-define(#198) - Provide path to local
sentry-cli(#224)