Sentry's most recent version of our React Native SDK enables release health tracking and native stack traces by default.
This version of the SDK uses the envelope endpoint. If you are using an on-premise installation, the SDK requires Sentry version 20.6.0 and above. If you are using our SaaS product (
sentry.io), there is no change and no action is required.
While the migration does not introduce breaking changes for iOS/MacOS on the React Native side, we recommend that you run
pod install after the upgrade.
If you are using our Cocoa SDK directly, follow that migration guide for 5.x to 6.x.
On iOS/MacOS, we now cache events in envelopes on the disk. As a result, you might lose a few cached events during the migration. Due to the effort involved, the migration from 5.x to 6.x does not move these few cached events into envelopes.
If you are on React Native <0.60, you will need to update this line in your
From (earlier version):
Other than the one line change noted above, the migration should not cause breaking changes on the React Native side.
If you use our Android SDK directly, you should follow its migration guide for 2.x to 3.x.
If you are upgrading from an earlier version of Sentry's React Native SDK, you should unlink the package to ensure the generated code is updated to the latest version:
react-native unlink react-native-sentry
After that remove
react-native-sentry from your
npm uninstall react-native-sentry --save # or yarn remove react-native-sentry
From there you can follow the standard installation instructions for