Skip to content

ref(React-Native): Update Migration with the latest instructions. #14791

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.

Sign up for GitHub

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

Merged
merged 4 commits into from
Sep 2, 2025
Merged

ref(React-Native): Update Migration with the latest instructions. #14791

Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
d52c35d
Migration WIP
lucas-zimerman Sep 2, 2025
7a3dfd3
extra notes for V10
lucas-zimerman Sep 2, 2025
eb89cb8
v7 GA updates
Sep 2, 2025
e0ae4a3
Merge branch 'master' into lz/rnv7/migration
kahest Sep 2, 2025
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
18 changes: 9 additions & 9 deletions docs/platforms/react-native/migration/v6-to-v7.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4,27 +4,27 @@ sidebar_order: 99
description: "Learn how to migrate from version 6 to version 7 of the Sentry React Native SDK"
---

<Alert level="warning" title="Important">
Version 7 is still under development, this documentation may change before the final release.
</Alert>

The main goal of version 7 of the Sentry React Native SDK is to provide compatibility with Sentry JavaScript version 9. This update includes breaking changes due to the upgrade to JavaScript SDK v9, the removal of deprecated APIs, and a reorganization of the npm package structure.
The main goal of version 7 of the Sentry React Native SDK is to provide compatibility with Sentry JavaScript versions 9 and 10. This update includes breaking changes due to the upgrade to JavaScript SDK v10, the removal of deprecated APIs, and a reorganization of the npm package structure.

## Important Changes in Dependencies

The Sentry React Native SDK ships with the Sentry JavaScript SDK Version 9 as a dependency. This version includes a number of behavioral changes that will not be caught by type checkers, linters, or tests, so we recommend carefully reading through the entire migration guide instead of relying on automatic tooling. Please follow [the JavaScript migration guides](/platforms/javascript/guides/react/migration/v8-to-v9/) to complete the upgrade.
The Sentry React Native SDK ships with the Sentry JavaScript SDK Version 10 as a dependency. This version includes two major updates (Sentry JavaScript v9 and v10), a number of behavioral changes that will not be caught by type checkers, linters, or tests, so we recommend carefully reading through the entire migration guide instead of relying on automatic tooling. Please follow the [V9 migration](#major-changes-in-sentry-js-sdk-v9) and [V10 migration](#major-changes-in-sentry-js-sdk-v10) to complete the upgrade.

The initial `@sentry/react-native@7.0.0` ships with `@sentry/core@9.1.0`. Always use the exact JavaScript SDK version if adding it manually to your project. Any other version might not be compatible with the React Native SDK.
The initial release `@sentry/react-native@7.0.0` ships with `@sentry/core@10.8.0`. Always use the exact JavaScript SDK version if adding it manually to your project. Any other version might not be compatible with the React Native SDK.

Version 7 also includes a major upgrade to the Android SDK dependency, introducing behavioral changes, breaking changes, and deprecations. If you are using the Android SDK directly, please follow the [Android SDK version 8 migration guide](/platforms/android/migration/#migrating-from-iosentrysentry-7x-to-iosentrysentry-800).

### Major Changes in Sentry JS SDK v9

Other general JavaScript SDK version 9 changes are described in the [JavaScript SDK 8.x to 9.x migration guide](/platforms/javascript/guides/react/migration/v8-to-v9/).
This upgrade includes many behavioral and API changes which are mostly related to Spans instrumentation and removal of APIs. For these and other general JavaScript SDK version 9 changes, refer to the [JavaScript SDK 8.x to 9.x migration guide](/platforms/javascript/guides/react/migration/v8-to-v9/).

### Major Changes in Sentry JS SDK v10

This update contains a fix for indicating whether the backend should derive and store user IP addresses. It also includes API cleanups related to `BaseClient`, `hasTracingEnabled`, and `logger` from `@sentry/core`. For details and other general JavaScript SDK version 10 changes, refer to the [JavaScript SDK 9.x to 10.x migration guide](/platforms/javascript/guides/react/migration/v9-to-v10/).

### Self-Hosted Sentry Compatibility

Beginning with version 7.0.0, the Sentry Capacitor SDK will only support self-hosted Sentry instances version 25.2.0 and above. This change does not affect users of `sentry.io`.
Beginning with version 7.0.0, the Sentry React Native SDK will only support self-hosted Sentry instances version 25.2.0 and above.

## Important React Native SDK `7.x` Changes

Expand Down