8.57.1

Warning

Session Replay is disabled by default on iOS 26.0+ with Xcode 26.0+ to prevent PII leaks

Due to potential masking issues introduced by Apple's Liquid Glass rendering changes in iOS 26.0, Session Replay is now automatically disabled on apps running iOS 26.0+ when built with Xcode 26.0 or later. This is a defensive measure to protect user privacy and prevent potential PII leaks until masking is reliably supported.

Session replay will work normally if:

• Your app runs on iOS versions older than 26.0, OR
• Your app is built with Xcode versions older than 26.0, OR
• Your app explicitly sets UIDesignRequiresCompatibility to YES in Info.plist

Override (use with caution): If you understand the PII risks and want to enable session replay anyway, you can set:

options.experimental.enableSessionReplayInUnreliableEnvironment = true

This experimental override option will be removed in a future minor version once the masking issues are resolved.

Fixes

• Fix crash from accessing UITouch instances from background thread in SentryTouchTracker (#6584)
• Disable SessionSentryReplayIntegration if the environment is unsafe [#6573]
• Fix crash when last replay info is missing some keys [#6577]

8.57.0

Warning

Session Replay is disabled by default on iOS 26.0+ with Xcode 26.0+ to prevent PII leaks

Due to potential masking issues introduced by Apple's Liquid Glass rendering changes in iOS 26.0, Session Replay is now automatically disabled on apps running iOS 26.0+ when built with Xcode 26.0 or later. This is a defensive measure to protect user privacy and prevent potential PII leaks until masking is reliably supported.

Session replay will work normally if:

• Your app runs on iOS versions older than 26.0, OR
• Your app is built with Xcode versions older than 26.0, OR
• Your app explicitly sets UIDesignRequiresCompatibility to YES in Info.plist

Override (use with caution): If you understand the PII risks and want to enable session replay anyway, you can set:

options.experimental.enableSessionReplayInUnreliableEnvironment = true

This experimental override option will be removed in a future minor version once the masking issues are resolved.

Fixes

• Fix wrong Frame Delay when becoming active, which lead to false reported app hangs when the app moves to the foreground after being in the background (#6393)
• Session replay is now automatically disabled in environments with unreliable masking to prevent PII leaks (#6389)
  • Detects iOS 26.0+ runtime with Xcode 26.0+ builds (DTXcode >= 2600)
  • Detects missing or disabled UIDesignRequiresCompatibility
  • Uses defensive approach: assumes unsafe unless proven safe
• Add options.experimental.enableSessionReplayInUnreliableEnvironment to allow overriding the automatic disabling (#6389)

8.56.2

Warning

Session Replay in this version does not correctly mask views when built with Xcode 26 and running on iOS 26 with Liquid Glass, which may lead to PII leaks. Please upgrade to 8.57.0 or later, which automatically disables session replay in such environments.

Fixes

• Fix crash from null UIApplication in SwiftUI apps (#6264)

8.56.1

Warning

This version can cause runtime crashes because the UIApplication.sharedApplication/NSApplication.sharedApplication is not yet available during SDK initialization, due to the changes in PR #5900, released in 8.56.0.

Warning

Session Replay in this version does not correctly mask views when built with Xcode 26 and running on iOS 26 with Liquid Glass, which may lead to PII leaks. Please upgrade to 8.57.0 or later, which automatically disables session replay in such environments.

Fixes

• Fix potential app launch hang caused by the SentrySDK (#6181)
  Fixed by removing the call to _dyld_get_image_header on the main thread.
• Fix dynamic selector crash in SentryReplayRecording (#6211)

8.56.0

Warning

This version can cause runtime crashes because the UIApplication.sharedApplication/NSApplication.sharedApplication is not yet available during SDK initialization, due to the changes in PR #5900, released in 8.56.0.

Warning

Session Replay in this version does not correctly mask views when built with Xcode 26 and running on iOS 26 with Liquid Glass, which may lead to PII leaks. Please upgrade to 8.57.0 or later, which automatically disables session replay in such environments.

Features

• Structured Logs: Flush logs on SDK flush/close (#5834)
• Add masking options for screenshots (#5401)
• Add significant time change breadcrumb (#6112)
• Add support for iOS 26, macOS 26, visionOS 26, watchOS 26, and tvOS 26 in device tests (#6063)

Improvements

• Lazily CharacterSet only once in SentryBaggageSerialization (#5871)
• Structured Logging: Log SentrySDK.logger calls to SentrySDKLog (#5991)
• The build type in the app context now differentiates between enterprise and adhoc (#6044)
• visionOS no longer needs swift's interoperability mode (#6077)
• Ensure IP address is only inferred by Relay if sendDefaultPii is true (#5877)
• Sentry without UIKit / AppKit is available to install with SPM (#6160)

Fixes

• Don't capture replays for events dropped in beforeSend (#5916)
• Fix linking with SentrySwiftUI on Xcode 26 for visionOS (#5823)
• Structured Logging: Logger called before SentrySDK.start becomes unusable (#5984)
• Add masking for AVPlayerView (#5910)
• Fix missing view hierachy when enabling attachScreenshot too (#5989)
• Fix macOS's frameworks not following the versioned framework structure (#6049)
• Add warning to addBreadcrumb when used before SDK init (#6083)
• Add null-handling for parsed DSN in SentryHTTPTransport (#5800)
• Fix crash in Session Replay when opening the camera UI on iOS 26+ by skipping redaction of internal views.
  This may result in more of the camera screen being redacted. (#6045)
• Fix crash in SentryDependencyContainer init when using the SDK as a static framework (#6125)
• Fixes a React Native legacy build failure by adding the missing self references for explicit capture semantics (#6156)

8.56.0-alpha.3

Features

• Structured Logs: Flush logs on SDK flush/close (#5834)
• Add masking options for screenshots (#5401)
• Add significant time change breadcrumb (#6112)
• Add support for iOS 26, macOS 26, visionOS 26, watchOS 26, and tvOS 26 in device tests (#6063)

Fixes

• Don't capture replays for events dropped in beforeSend (#5916)
• Fix linking with SentrySwiftUI on Xcode 26 for visionOS (#5823)
• Structured Logging: Logger called before SentrySDK.start becomes unusable (#5984)
• Add masking for AVPlayerView (#5910)
• Fix missing view hierachy when enabling attachScreenshot too (#5989)
• Fix macOS's frameworks not following the versioned framework structure (#6049)
• Add warning to addBreadcrumb when used before SDK init (#6083)
• Add null-handling for parsed DSN in SentryHTTPTransport (#5800)
• Fix crash in Session Replay when opening the camera UI on iOS 26+ by skipping redaction of internal views.
  This may result in more of the camera screen being redacted. (#6045)
• Fix crash in SentryDependencyContainer init when using the SDK as a static framework (#6125)
• Fixes a React Native legacy build failure by adding the missing self references for explicit capture semantics (#6156)

Improvements

• Lazily CharacterSet only once in SentryBaggageSerialization (#5871)
• Structured Logging: Log SentrySDK.logger calls to SentrySDKLog (#5991)
• The build type in the app context now differentiates between enterprise and adhoc (#6044)
• visionOS no longer needs swift's interoperability mode (#6077)
• Ensure IP address is only inferred by Relay if sendDefaultPii is true (#5877)

8.56.0-alpha.2

Features

• Structured Logs: Flush logs on SDK flush/close (#5834)
• Add masking options for screenshots (#5401)
• Add significant time change breadcrumb (#6112)
• Add support for iOS 26, macOS 26, visionOS 26, watchOS 26, and tvOS 26 in device tests (#6063)

Fixes

• Don't capture replays for events dropped in beforeSend (#5916)
• Fix linking with SentrySwiftUI on Xcode 26 for visionOS (#5823)
• Structured Logging: Logger called before SentrySDK.start becomes unusable (#5984)
• Add masking for AVPlayerView (#5910)
• Fix missing view hierachy when enabling attachScreenshot too (#5989)
• Fix macOS's frameworks not following the versioned framework structure (#6049)
• Add warning to addBreadcrumb when used before SDK init (#6083)
• Add null-handling for parsed DSN in SentryHTTPTransport (#5800)
• Fix crash in Session Replay when opening the camera UI on iOS 26+ by skipping redaction of internal views.
  This may result in more of the camera screen being redacted. (#6045)
• Fix crash in SentryDependencyContainer init when using the SDK as a static framework (#6125)

Improvements

• Lazily CharacterSet only once in SentryBaggageSerialization (#5871)
• Structured Logging: Log SentrySDK.logger calls to SentrySDKLog (#5991)
• The build type in the app context now differentiates between enterprise and adhoc (#6044)
• visionOS no longer needs swift's interoperability mode (#6077)
• Ensure IP address is only inferred by Relay if sendDefaultPii is true (#5877)

8.56.0-alpha.1

Features

• Structured Logs: Flush logs on SDK flush/close (#5834)
• Add masking options for screenshots (#5401)

Fixes

• Don't capture replays for events dropped in beforeSend (#5916)
• Fix linking with SentrySwiftUI on Xcode 26 for visionOS (#5823)
• Structured Logging: Logger called before SentrySDK.start becomes unusable (#5984)
• Add masking for AVPlayerView (#5910)
• Fix missing view hierachy when enabling attachScreenshot too (#5989)
• Fix macOS's frameworks not following the versioned framework structure (#6049)
• Add warning to addBreadcrumb when used before SDK init (#6083)
• Add null-handling for parsed DSN in SentryHTTPTransport (#5800)

Improvements

• Lazily CharacterSet only once in SentryBaggageSerialization (#5871)
• Structured Logging: Log SentrySDK.logger calls to SentrySDKLog (#5991)
• The build type in the app context now differentiates between enterprise and adhoc (#6044)
• visionOS no longer needs swift's interoperability mode (#6077)
• Ensure IP address is only inferred by Relay if sendDefaultPii is true (#5877)

8.56.0-alpha.0

Features

• Structured Logs: Flush logs on SDK flush/close (#5834)
• Add masking options for screenshots (#5401)

Fixes

• Don't capture replays for events dropped in beforeSend (#5916)
• Fix linking with SentrySwiftUI on Xcode 26 for visionOS (#5823)
• Structured Logging: Logger called before SentrySDK.start becomes unusable (#5984)
• Add masking for AVPlayerView (#5910)
• Fix missing view hierachy when enabling attachScreenshot too (#5989)
• Fix macOS's frameworks not following the versioned framework structure (#6049)
• Add warning to addBreadcrumb when used before SDK init (#6083)
• Add null-handling for parsed DSN in SentryHTTPTransport (#5800)

Improvements

• Lazily CharacterSet only once in SentryBaggageSerialization (#5871)
• Structured Logging: Log SentrySDK.logger calls to SentrySDKLog (#5991)
• The build type in the app context now differentiates between enterprise and adhoc (#6044)
• visionOS no longer needs swift's interoperability mode (#6077)
• Ensure IP address is only inferred by Relay if sendDefaultPii is true (#5877)

8.55.1

Warning

Session Replay in this version does not correctly mask views when built with Xcode 26 and running on iOS 26 with Liquid Glass, which may lead to PII leaks. Please upgrade to 8.57.0 or later, which automatically disables session replay in such environments.

Fixes

• Fix macOS's frameworks not following the versioned framework structure (#6049)