Skip to content

Commit 7f3d69f

Browse files
philprimeclaude
andauthored
docs(apple): Add missing experimental options and remove experimental-features page (#17987)
## DESCRIBE YOUR PR Add missing `<SdkOption>` entries for `experimental.enableUnhandledCPPExceptionsV2` and `experimental.enableWatchdogTerminationsV2` to the Apple SDK options reference. Remove the standalone `experimental-features.mdx` page since all its content is now covered in `options.mdx` or on the pages it linked to (some of which were broken links to features removed in SDK 9.0.0). - Add `experimental.enableUnhandledCPPExceptionsV2` option to `options.mdx` - Add `experimental.enableWatchdogTerminationsV2` option to `options.mdx` - Delete `docs/platforms/apple/common/features/experimental-features.mdx` - Remove references to the deleted page from features index pages (common, macOS, visionOS) ## IS YOUR CHANGE URGENT? - [ ] Urgent deadline (GA date, etc.): - [ ] Other deadline: - [x] None: Not urgent, can wait up to 1 week+ ## SLA - Teamwork makes the dream work, so please add a reviewer to your PRs. - Please give the docs team up to 1 week to review your PR unless you've added an urgent due date to it. Thanks in advance for your help! ## PRE-MERGE CHECKLIST - [x] Checked Vercel preview for correctness, including links - [ ] PR was reviewed and approved by any necessary SMEs (subject matter experts) - [ ] PR was reviewed and approved by a member of the [Sentry docs team](https://github.com/orgs/getsentry/teams/docs) --------- Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>
1 parent 82845c4 commit 7f3d69f

6 files changed

Lines changed: 16 additions & 72 deletions

File tree

docs/platforms/apple/common/configuration/options.mdx

Lines changed: 15 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1096,8 +1096,6 @@ This feature is only available from Xcode 13 and from macOS 12.0, iOS 15.0, tvOS
10961096

10971097
This is an experimental feature and may still have bugs. When enabled, the SDK stitches the call to Swift Async functions in one consecutive stack trace.
10981098

1099-
Learn more in the <PlatformLink to="/features/experimental-features/">Experimental Features</PlatformLink> documentation.
1100-
11011099
</SdkOption>
11021100

11031101
<SdkOption name="cacheDirectoryPath" type="string">
@@ -1190,6 +1188,21 @@ Learn more in the <PlatformLink to="/tracing/instrumentation/automatic-instrumen
11901188

11911189
</SdkOption>
11921190

1191+
<SdkOption name="experimental.enableUnhandledCPPExceptionsV2" type="bool" defaultValue="false">
1192+
1193+
When enabled, the SDK captures fatal C++ exceptions using a more reliable mechanism that hooks into all `__cxa_throw` calls. This provides more comprehensive and consistent exception handling across your app's runtime, regardless of the number of C++ modules or how they're linked.
1194+
1195+
**Note:** The mechanism of hooking into `__cxa_throw` could cause issues with symbolication on iOS due to caching of symbol references.
1196+
1197+
1198+
</SdkOption>
1199+
1200+
<SdkOption name="experimental.enableWatchdogTerminationsV2" type="bool" defaultValue="false">
1201+
1202+
When enabled, the SDK uses a more efficient mechanism for detecting watchdog terminations.
1203+
1204+
1205+
</SdkOption>
11931206

11941207
<SdkOption name="experimental.enableMetrics" type="bool" defaultValue="true" availableSince="9.4.0" removedSince="9.12.0">
11951208

docs/platforms/apple/common/features/experimental-features.mdx

Lines changed: 0 additions & 57 deletions
This file was deleted.

docs/platforms/apple/common/features/index.mdx

Lines changed: 0 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -83,10 +83,6 @@ All features listed below are **enabled by default** unless otherwise noted. Som
8383
- Offline caching when a device is unable to connect; we send a report once we receive another event
8484
- Event persistence: crash reports persist to disk and are sent upon application start if not sent immediately after a crash
8585

86-
## Experimental Features
87-
88-
For information about experimental features, see the <PlatformLink to="/features/experimental-features">Experimental Features</PlatformLink> page.
89-
9086
## Platform-Specific Documentation
9187

9288
For platform-specific feature details and limitations, see:

docs/platforms/apple/guides/macos/features/index.mdx

Lines changed: 0 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -90,10 +90,6 @@ For macOS apps using UIKit (Mac Catalyst), the following features are also avail
9090
- <PlatformLink to="/logs">Logs capturing</PlatformLink> available (requires `enableLogs` option)
9191
- Offline caching when a device is unable to connect; we send a report once we receive another event
9292

93-
## Experimental Features
94-
95-
For information about experimental features available on macOS, see the <PlatformLink to="/features/experimental-features">Experimental Features</PlatformLink> page.
96-
9793
## macOS Limitations
9894

9995
macOS has some limitations compared to iOS:

docs/platforms/apple/guides/visionos/features/index.mdx

Lines changed: 0 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -69,8 +69,4 @@ visionOS supports comprehensive error detection:
6969
- <PlatformLink to="/logs">Logs capturing</PlatformLink> available (requires `enableLogs` option)
7070
- <PlatformLink to="/user-feedback">User Feedback</PlatformLink> via programmatic API (no UI available)
7171

72-
## Experimental Features
73-
74-
For information about experimental features that may be available on visionOS, see the <PlatformLink to="/features/experimental-features">Experimental Features</PlatformLink> page.
75-
7672
For configuration options and detailed documentation, see the <PlatformLink to="/configuration">Configuration</PlatformLink> section.

public/_platforms/apple/ios.json

Lines changed: 1 addition & 1 deletion
Large diffs are not rendered by default.

0 commit comments

Comments
 (0)