--- title: "Migrate from 8.x to 9.x" description: "Learn about migrating from Sentry Cocoa SDK 8.x to 9.x." url: https://docs.sentry.io/platforms/apple/guides/tvos/migration/v8-to-v9/ --- # Migrate from 8.x to 9.x | Sentry for tvOS Migrating to 9.x from 8.x includes several breaking changes. We provide this guide to help you update your SDK. ## [Changes to Minimum OS Versions and Xcode](https://docs.sentry.io/platforms/apple/guides/tvos/migration/v8-to-v9.md#changes-to-minimum-os-versions-and-xcode) We bumped the minimum supported OS versions to: * **iOS**: 15.0 (previously 11.0) * **macOS**: 10.14 (previously 10.13) * **tvOS**: 15.0 (previously 11.0) * **visionOS**: 1.0 (unchanged) * **watchOS**: 8.0 (previously 4.0) We now build the precompiled XCFramework with **Xcode 16**. To submit to the App Store, Apple now requires Xcode 16. If you need a precompiled XCFramework built with Xcode 15, continue using Sentry SDK 8.x.x. Additionally, the Package.swift sets `swift-tools-version` to 6.0. ## [Carthage Support Dropped](https://docs.sentry.io/platforms/apple/guides/tvos/migration/v8-to-v9.md#carthage-support-dropped) We dropped official support for Carthage in v9. If you're using Carthage, please migrate to [Swift Package Manager (SPM)](https://docs.sentry.io/platforms/apple/guides/tvos/install/swift-package-manager.md) or manually install the [pre-built XCFramework from GitHub releases](https://github.com/getsentry/sentry-cocoa/releases). ## [Features Enabled by Default](https://docs.sentry.io/platforms/apple/guides/tvos/migration/v8-to-v9.md#features-enabled-by-default) We now enabled the following features by default: * **Performance V2 is enabled by default**: The app start duration now finishes when the first frame is drawn instead of when the OS posts the `UIWindowDidBecomeVisibleNotification`. We removed the `enablePerformanceV2` option. * **Pre-warmed app start tracking**: The SDK now collects pre-warmed app starts by default via `enablePreWarmedAppStartTracing`. * [App hang tracking V2](https://docs.sentry.io/platforms/apple/guides/tvos/configuration/app-hangs.md#app-hangs-v2): This is now the default only on \*\*iOS and **tvOS** and we removed the option to enable/disable it. macOS still uses V1. ## [Disable App Hang Tracking for Extensions](https://docs.sentry.io/platforms/apple/guides/tvos/migration/v8-to-v9.md#disable-app-hang-tracking-for-extensions) We now automatically disable app hang tracking for: Widgets, Live Activities, Action Extensions, (Siri) Intent Extensions, Share Extensions. These components run in separate processes or sandboxes with different execution characteristics, which can cause false positive app hang reports. ## [Structured Logging](https://docs.sentry.io/platforms/apple/guides/tvos/migration/v8-to-v9.md#structured-logging) We moved structured logging out of experimental and made it part of the stable API. The `enableLogs` option moved from `options.experimental.enableLogs` to `options.enableLogs`. We added log APIs to `Hub` and `Client`, and logs now include a `sentry.replay_id` attribute. **Migration required:** Update your code from `options.experimental.enableLogs = true` to `options.enableLogs = true`. Logging is not enabled by default; you must explicitly set this option. ### [HTTP Client Errors](https://docs.sentry.io/platforms/apple/guides/tvos/migration/v8-to-v9.md#http-client-errors) HTTP client errors now mark sessions as errored. This provides better visibility into failed network requests in your release health data. ## [Profiling Changes](https://docs.sentry.io/platforms/apple/guides/tvos/migration/v8-to-v9.md#profiling-changes) We removed all deprecated profiling APIs in version [9.0.0](https://github.com/getsentry/sentry-cocoa/releases/tag/9.0.0). ## [Breaking Changes](https://docs.sentry.io/platforms/apple/guides/tvos/migration/v8-to-v9.md#breaking-changes) ### [Option Changes](https://docs.sentry.io/platforms/apple/guides/tvos/migration/v8-to-v9.md#option-changes) * `enableFileManagerSwizzling` is now a top-level non-experimental option and remains disabled by default. * `enableDataSwizzling` is now a top-level option and is enabled by default. * `enableLogs` is now a top-level non-experimental option and remains disabled by default (you must set it to `true` to enable logging). * We increased the maximum attachment size to 200MB (previously 20MB) * We removed the following methods and properties: * `inAppExclude` (it had no effect) * `integrations` * `defaultIntegrations()` * `enableTracing` (use `tracesSampleRate` or `tracesSampler` instead) * `getStoreEndpoint()` * `enablePerformanceV2` the behavior of this option is now enabled by default. ### [Behavioral Breaking Changes](https://docs.sentry.io/platforms/apple/guides/tvos/migration/v8-to-v9.md#behavioral-breaking-changes) * The default trace context status is now `ok` instead of `undefined`. * The `function` property on `SentryFrame` now defaults to `nil` instead of `""` * The `value` and `type` properties on `SentryException` are now nullable; when `NSException` has no reason, `type` is set to `nil` * We changed the type of the `http.response.status_code` attribute for spans to int * We converted `SentryDsn` to Swift and removed the public header file `SentryDsn.h` ### [Renamed APIs](https://docs.sentry.io/platforms/apple/guides/tvos/migration/v8-to-v9.md#renamed-apis) * We renamed `SentryStructuredLogLevel` to `SentryLogLevel` * We renamed `SentryStructuredLogAttribute` to `SentryLogAttribute` ### [Removed APIs](https://docs.sentry.io/platforms/apple/guides/tvos/migration/v8-to-v9.md#removed-apis) * We removed the `segment` property from `SentryTraceContext`, `SentryUser`, and `SentryBaggage` * We removed the initializers from `SentryTraceContext` * We removed `SentryDsn.getHash()` * We removed `SentryFrame.instruction` We removed the following deprecated APIs: * `SentrySpan.setExtraValue(_:forKey:)` * User feedback API (use the new [feedback API](https://docs.sentry.io/platforms/apple/guides/tvos/user-feedback.md) instead) * `Scope.useSpan()` (use `Scope.span` instead) * `SentryDebugMeta.uuid` (use `debugID` instead) * `SentryDebugMeta.name` (use `codeFile` instead) We made the following classes and APIs private: * `SentryEventDecoder` and `SentryEventDecodable` * `SentryEnvelopeItemHeader` * `SentryIntegrationProtocol` * `SentrySession` * `SentrySDKInfo` * `SentryDebugImageProvider` ### [Other Breaking Changes](https://docs.sentry.io/platforms/apple/guides/tvos/migration/v8-to-v9.md#other-breaking-changes) * We made the following classes `final`: `PreviewRedactOptions`, `SentryProfileOptions`, `SentryRedactViewHelper`, `SentryViewScreenshotOptions`, `SentryReplayOptions`, `SentryUserFeedbackConfiguration`, `SentryUserFeedbackFormConfiguration`, `SentryUserFeedbackThemeConfiguration`, `SentryUserFeedbackWidgetConfiguration`, `SentryFeedback`, and `SentryExperimentalOptions` For a complete list of changes, see the [Changelog of version 9.0.0](https://github.com/getsentry/sentry-cocoa/releases/tag/9.0.0)