Skip to content

Commit 062162b

Browse files
buenaflorclaudecursoragent
committed
docs(flutter): Make Android Gradle Plugin setup an optional step
Wrap the Sentry Android Gradle Plugin configuration in an Expandable since it is only required when R8 or ProGuard is enabled. This keeps the debug symbols guide focused for the common case where JVM stack traces are already readable. Co-Authored-By: Claude <noreply@anthropic.com> Co-authored-by: Cursor <cursoragent@cursor.com>
1 parent ed1d078 commit 062162b

1 file changed

Lines changed: 7 additions & 6 deletions

File tree

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

Lines changed: 7 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -98,13 +98,11 @@ For the full list of configuration options, see the [Configuration Reference](#c
9898

9999
## Configure the Android Gradle Plugin
100100

101-
For Android, the Sentry Android Gradle Plugin uploads the files needed to symbolicate JVM frames. It runs automatically during your Android build, so configure it before building your app.
102-
103-
<Alert>
101+
This step is only required if R8 or ProGuard is enabled for your Android build. Without it, JVM stack traces are already readable and no mapping file upload is required.
104102

105-
You only need to configure the Sentry Android Gradle Plugin if R8 or ProGuard is enabled for your Android build. Without it, JVM stack traces are already readable and no mapping file upload is required.
103+
<Expandable title="Using R8 or ProGuard? Configure the Sentry Android Gradle Plugin">
106104

107-
</Alert>
105+
For Android, the Sentry Android Gradle Plugin uploads the files needed to symbolicate JVM frames. It runs automatically during your Android build, so configure it before building your app.
108106

109107
After installing the [Sentry Android Gradle Plugin](/platforms/android/configuration/gradle/), configure it in your `app/build.gradle.kts` file:
110108

@@ -132,6 +130,8 @@ ProGuard mapping upload is enabled automatically by the Sentry Android Gradle Pl
132130
Alternatively, you can use the [Sentry CLI](/cli/dif/#proguard-mapping-upload) to manually upload ProGuard mapping files.
133131
For more information, see the [Android Gradle Plugin guide](/platforms/android/configuration/gradle).
134132

133+
</Expandable>
134+
135135
## Building Your Application
136136

137137
Before running the plugin, build your Flutter application. Obfuscation is encouraged for production builds, and will make uploading debug symbols necessary to get readable stack traces.
@@ -156,7 +156,8 @@ flutter build web --release --source-maps
156156

157157
<Alert>
158158

159-
For iOS and macOS, we recommend running the Sentry Dart Plugin even for non-obfuscated builds to upload the dSYM files Xcode generates. This lets Sentry symbolicate native Swift, Objective-C, and C/C++ stack traces.
159+
Even if you don't use `split-debug-info` or `obfuscate`, we recommend uploading all available debug files with the Sentry Dart Plugin.
160+
The more you upload, the more Sentry can symbolicate out of the box — including native frames (for example, on iOS) that aren't readable otherwise.
160161

161162
</Alert>
162163

0 commit comments

Comments
 (0)