Skip to content

Add Hermes manual source maps Troubleshooting section #13750

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 3 commits into
base: master
Choose a base branch
from
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 7 additions & 1 deletion docs/platforms/react-native/sourcemaps/uploading/hermes.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -161,4 +161,10 @@ When uploaded, the `bundle` file will have a size of 0 bytes. This is expected w

</Alert>

For more Hermes guides, see the [Hermes Throubleshooting](/platforms/react-native/manual-setup/hermes/#throubleshooting) docs section.
## Troubleshooting

When generated source maps using this guide don’t seem to be correct, check the `Contexts` -> `React Native` -> `Hermes Debug Info` flag in the events. If the flag is `true`, this means the bundle shipped with the native application package was generated without Hermes source maps, and plain Metro (JS Core) source maps need to be used for the symbolication. Follow the [JavaScript Core guide](/platforms/react-native/sourcemaps/uploading/jsc/) to upload the correct source maps.

Note that the debug information included in the Hermes bundle increases the size of the final shipped bundle, and it's recommended to enable the source maps during the native application build (even when uploaded later manually, as generating the Hermes source maps has a side effect of striping the debug information, saving it to the source map). For automatic source maps upload, follow the [Manual Setup guide](/platforms/react-native/manual-setup/manual-setup/). The Sentry Xcode Scripts and Gradle Plugin automatically enable source maps. If you can't use the automatic upload scripts, enable source maps as described in the [React Native Source Maps guide](https://reactnative.dev/docs/debugging-release-builds#enabling-source-maps).

For more Hermes guides, see the [Hermes Troubleshooting](/platforms/react-native/manual-setup/hermes/#troubleshooting) docs section.