Upload debug symbols for Flutter
Contents
A minimum CLI version of 0.7.4 is required, but we recommend keeping up with the latest CLI version to ensure you have all of error tracking's features.
Flutter apps can run on multiple platforms, each with its own debug symbol format. Follow the relevant section below for each platform you support.
Flutter Web
Ensure source maps are generated:
Then use our standard CLI approach to inject and upload them.
iOS / macOS
When captureNativeExceptions is enabled, native crashes on Apple platforms are captured automatically. To get symbolicated stack traces, you need to upload dSYM debug symbols.
Follow the iOS source maps guide to set up a build phase script in Xcode that uploads dSYMs automatically.
Android
When captureNativeExceptions is enabled, Java/Kotlin exceptions on Android are captured automatically. If your app uses ProGuard or R8 minification, you need to upload mapping files so stack traces can be deobfuscated.
Follow the Android mappings guide to set up the PostHog Gradle plugin for automatic uploads.