RN: Adds RN Expo Sentry Android Gradle Plugin subpage (#12371)

Author: antonis

docs/platforms/react-native/manual-setup/expo.mdx

@@ -125,6 +125,7 @@ To verify that everything is working as expected, build the `Release` version of
 
 - [Learn how to upload source maps for native builds and Expo Updates](/platforms/react-native/sourcemaps/uploading/expo/)
 - [Add automatic tracing with Expo Router](/platforms/react-native/tracing/instrumentation/expo-router/)
+- [Configure the Sentry Android Gradle Plugin](/platforms/react-native/manual-setup/expo/gradle/)
 
 ## Notes
 

docs/platforms/react-native/manual-setup/expo/gradle.mdx

@@ -0,0 +1,89 @@
+---
+title: Sentry Android Gradle Plugin (AGP)
+description: "Learn how to configure the Sentry Android Gradle Plugin to automatically upload source maps and debug symbols for your Expo project."
+---
+
+<Alert>
+
+The **Sentry AGP** is still an experimental option of the Sentry React Native Expo plugin. If you encounter any issues please let us know via a GitHub ticket.
+
+</Alert>
+
+To enable the plugin modify the Expo application configuration and add the `enableAndroidGradlePlugin` option in the `@sentry/react-native/expo` plugin section.
+
+```javascript {tabTitle:app.json/app.config.json} {10-12}
+{
+  "expo": {
+    "plugins": [
+      [
+        "@sentry/react-native/expo",
+        {
+          "url": "https://sentry.io/",
+          "project": "___PROJECT_SLUG___",
+          "organization": "___ORG_SLUG___"
+          "experimental_android": {
+            "enableAndroidGradlePlugin": true,
+          }
+        }
+      ],
+  }
+}
+```
+
+## Configuration options
+
+You can configure the Sentry Android Gradle Plugin by passing an options object to the `experimental_android` key in the plugin configuration.
+
+```javascript {tabTitle:app.json/app.config.json}
+{
+  "expo": {
+...
+    "plugins": [
+      [
+        "@sentry/react-native/expo",
+        {
+...
+          "experimental_android": {
+            "enableAndroidGradlePlugin": true,
+            "autoUploadProguardMapping": true,
+            "includeProguardMapping": true,
+            "dexguardEnabled": true,
+            "uploadNativeSymbols": true,
+            "autoUploadNativeSymbols": true,
+            "includeNativeSources": true,
+            "includeSourceContext": true,
+          }
+        }
+      ],
+...
+  }
+}
+```
+
+### autoUploadProguardMapping
+
+This option specifies whether the plugin should attempt to auto-upload the mapping file to Sentry or not. If disabled the plugin will run a dry-run and just generate a UUID. The mapping file has to be uploaded manually via sentry-cli in this case. Default is enabled.
+
+### includeProguardMapping
+
+Disables or enables the handling of Proguard mapping for Sentry. If enabled the plugin will generate a UUID and will take care of uploading the mapping to Sentry. If disabled, all the logic related to proguard mapping will be excluded. Default is enabled.
+
+### dexguardEnabled
+
+Experimental flag to turn on support for GuardSquare's tools integration (Dexguard and External Proguard). If enabled, the plugin will try to consume and upload the mapping file produced by Dexguard and External Proguard. Default is disabled.
+
+### uploadNativeSymbols
+
+Disables or enables the automatic configuration of Native Symbols for Sentry. This executes sentry-cli automatically so you don't need to do it manually. Default is disabled.
+
+### autoUploadNativeSymbols
+
+Defines whether the plugin should attempt to auto-upload the native debug symbols to Sentry or not. If disabled the plugin will run a dry-run. Default is enabled.
+
+### includeNativeSources
+
+Does or doesn't include the source code of native code for Sentry. This executes sentry-cli with the --include-sources param. automatically so you don't need to do it manually. This option has an effect only when `uploadNativeSymbols` is enabled. Default is disabled.
+
+### includeSourceContext
+
+Generates a JVM (Java, Kotlin, etc.) source bundle and uploads your source code to Sentry. This enables source context, allowing you to see your source code as part of your stack traces in Sentry.