Skip to content

Commit 1579f6a

Browse files
krystofwoldrichbitsandfoxes
authored andcommitted
Add Hermes manual source maps Troubleshooting section (#13750)
1 parent 24a76da commit 1579f6a

File tree

1 file changed

+7
-1
lines changed
  • docs/platforms/react-native/sourcemaps/uploading

1 file changed

+7
-1
lines changed

docs/platforms/react-native/sourcemaps/uploading/hermes.mdx

Lines changed: 7 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -161,4 +161,10 @@ When uploaded, the `bundle` file will have a size of 0 bytes. This is expected w
161161

162162
</Alert>
163163

164-
For more Hermes guides, see the [Hermes Throubleshooting](/platforms/react-native/manual-setup/hermes/#throubleshooting) docs section.
164+
## Troubleshooting
165+
166+
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.
167+
168+
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).
169+
170+
For more Hermes guides, see the [Hermes Troubleshooting](/platforms/react-native/manual-setup/hermes/#troubleshooting) docs section.

0 commit comments

Comments
 (0)