Source Maps

To get unminified stack traces for JavaScript code, source maps must be generated and uploaded. The React Native SDK handles source maps automatically for iOS with Xcode and Android with Gradle, if you do not use custom values.

Choose one of the following guides depending on your setup, or try the automatic upload to get started.

• Expo
• Hermes
• JavaScript Core (JSC)

Set Up Automatic Upload

The easiest way to configure automatic source maps upload is to use the Sentry Wizard:

npx @sentry/wizard@latest -i reactNative

The wizard will guide you through the following steps:

• Logging into Sentry and selecting a project
• Installing the necessary Sentry packages
• Configuring RN build tools to generate and upload source maps

It supports JavaScript Core (including RAM Bundle) and Hermes. If you want to configure automatic source maps upload manually, follow the steps on the Manual Configuration page.

Disable Automatic Upload

If you want to disable the automatic upload of source maps, you can set the SENTRY_DISABLE_AUTO_UPLOAD environment variable:

export SENTRY_DISABLE_AUTO_UPLOAD=true

Add the shouldSentryAutoUpload function in android/app/build.gradle:

apply from: "../../../sentry.gradle"

sentry {
    autoUploadProguardMapping = shouldSentryAutoUpload()
    uploadNativeSymbols = shouldSentryAutoUpload()
}

Debug Builds

Symbolication is handled directly by the Metro development server, automatically providing the symbolication needed to translate stack traces into readable source code in a development environment. There's no need to upload source maps for these types of builds which is why the automatic uploading of source maps is disabled.