|
2 | 2 |
|
3 | 3 | <!-- prettier-ignore-start -->
|
4 | 4 | > [!IMPORTANT]
|
5 |
| -> If you are upgrading to the `6.x` versions of the Sentry React Native SDK from `5.x` or below, |
| 5 | +> If you are upgrading to the `7.x` versions of the Sentry React Native SDK from `6.x` or below, |
6 | 6 | > make sure you follow our [migration guide](https://docs.sentry.io/platforms/react-native/migration/) first.
|
7 | 7 | <!-- prettier-ignore-end -->
|
8 | 8 |
|
| 9 | +## 7.0.0-beta.0 |
| 10 | + |
| 11 | +### Upgrading from 6.x to 7.0 |
| 12 | + |
| 13 | +Version 7 of the Sentry React Native SDK primarily introduces API cleanup and version support changes based on the Sentry Javascript SDK version 9. This update contains 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. |
| 14 | + |
| 15 | +Version 7 of the SDK is compatible with Sentry self-hosted versions 24.4.2 or higher (unchanged from v6). Lower versions may continue to work, but may not support all features. |
| 16 | + |
| 17 | +### Major Changes |
| 18 | + |
| 19 | +- Set `{{auto}}` if `user.ip_address` is `undefined` and `sendDefaultPii: true` ([#4466](https://github.com/getsentry/sentry-react-native/pull/4466)) |
| 20 | +- `Sentry.captureUserFeedback` removed, use `Sentry.captureFeedback` instead ([#4855](https://github.com/getsentry/sentry-react-native/pull/4855)) |
| 21 | + |
| 22 | +### Major Changes from Sentry JS SDK v9 |
| 23 | + |
| 24 | +- Exceptions from `captureConsoleIntegration` are now marked as handled: true by default |
| 25 | +- `shutdownTimeout` moved from `core` to `@sentry/react-native` |
| 26 | +- `hasTracingEnabled` was renamed to `hasSpansEnabled` |
| 27 | +- You can no longer drop spans or return null on `beforeSendSpan` hook |
| 28 | +- Fork `scope` if custom scope is passed to `startSpanManual` or `startSpan` |
| 29 | + |
| 30 | +#### Removed types |
| 31 | + |
| 32 | +- TransactionNamingScheme |
| 33 | +- Request |
| 34 | +- Scope (prefer using the Scope class) |
| 35 | + |
| 36 | +#### Other removed items. |
| 37 | + |
| 38 | +- `autoSessionTracking` from options. |
| 39 | + To enable session tracking, ensure that `enableAutoSessionTracking` is enabled. |
| 40 | +- `enableTracing`. Instead, set `tracesSampleRate` to a value greater than `zero` to `enable tracing`, `0` to keep tracing integrations active without sampling, or `undefined` to disable the performance integration. |
| 41 | +- `getCurrentHub()`, `Hub`, and `getCurrentHubShim()` |
| 42 | +- `spanId` from propagation `context` |
| 43 | +- metrics API |
| 44 | +- `transactionContext` from `samplingContext` |
| 45 | +- `@sentry/utils` package, the exports were moved to `@sentry/core` |
| 46 | +- Standalone `Client` interface & deprecate `BaseClient` |
| 47 | + |
| 48 | +### Changes |
| 49 | + |
| 50 | +- Use `Replay` interface for `browserReplayIntegration` return type ([#4858](https://github.com/getsentry/sentry-react-native/pull/4858)) |
| 51 | +- Allow using `browserReplayIntegration` without `isWeb` guard ([#4858](https://github.com/getsentry/sentry-react-native/pull/4858)) |
| 52 | + - The integration returns noop in non-browser environments |
| 53 | +- Use single `encodeUTF8` implementation through the SDK ([#4885](https://github.com/getsentry/sentry-react-native/pull/4885)) |
| 54 | +- Use global `TextEncoder` (available with Hermes in React Native 0.74 or higher) to improve envelope encoding performance. ([#4874](https://github.com/getsentry/sentry-react-native/pull/4874)) |
| 55 | +- `breadcrumbsIntegration` disables React Native incompatible options automatically ([#4886](https://github.com/getsentry/sentry-react-native/pull/4886)) |
| 56 | +- On React Native Web, `browserSessionIntegration` is added when `enableAutoSessionTracking` is set to `True` ([#4732](https://github.com/getsentry/sentry-react-native/pull/4732)) |
| 57 | +- Change `Cold/Warm App Start` span description to `Cold/Warm Start` ([#4636](https://github.com/getsentry/sentry-react-native/pull/4636)) |
| 58 | + |
| 59 | +### Dependencies |
| 60 | + |
| 61 | +- Bump JavaScript SDK from v8.54.0 to v9.22.0 ([#4568](https://github.com/getsentry/sentry-react-native/pull/4568), [#4752](https://github.com/getsentry/sentry-react-native/pull/4752), [#4860](https://github.com/getsentry/sentry-react-native/pull/4860)) |
| 62 | + - [changelog](https://github.com/getsentry/sentry-javascript/blob/9.22.0/CHANGELOG.md) |
| 63 | + - [diff](https://github.com/getsentry/sentry-javascript/compare/8.54.0...9.22.0) |
| 64 | +- Bump Android SDK from v7.20.1 to v8.13.2 ([#4490](https://github.com/getsentry/sentry-react-native/pull/4490), [#4847](https://github.com/getsentry/sentry-react-native/pull/4847)) |
| 65 | + - [changelog](https://github.com/getsentry/sentry-java/blob/main/CHANGELOG.md#8132) |
| 66 | + - [diff](https://github.com/getsentry/sentry-java/compare/7.20.1...8.13.2) |
| 67 | + |
9 | 68 | ## 6.15.0
|
10 | 69 |
|
11 | 70 | ### Features
|
|
57 | 116 | - [changelog](https://github.com/getsentry/sentry-cli/blob/master/CHANGELOG.md#2460)
|
58 | 117 | - [diff](https://github.com/getsentry/sentry-cli/compare/2.45.0...2.46.0)
|
59 | 118 |
|
| 119 | +## 7.0.0-alpha.0 |
| 120 | + |
| 121 | +### Upgrading from 6.x to 7.0 |
| 122 | + |
| 123 | +Version 7 of the Sentry React Native SDK primarily introduces API cleanup and version support changes based on the Sentry Javascript SDK version 9. This update contains 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. |
| 124 | + |
| 125 | +Version 7 of the SDK is compatible with Sentry self-hosted versions 24.4.2 or higher (unchanged from v6). Lower versions may continue to work, but may not support all features. |
| 126 | + |
| 127 | +### Fixes |
| 128 | + |
| 129 | +- Expo Updates Context is passed to native after native init to be available for crashes ([#4808](https://github.com/getsentry/sentry-react-native/pull/4808)) |
| 130 | +- Expo Updates Context values should all be lowercase ([#4809](https://github.com/getsentry/sentry-react-native/pull/4809)) |
| 131 | +- Avoid duplicate network requests (fetch, xhr) by default ([#4816](https://github.com/getsentry/sentry-react-native/pull/4816)) |
| 132 | + - `traceFetch` is disabled by default on mobile as RN uses a polyfill which will be traced by `traceXHR` |
| 133 | + |
| 134 | +### Major Changes |
| 135 | + |
| 136 | +- Set `{{auto}}` if `user.ip_address` is `undefined` and `sendDefaultPii: true` ([#4466](https://github.com/getsentry/sentry-react-native/pull/4466)) |
| 137 | +- Exceptions from `captureConsoleIntegration` are now marked as handled: true by default |
| 138 | +- `shutdownTimeout` moved from `core` to `@sentry/react-native` |
| 139 | +- `hasTracingEnabled` was renamed to `hasSpansEnabled` |
| 140 | +- You can no longer drop spans or return null on `beforeSendSpan` hook |
| 141 | + |
| 142 | +### Removed types |
| 143 | + |
| 144 | +- TransactionNamingScheme |
| 145 | +- Request |
| 146 | +- Scope (prefer using the Scope class) |
| 147 | + |
| 148 | +### Other removed items. |
| 149 | + |
| 150 | +- `autoSessionTracking` from options. |
| 151 | + To enable session tracking, ensure that `enableAutoSessionTracking` is enabled. |
| 152 | +- `enableTracing`. Instead, set `tracesSampleRate` to a value greater than `zero` to `enable tracing`, `0` to keep tracing integrations active without sampling, or `undefined` to disable the performance integration. |
| 153 | +- `getCurrentHub()`, `Hub`, and `getCurrentHubShim()` |
| 154 | +- `spanId` from propagation `context` |
| 155 | +- metrics API |
| 156 | +- `transactionContext` from `samplingContext` |
| 157 | +- `@sentry/utils` package, the exports were moved to `@sentry/core` |
| 158 | +- Standalone `Client` interface & deprecate `BaseClient` |
| 159 | + |
| 160 | +### Other Changes |
| 161 | + |
| 162 | +- Fork `scope` if custom scope is passed to `startSpanManual` or `startSpan` |
| 163 | +- On React Native Web, `browserSessionIntegration` is added when `enableAutoSessionTracking` is set to `True` ([#4732](https://github.com/getsentry/sentry-react-native/pull/4732)) |
| 164 | +- Change `Cold/Warm App Start` span description to `Cold/Warm Start` ([#4636](https://github.com/getsentry/sentry-react-native/pull/4636)) |
| 165 | + |
| 166 | +### Dependencies |
| 167 | + |
| 168 | +- Bump JavaScript SDK from v8.54.0 to v9.12.0 ([#4568](https://github.com/getsentry/sentry-react-native/pull/4568), [#4752](https://github.com/getsentry/sentry-react-native/pull/4752)) |
| 169 | + - [changelog](https://github.com/getsentry/sentry-javascript/blob/9.12.0/CHANGELOG.md) |
| 170 | + - [diff](https://github.com/getsentry/sentry-javascript/compare/8.54.0...9.12.0) |
| 171 | +- Bump Android SDK from v7.20.1 to v8.11.1 ([#4490](https://github.com/getsentry/sentry-react-native/pull/4490)) |
| 172 | + - [changelog](https://github.com/getsentry/sentry-java/blob/main/CHANGELOG.md#8111) |
| 173 | + - [diff](https://github.com/getsentry/sentry-java/compare/7.20.1...8.11.1) |
| 174 | +- Bump CLI from v2.43.1 to v2.45.0 ([#4804](https://github.com/getsentry/sentry-react-native/pull/4804), [#4818](https://github.com/getsentry/sentry-react-native/pull/4818)) |
| 175 | + - [changelog](https://github.com/getsentry/sentry-cli/blob/master/CHANGELOG.md#2450) |
| 176 | + - [diff](https://github.com/getsentry/sentry-cli/compare/2.43.1...2.45.0) |
| 177 | +- Bump Bundler Plugins from v3.3.1 to v3.4.0 ([#4805](https://github.com/getsentry/sentry-react-native/pull/4805)) |
| 178 | + - [changelog](https://github.com/getsentry/sentry-javascript-bundler-plugins/blob/main/CHANGELOG.md#340) |
| 179 | + - [diff](https://github.com/getsentry/sentry-javascript-bundler-plugins/compare/3.3.1...3.4.0) |
| 180 | +- Bump Cocoa SDK from v8.49.2 to v8.50.0 ([#4807](https://github.com/getsentry/sentry-react-native/pull/4807)) |
| 181 | + - [changelog](https://github.com/getsentry/sentry-cocoa/blob/main/CHANGELOG.md#8500) |
| 182 | + - [diff](https://github.com/getsentry/sentry-cocoa/compare/8.49.2...8.50.0) |
| 183 | + |
60 | 184 | ## 6.14.0
|
61 | 185 |
|
62 | 186 | ### Fixes
|
|
0 commit comments