sentry_dart_plugin 3.5.0
sentry_dart_plugin: ^3.5.0 copied to clipboard
Uploads debug symbols to Sentry for server-side symbolication.
Changelog #
3.5.0 #
Features #
- Add finalize_release option to skip finalizing the release by @landenai with @sentry-junior in #420
Internal Changes #
- (deps) Pin lints bound and release-comment action SHA by @buenaflor and @cursoragent in #415
- (release) Bump craft to 3.9.0 and update config by @BYK with @sentry-junior in #419
- Remove disabled changelog-preview workflow by @oioki and @claude in #416
- Add AI Use section to CONTRIBUTING.md by @christophaigner with @sentry-junior in #413
- Pin GitHub Actions to full-length commit SHAs by @joshuarli in #385
- Remove Danger workflow and add changelog policy by @buenaflor, @codex and @cursoragent in #405
3.4.0 #
3.3.0 #
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)