You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
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>
Copy file name to clipboardExpand all lines: platform-includes/debug-symbols/dart-plugin/dart.flutter.mdx
+7-6Lines changed: 7 additions & 6 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -98,13 +98,11 @@ For the full list of configuration options, see the [Configuration Reference](#c
98
98
99
99
## Configure the Android Gradle Plugin
100
100
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.
104
102
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">
106
104
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.
108
106
109
107
After installing the [Sentry Android Gradle Plugin](/platforms/android/configuration/gradle/), configure it in your `app/build.gradle.kts` file:
110
108
@@ -132,6 +130,8 @@ ProGuard mapping upload is enabled automatically by the Sentry Android Gradle Pl
132
130
Alternatively, you can use the [Sentry CLI](/cli/dif/#proguard-mapping-upload) to manually upload ProGuard mapping files.
133
131
For more information, see the [Android Gradle Plugin guide](/platforms/android/configuration/gradle).
134
132
133
+
</Expandable>
134
+
135
135
## Building Your Application
136
136
137
137
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
156
156
157
157
<Alert>
158
158
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.
0 commit comments