diff --git a/docs/platforms/flutter/upload-debug.mdx b/docs/platforms/flutter/upload-debug.mdx index 4b26b317d3b5a5..43fb7c0fb9cd5f 100644 --- a/docs/platforms/flutter/upload-debug.mdx +++ b/docs/platforms/flutter/upload-debug.mdx @@ -10,12 +10,6 @@ We offer a range of methods to provide Sentry with debug symbols so that you can With default settings, complete stack traces are available in your Dart error, out of the box, unless you use [`split-debug-info`](https://flutter.dev/docs/perf/app-size#reducing-app-size) and [`obfuscate`](https://flutter.dev/docs/deployment/obfuscate). In those cases, you need to upload the debug information files generated by the `flutter` build, so Sentry can show you proper stack traces. - - -For Flutter Desktop (Windows/Linux) `split-debug-info` and `obfuscate` flags are not supported yet. See this [issue](https://github.com/getsentry/sentry-dart/issues/433). - - - Errors raised from the native layer in Flutter apps require certain debug information files to be uploaded. For example, an Android app can use `proguard` for minification and obfuscation. And when using NDK, dwarf debug files need to be uploaded. Flutter Web requires sourcemaps and iOS apps also require dwarf debug information files. ## Sentry Dart Plugin @@ -94,11 +88,15 @@ For a standard build: - `flutter build apk` - `flutter build ios` - `flutter build macos` +- `flutter build windows` +- `flutter build linux` -For an obfuscated build: +For an [obfuscated build](https://docs.flutter.dev/deployment/obfuscate): - `flutter build apk --obfuscate --split-debug-info=` - `flutter build ios --obfuscate --split-debug-info=` - `flutter build macos --obfuscate --split-debug-info=` +- `flutter build windows --obfuscate --split-debug-info=` +- `flutter build linux --obfuscate --split-debug-info=` @@ -157,16 +155,16 @@ You will need to upload the following files: Sentry requires a dSYM upload to symbolicate your crash logs. The symbolication process unscrambles Appleā€™s crash logs to reveal the function, file names, and line numbers of the crash. [Learn how to upload the dSYM files](/platforms/apple/dsym/). -### Android +### Android, Windows and Linux See our docs on uploading [Debug Information Files](/cli/dif/#uploading-files) manually with the Sentry CLI. -### Android NDK - -See our docs on uploading [Debug Information Files](/cli/dif/#uploading-files) manually with the Sentry CLI. + If you're using a version of `sentry_flutter` earlier than 5.1, native symbolication on Android requires a specific configuration. Refer to [Troubleshooting](/platforms/flutter/troubleshooting/#native-symbolication-on-android) for more information. + + Sentry's Flutter SDK doesn't currently support the `uploadNativeSymbols` flag from the [Sentry Gradle Plugin](/platforms/android/configuration/gradle/).