# Migrate from 7.x to 8.x | Sentry for React Native

**Version 8 is currently in alpha.** This migration guide is provided for early adopters. The API and features may change before the stable release.

Version 8 of the Sentry React Native SDK updates the underlying native SDKs (Cocoa v9, CLI v3, Android Gradle Plugin v6) which introduce breaking changes in minimum version requirements and build tooling.

## [Important Changes in Dependencies](https://docs.sentry.io/platforms/react-native/migration/v7-to-v8.md#important-changes-in-dependencies)

Version 8 includes major upgrades to the underlying native SDKs:

* **Cocoa SDK**: Upgraded from v8.58.0 to v9.1.0 ([#5356](https://github.com/getsentry/sentry-react-native/pull/5356)). See the [Cocoa SDK 8.x to 9.x migration guide](https://docs.sentry.io/platforms/apple/migration.md#migrating-from-8x-to-9x) for details on breaking changes.
* **Sentry CLI**: Upgraded from v2.58.4 to v3.1.0 ([#5523](https://github.com/getsentry/sentry-react-native/pull/5523))
* **Android Gradle Plugin**: Upgraded to v6.0.0 ([#5578](https://github.com/getsentry/sentry-react-native/pull/5578)). If you're using the Android SDK directly, see the [Android SDK migration guide](https://docs.sentry.io/platforms/android/migration.md) for details.

These upgrades introduce breaking changes in minimum version requirements and build tooling.

## [Breaking Changes](https://docs.sentry.io/platforms/react-native/migration/v7-to-v8.md#breaking-changes)

### [Minimum Version Requirements](https://docs.sentry.io/platforms/react-native/migration/v7-to-v8.md#minimum-version-requirements)

#### [iOS/macOS/tvOS](https://docs.sentry.io/platforms/react-native/migration/v7-to-v8.md#iosmacostvos)

The minimum supported versions have been updated:

* **iOS**: **15.0+** (previously 11.0+)
* **macOS**: **10.14+** (previously 10.13+)
* **tvOS**: **15.0+** (previously 11.0+)

If your app targets older versions, you'll need to update your deployment targets before upgrading to version 8. For more details on the Cocoa SDK v9 changes, see the [Cocoa SDK 8.x to 9.x migration guide](https://docs.sentry.io/platforms/apple/migration.md#migrating-from-8x-to-9x).

#### [Android](https://docs.sentry.io/platforms/react-native/migration/v7-to-v8.md#android)

The Android build tooling requirements have been updated:

* **Sentry Android Gradle Plugin**: **6.0.0** (previously 5.x)
  * Drops support for Android Gradle Plugin 7.3.X and below
* **Android Gradle Plugin**: **7.4.0+** (previously 7.3.0+)
* **Kotlin**: **1.8+** (previously no minimum specified)

Update your `android/build.gradle` file to ensure compatibility. If you're using the Android SDK directly, see the [Android SDK migration guide](https://docs.sentry.io/platforms/android/migration.md) for details:

```gradle
buildscript {
    ext {
        kotlinVersion = "1.8.0" // or higher
        androidGradlePluginVersion = "7.4.0" // or higher
    }
    dependencies {
        classpath("com.android.tools.build:gradle:$androidGradlePluginVersion")
        classpath("io.sentry:sentry-android-gradle-plugin:6.0.0")
    }
}
```

#### [Sentry Self-Hosted](https://docs.sentry.io/platforms/react-native/migration/v7-to-v8.md#sentry-self-hosted)

Sentry CLI v3 requires self-hosted Sentry instances version **25.11.1+** (previously 25.2.0).

If you're using a self-hosted Sentry instance, ensure it's running version 25.11.1 or higher before upgrading to React Native SDK v8.