Skip to content

Commit 4bec4d2

Browse files
committed
resolving feedback
- remove repetitive info from index - remove standard build bash scripts - clarify source context constraints - remove duplicated manual upload instructions from dart-plugin instructions
1 parent c503940 commit 4bec4d2

File tree

4 files changed

+2
-60
lines changed

4 files changed

+2
-60
lines changed

docs/platforms/dart/common/debug-symbols/index.mdx

Lines changed: 0 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -22,13 +22,6 @@ In Dart applications, debug symbols can include:
2222

2323
With default settings, complete stack traces are available in your Dart errors 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) flags. In these cases, you must upload the debug information files generated by the build, so Sentry can show proper stack traces.
2424

25-
26-
Errors raised from the native layer in Flutter apps also require debug information files:
27-
- Android apps using `proguard` for minification and obfuscation need mapping files
28-
- iOS/macOS apps require dSYM files
29-
- Android NDK requires DWARF debug files
30-
- Flutter Web requires source maps
31-
3225
## Upload Methods
3326

3427
Sentry offers several methods to upload debug symbols for Dart applications:

docs/platforms/dart/guides/flutter/debug-symbols/index.mdx

Lines changed: 0 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -22,13 +22,6 @@ In Dart applications, debug symbols can include:
2222

2323
With default settings, complete stack traces are available in your Dart errors 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) flags. In these cases, you must upload the debug information files generated by the build, so Sentry can show proper stack traces.
2424

25-
26-
Errors raised from the native layer in Flutter apps also require debug information files:
27-
- Android apps using `proguard` for minification and obfuscation need mapping files
28-
- iOS/macOS apps require dSYM files
29-
- Android NDK requires DWARF debug files
30-
- Flutter Web requires source maps
31-
3225
## Upload Methods
3326

3427
Sentry offers several methods to upload debug symbols for Dart applications:

platform-includes/debug-symbols/dart-plugin/dart.mdx

Lines changed: 1 addition & 23 deletions
Original file line numberDiff line numberDiff line change
@@ -56,14 +56,6 @@ flutter build windows --obfuscate --split-debug-info=<output-directory>
5656
flutter build linux --obfuscate --split-debug-info=<output-directory>
5757
```
5858

59-
```bash {tabTitle: Standard}
60-
flutter build apk
61-
flutter build ios
62-
flutter build macos
63-
flutter build windows
64-
flutter build linux
65-
```
66-
6759
```bash {tabTitle: Flutter Web}
6860
flutter build web --release --source-maps
6961
```
@@ -81,7 +73,7 @@ flutter pub run sentry_dart_plugin
8173

8274
<Alert>
8375

84-
If you don't obfuscate your build, the plugin won't upload debug symbols but will still configure source context if enabled.
76+
If you don't obfuscate your build, the plugin won't upload debug symbols. There is no support yet for non-obfuscated builds. GitHub Issue: [sentry-dart/#1314](https://github.com/getsentry/sentry-dart/issues/1314)
8577

8678
</Alert>
8779

@@ -115,20 +107,6 @@ Sentry's Flutter SDK doesn't currently support the `uploadNativeSymbols` flag fr
115107

116108
</Alert>
117109

118-
## iOS and macOS dSYM Uploads
119-
120-
For iOS and macOS applications, you need to upload dSYM files. The Sentry Dart Plugin will automatically handle this when you build with the `--obfuscate` flag.
121-
122-
For non-obfuscated builds or additional configuration options, you can:
123-
124-
1. **Use the Sentry Cocoa script**
125-
126-
Follow the [Sentry Cocoa debug symbols guide](/platforms/apple/guides/ios/dsym/) to set up automatic dSYM uploads with the script.
127-
128-
2. **Use the Sentry CLI**
129-
130-
Use the [Sentry CLI](/platforms/apple/guides/ios/dsym/#upload-dsyms-with-cli) to manually upload dSYM files.
131-
132110
## Configuration Reference
133111

134112
The following table lists all available configuration options for the Sentry Dart Plugin:

platform-includes/debug-symbols/dart-plugin/flutter.mdx

Lines changed: 1 addition & 23 deletions
Original file line numberDiff line numberDiff line change
@@ -56,14 +56,6 @@ flutter build windows --obfuscate --split-debug-info=<output-directory>
5656
flutter build linux --obfuscate --split-debug-info=<output-directory>
5757
```
5858

59-
```bash {tabTitle: Standard}
60-
flutter build apk
61-
flutter build ios
62-
flutter build macos
63-
flutter build windows
64-
flutter build linux
65-
```
66-
6759
```bash {tabTitle: Flutter Web}
6860
flutter build web --release --source-maps
6961
```
@@ -81,7 +73,7 @@ flutter pub run sentry_dart_plugin
8173

8274
<Alert>
8375

84-
If you don't obfuscate your build, the plugin won't upload debug symbols but will still configure source context if enabled.
76+
If you don't obfuscate your build, the plugin won't upload debug symbols. There is no support yet for non-obfuscated builds. GitHub Issue: [sentry-dart/#1314](https://github.com/getsentry/sentry-dart/issues/1314)
8577

8678
</Alert>
8779

@@ -115,20 +107,6 @@ Sentry's Flutter SDK doesn't currently support the `uploadNativeSymbols` flag fr
115107

116108
</Alert>
117109

118-
## iOS and macOS dSYM Uploads
119-
120-
For iOS and macOS applications, you need to upload dSYM files. The Sentry Dart Plugin will automatically handle this when you build with the `--obfuscate` flag.
121-
122-
For non-obfuscated builds or additional configuration options, you can:
123-
124-
1. **Use the Sentry Cocoa script**
125-
126-
Follow the [Sentry Cocoa debug symbols guide](/platforms/apple/guides/ios/dsym/) to set up automatic dSYM uploads with the script.
127-
128-
2. **Use the Sentry CLI**
129-
130-
Use the [Sentry CLI](/platforms/apple/guides/ios/dsym/#upload-dsyms-with-cli) to manually upload dSYM files.
131-
132110
## Configuration Reference
133111

134112
The following table lists all available configuration options for the Sentry Dart Plugin:

0 commit comments

Comments
 (0)