Debug Symbols

Learn about uploading debug symbols to enable symbolication of stack traces in your Flutter applications.

Debug symbols are essential for understanding stack traces in your Flutter application when errors occur. Without debug symbols, stack traces from minified or obfuscated code can be difficult or impossible to interpret.

Debug symbols provide the necessary information to convert program addresses back to function names, source file names, and line numbers. When you build a Flutter application, especially with obfuscation or optimization enabled, this information is typically removed from the main application bundle to reduce size.

With default settings, complete stack traces are available in your Flutter errors out of the box, unless you use split-debug-info and obfuscate flags. In these cases, you must upload the debug information files generated by the build, so Sentry can show proper stack traces.

Sentry offers several methods to upload debug symbols for Flutter applications:

  1. Sentry Dart Plugin (Recommended) - The easiest and most reliable way to upload debug symbols for Flutter applications. It automatically processes, filters, and uploads the correct symbol files for iOS, Android, and Web - significantly reducing the chances of misconfiguration.

  2. Manual Upload Options - Because this method is more complex, requires additional manual steps, and is not currently documented, we do not recommend using it unless absolutely necessary.

Previous
Manual Setup
Next
Sentry Dart Plugin
Was this helpful?
Help improve this content
Our documentation is open source and available on GitHub. Your contributions are welcome, whether fixing a typo (drat!) or suggesting an update ("yeah, this would be better").