Sentry Dart Plugin

A Dart Build Plugin that uploads debug symbols for Android, iOS/macOS and source maps for Web to Sentry via sentry-cli.

For doing it manually, please follow our docs.

:clipboard: Install

In your pubspec.yaml, add sentry_dart_plugin as a new dev dependency.

dev_dependencies:
  sentry_dart_plugin: ^1.0.0-alpha.2

Build App

The flutter build apk, flutter build ios (or macos) or flutter build web is required before executing the sentry_dart_plugin plugin, because the build spits out the debug symbols and source maps.

Run

dart run sentry_dart_plugin

Configuration (Optional)

This tool comes with default configuration, you can configure it to suit your needs.

Add sentry: configuration at the end of your pubspec.yaml file:

sentry:
  upload_native_symbols: true
  upload_source_maps: false
  include_native_sources: false
  project: ...
  org: ...
  auth_token: ...
  wait_for_processing: false
  log_level: error # possible values: trace, debug, info, warn, error
  release: ...
  web_build_path: ...
Available Configuration Fields:
Configuration NameDescriptionDefault Value And TypeRequiredAlternative Environment variable
upload_native_symbolsEnables or disables the automatic upload of debug symbolstrue (boolean)no-
upload_source_mapsEnables or disables the automatic upload of source mapsfalse (boolean)no-
include_native_sourcesDoes or doesn't include the source code of native codefalse (boolean)no-
projectProject's namee.g. sentry-flutter (string)yesSENTRY_PROJECT
orgOrganization's sluge.g. sentry-sdks (string)yesSENTRY_ORG
auth_tokenAuth Tokene.g. 64 random characteres (string)yesSENTRY_AUTH_TOKEN
wait_for_processingWait for server-side processing of uploaded filesfalse (boolean)no-
log_levelConfigures the log level for sentry-cliwarn (string)noSENTRY_LOG_LEVEL
releaseThe release version for source maps, it should match the release set by the SDKdefault: name@version from pubspec (string)no-
web_build_pathThe web build folderdefault: build/web (string)no-

Libraries

sentry_dart_plugin