Sentry Android Gradle Plugin (AGP)

To enable the plugin modify the Expo application configuration and add the enableAndroidGradlePlugin option in the @sentry/react-native/expo plugin section.

{
  "expo": {
    "plugins": [
      [
        "@sentry/react-native/expo",
        {
          "url": "https://sentry.io/",
          "project": "example-project",
          "organization": "example-org"
          "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.

{
  "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.