Hermes

Sentry added support for react-native builds that use the hermes engine, which required changes to the sentry SDK, sentry-cli as well as Sentry itself.

Sentry customers using the

SaaSSentry's cloud-based, software-as-a-service solution.
product (sentry.io) will need to update the SDK, and sentry-cli. The minimum required version for the SDK is @sentry/react-native SDK version 1.3.3, and @sentry/cli version 1.51.1.

For self-hosted Sentry users, the minimum version required is f07352b.

Once you have the minimum version of the SDK, Sentry provides the standard integration as described in the React Native Sentry documentation.

Source Maps

If you do not need custom sourcemaps, the sentry.gradle build step fully supports Hermes source maps.

Custom Source Maps

If you are manually bundling and building React Native apps, follow this three-step process.

Compile Sourcemaps

  1. Bundle/minify with metro (react-native) to get the bundle (.bundle or .jsbundle) and packager source map (.map):
Copied
npx react-native bundle --platform android --dev false --entry-file index.js --reset-cache --bundle-output index.android.bundle --sourcemap-output index.android.bundle.packager.map --minify false
  1. Compile to bytecode using hermes to get the compiler source map (.hbc.map):
Copied
node_modules/hermes-engine/{OS-BIN}/hermesc -O -emit-binary -output-source-map -out=index.android.bundle.hbc index.android.bundle
rm -f index.android.bundle
mv index.android.bundle.hbc index.android.bundle
  1. Merge the two source maps using compose-source-maps to get the final source map (.map):
Copied
node node_modules/react-native/scripts/compose-source-maps.js index.android.bundle.packager.map index.android.bundle.hbc.map -o index.android.bundle.map

Upload the Bundle and Source Maps

Upload your source maps following Step 3 on the normal source maps guide.

Help improve this content
Our documentation is open source and available on GitHub. Your contributions are welcome, whether fixing a typo (drat!) to suggesting an update ("yeah, this would be better").