sentry_dart_plugin 3.0.0

Uploads debug symbols to Sentry for server-side symbolication.

Changelog

3.0.0

Version 3.0.0 marks a major release of the Sentry Dart Plugin containing breaking changes for Flutter Web.

Breaking Changes

1. 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.
2. 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.
3. 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.

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_symbolication which you can set to true if you want to keep using the old symbolication. It is set to false by 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.1

Fixes

• Add missing prefix to source file upload (#306)

2.4.0

Enhancements

• Merge pubspec.yaml and sentry.properties values (#295)

Dependencies

• Bump CLI from v2.39.1 to v2.41.1 (#290)
  • changelog
  • diff

2.3.0

Features

• Support flavors in iOS symbol upload (#292)

Dependencies

• Bump CLI from v2.38.1 to v2.39.1 (#282)
  • changelog
  • diff

2.2.1

Fixes

• Dart source context on web missing (#285)

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 where flutter build outputs debug symbols for release builds and only uploads those.

Features

• Add urlPrefix to sentry configuration (#253)

Fixes

• Only upload .dart files with upload-sourcemaps when upload_sources is enabled (#247)
  • Enable upload_sources to opt in to Flutter web source context

Dependencies

• Bump CLI from v2.27.0 to v2.38.1 (#273)
  • changelog
  • diff

2.1.0

Features

• Add support for build files folder parameter (#235)
• Support SENTRYCLI_CDNURL env (#230)
• Add sentry_cli_version parameter (#243)

Fixes

• Revert sentry-cli to v2.27.0 (#241)

2.0.0

Breaking Changes

• Update env/config release and dist behaviour (#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_RELEASE and SENTRY_DIST environment variables take precedence over plugin config values.

Features

• Custom dist overrides 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 to release@1.0.0+2.
• Add option to provide alternative binary directory (#214)
• Support configuration arguments via --sentry-define (#198)
• Provide path to local sentry-cli (#224)

Dependencies

• Bump CLI from v2.27.0 to v2.31.0 (#219)
  • changelog
  • diff

1.7.1

Fixes

• Updated the process dependency range to >=4.2.4 <6.0.0 (#202).
  • This update resolves a version conflict issue when using the integration_test package with Flutter version 3.19.0

1.7.0

Features

• Support reading config from sentry.properties file (#191)

Dependencies

• Bump CLI from v2.21.2 to v2.27.0 (#180, #195, #196)
  • changelog
  • diff

1.6.3

Fixes

• Fixes org auth tokens with no URL not supported by bumping CLI to v2.21.2 (#169)

Dependencies

• Bump CLI from v2.20.6 to v2.21.2 (#169)
  • changelog
  • diff

1.6.2

Dependencies

• Revert process from 5.0.0 to 4.2.4 (#160)

1.6.0

Dependencies

• Bumps process from 4.2.4 to 5.0.0.
  • Release notes
  • Changelog
  • Commits
• Bump CLI from v2.19.4 to v2.20.6 (#152)
  • changelog
  • diff

1.5.0

Fixes

• Support custom dist and release has precedence over the pubspec's name (#139)

Dependencies

• Bump CLI from v2.19.1 to v2.19.4 (#133)
  • changelog
  • diff

1.4.0

Enhancements

• Replace upload-dif to debug-files upload (#127)

Dependencies

• Bump CLI from v2.17.5 to v2.19.1 (#123, #130)
  • changelog
  • diff

1.3.0

Features

• Stream sentry-cli output (#110)
• Support http >= v1, system_info2 >= v4, file >= v7 (#125)

1.2.0

Features

• Dart v3 support (#112)

Breaking Changes

• Bump Dart min to 2.17.0 (#112)

Dependencies

• Bump CLI from v2.13.0 to v2.17.5 (#86, #89, #90, #101, #103, #107, #114)
  • changelog
  • diff

1.1.0

Features

• Add configuration ignore_missing (#85)

1.0.0

Dependencies

• Bump CLI from v2.12.0 to v2.13.0 (#80)
  • changelog
  • diff

1.0.0-RC.1

Changes

• Rename configuration include_native_sources to upload_sources (#78)
• Rename configuration upload_native_symbols to upload_debug_symbols (#78)

Dependencies

• Bump CLI from v2.11.0 to v2.12.0 (#79)
  • changelog
  • diff

1.0.0-beta.5

Dependencies

• Bump CLI from v2.7.0 to v2.11.0 (#65, #67, #69, #72, #74)
  • changelog
  • diff
• Bump system_info2 to ^3.0.1 (#77)

1.0.0-beta.4

Features

• Support release commits (#62)

1.0.0-beta.3

Features

• Add support to load release variable from environment (#40)
• Download Sentry CLI on first run (#49)

Dependencies

• Bump CLI from v2.6.0 to v2.7.0 (#57)
  • changelog
  • diff

1.0.0-beta.2

Fixes

• Early exit when providing lower log level (#31)

1.0.0-beta.1

Features

• Ability to configure url for on-premise server (#17)

1.0.0-alpha.4

Fixes

• Log real exitCode, stdout and stdout if available (#13)

1.0.0-alpha.3

Dependencies

• Bump sentry-cli 1.69.1 which includes a fix for Dart debug symbols (#8)

1.0.0-alpha.2

Fixes

• Add org and project when creating releases (#2)

1.0.0-alpha.1

Features

• Sentry Dart Plugin