From 298efe998daeef333f62d4365f98ee986a14f480 Mon Sep 17 00:00:00 2001 From: Bruno Garcia Date: Sat, 1 Feb 2025 21:34:35 -0500 Subject: [PATCH 1/4] flutter: win/linux supported native symbols --- docs/platforms/flutter/upload-debug.mdx | 14 +++++++++----- 1 file changed, 9 insertions(+), 5 deletions(-) diff --git a/docs/platforms/flutter/upload-debug.mdx b/docs/platforms/flutter/upload-debug.mdx index 4b26b317d3b5a..8e5ec6b0a3002 100644 --- a/docs/platforms/flutter/upload-debug.mdx +++ b/docs/platforms/flutter/upload-debug.mdx @@ -94,11 +94,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 +161,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/). From f0a06dcf8553056812e60588ee2b80ef705d6df0 Mon Sep 17 00:00:00 2001 From: Bruno Garcia Date: Sun, 2 Feb 2025 14:18:40 -0500 Subject: [PATCH 2/4] Apply suggestions from code review --- docs/platforms/flutter/upload-debug.mdx | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/platforms/flutter/upload-debug.mdx b/docs/platforms/flutter/upload-debug.mdx index 8e5ec6b0a3002..b022fe65f00dc 100644 --- a/docs/platforms/flutter/upload-debug.mdx +++ b/docs/platforms/flutter/upload-debug.mdx @@ -165,11 +165,11 @@ Sentry requires a dSYM upload to symbolicate your crash logs. The symbolication 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. - + From a83e30e363f79820f34411c2e17b70ae9689650c Mon Sep 17 00:00:00 2001 From: Ivan Dlugos <6349682+vaind@users.noreply.github.com> Date: Tue, 4 Feb 2025 10:08:29 +0100 Subject: [PATCH 3/4] remove win/linux not supported with obfuscation --- docs/platforms/flutter/upload-debug.mdx | 6 ------ 1 file changed, 6 deletions(-) diff --git a/docs/platforms/flutter/upload-debug.mdx b/docs/platforms/flutter/upload-debug.mdx index b022fe65f00dc..43fb7c0fb9cd5 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 From cc3103b47d862023a160fdf10587cc407b9134b7 Mon Sep 17 00:00:00 2001 From: Bruno Garcia Date: Wed, 19 Feb 2025 13:34:11 -0500 Subject: [PATCH 4/4] Update upload-debug.mdx --- docs/platforms/flutter/upload-debug.mdx | 6 ------ 1 file changed, 6 deletions(-) diff --git a/docs/platforms/flutter/upload-debug.mdx b/docs/platforms/flutter/upload-debug.mdx index 43fb7c0fb9cd5..0f8856b138412 100644 --- a/docs/platforms/flutter/upload-debug.mdx +++ b/docs/platforms/flutter/upload-debug.mdx @@ -161,12 +161,6 @@ See our docs on uploading [Debug Information Files](/cli/dif/#uploading-files) m -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/).