Update bindings for Cocoa SDK v9 #4830

jpnurmi · 2026-01-07T12:05:41Z

Note

PrivatesHeader.h and PrivateSentrySDKOnly.h were moved from PrivateHeaders/ to Headers/
SentryOptions.enableAppHangTrackingV2 was removed: chore: Remove hang tracker sdk v9 checks sentry-cocoa#6334
SentryOptions.inAppExcludes was removed: fix: Remove property that had no effect sentry-cocoa#6646
PrivateSentrySDKOnly.getDebugImages was removed: ref: Remove v9 checks for debug image provider sentry-cocoa#6454

#skip-changelog (merges to #4781)

linear · 2026-01-07T12:05:45Z

COCOA-9 Don't symbolicate stacktrace during crash

codecov · 2026-01-07T12:21:34Z

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 73.80%. Comparing base (dc6c357) to head (f34b077).

Additional details and impacted files

@@                           Coverage Diff                            @@
##           deps/modules/sentry-cocoa.properties    #4830      +/-   ##
========================================================================
+ Coverage                                 73.76%   73.80%   +0.03%     
========================================================================
  Files                                       483      483              
  Lines                                     17551    17551              
  Branches                                   3461     3461              
========================================================================
+ Hits                                      12947    12954       +7     
+ Misses                                     3748     3745       -3     
+ Partials                                    856      852       -4

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

It has multiple conflicting NSNumber[] constructors for boolean, integer, and float arrays: error CS0111: Type 'SentryAttribute' already defines a member called 'Constructor' with the same parameter types

cursor

Cursor Bugbot has reviewed your changes and found 1 potential issue.

^{Bugbot Autofix is OFF. To automatically fix reported issues with Cloud Agents, enable Autofix in the Cursor dashboard.}

scripts/patch-cocoa-bindings.cs

jamescrosswell

Nice work - thanks @jpnurmi !

Flash0ver · 2026-01-23T18:26:29Z

modules/sentry-cocoa.properties

question:

close chore(deps): update Cocoa SDK to v9.2.0 #4781

This replaces the above auto-generated PR, right?

Flash0ver · 2026-01-23T18:31:15Z

scripts/patch-cocoa-bindings.cs

    .WithAttribute("SentryBeforeSendEventCallback", "return: NullAllowed")
    .WithAttribute("SentryTracesSamplerCallback", "return: NullAllowed")
+    // Fix nullable return attributes
+    .RemoveAttribute("PrivateSentrySDKOnly", "Capture*", "NullAllowed")


question:

Should we be explicitly removing the NullAllowed attribute for CaptureScreenshots and CaptureViewHierarchy, since we are adding [return: NullAllowed] on both of these methods below? Or are there more?

I am wondering if we could accidentally miss some new Capture* methods in the future.

Flash0ver · 2026-01-23T18:59:19Z

src/Sentry/Platforms/Cocoa/SentryOptions.cs

        public bool EnableAppHangTracking { get; set; } = false;

        /// <summary>
        /// IMPORTANT: This feature is experimental and may have bugs.


suggestion: change phrasing

-/// IMPORTANT: This feature is experimental and may have bugs. +/// IMPORTANT: App Hangs V2 is now the default.

(didn't do a GitHub suggestion, as the result looked incorrect)

Flash0ver · 2026-01-23T19:00:39Z

src/Sentry/Platforms/Cocoa/SentryOptions.cs

        /// As of version 8.39.0-beta.1 of the sentry-cocoa SDK, you can enable AppHangsV2, which is available on iOS and tvOS.
        /// The main difference is that AppHangsV2 differentiates between fully-blocking and non-fully-blocking


suggestion: add clarification

Add the updated text from: https://docs.sentry.io/platforms/apple/configuration/app-hangs/#app-hangs-v2

/// As of version 8.39.0-beta.1 of the sentry-cocoa SDK, you can enable AppHangsV2, which is available on iOS and tvOS. +/// Starting with version 9.0.0, App Hangs V2 is enabled by default. /// The main difference is that AppHangsV2 differentiates between fully-blocking and non-fully-blocking

(I didn't do a GitHub suggestion, as the result looked a bit weird in formatting)

Flash0ver · 2026-01-23T19:11:21Z

src/Sentry/Platforms/Cocoa/SentryOptions.cs

        /// See https://docs.sentry.io/platforms/apple/configuration/app-hangs/#app-hangs-v2
        /// </remarks>
+        [Obsolete("Use EnableAppHangTracking")]
        public bool EnableAppHangTrackingV2 { get; set; } = false;


question: forward to EnableAppHangTracking

Since has no effect anymore,
shall we "forward" it to EnableAppHangTracking?
Like

public bool EnableAppHangTrackingV2 { get => EnableAppHangTracking; set => EnableAppHangTracking = value; }

Or do we indeed want to make this option essentially no-op, since this option is now Obsolete.
In this case, I'd make the message more clear:

[Obsolete("This option has no effect. Use EnableAppHangTracking instead.")] //or maybe [Obsolete("App Hangs V2 is now the default. Use EnableAppHangTracking instead.")]

or something similar.

I'm a bit uncertain whether we should

make EnableAppHangTrackingV2 no-op

make EnableAppHangTrackingV2 an alias to EnableAppHangTracking

Considering that we are releasing the Cocoa SDK major version in a minor .NET SDK version,
what is the "least breaking" option?

Also considering all combinations/permutations, that the user might have:

options.EnableAppHangTracking = true|false: options.EnableAppHangTrackingV2 = true|false;

I'm quite uncertain, I'm afraid.

Flash0ver · 2026-01-23T19:13:14Z

src/Sentry/Platforms/Cocoa/SentryOptions.cs

        /// <remarks>
        /// See https://docs.sentry.io/platforms/apple/configuration/app-hangs/
        /// </remarks>
        public bool EnableAppHangTracking { get; set; } = false;


question: default to true?

See https://docs.sentry.io/platforms/apple/configuration/app-hangs/:

Starting with version 8.0.0, this feature has been enabled by default.

But also considering, that we are releasing this changeset as a minor version,
perhaps we do not want to change the default yet,
but instead open an issue to align the default with our v7 end of the year.

Or ... to we want to keep this default to false in general?

Flash0ver · 2026-01-23T19:16:44Z

src/Sentry/Platforms/Cocoa/BindableSentryOptions.cs

            options.IdleTimeout = IdleTimeout ?? options.IdleTimeout;
            options.EnableAppHangTracking = EnableAppHangTracking ?? options.EnableAppHangTracking;
+#pragma warning disable CS0618 // Type or member is obsolete
            options.EnableAppHangTrackingV2 = EnableAppHangTrackingV2 ?? options.EnableAppHangTrackingV2;


question: obsolete

Should we mark this option (BindableSentryOptions.EnableAppHangTrackingV2) also as obsolete?
Or is that not necessary as this type is internal, and we won't "forget" to remove it for our next major.

Flash0ver · 2026-01-23T19:21:54Z

src/Sentry/Platforms/Cocoa/SentryOptions.cs

        /// <remarks>
        /// See https://docs.sentry.io/platforms/apple/configuration/app-hangs/#app-hangs-v2
        /// </remarks>
+        [Obsolete("Use EnableAppHangTracking")]


question: v7?

Do we plan to remove this option for our next major - v7 - in November 2026?
Shall we create an issue already, and mark it for "Major v7" in Linear?

bruno-garcia force-pushed the deps/modules/sentry-cocoa.properties branch 2 times, most recently from 509f0c9 to fe091a7 Compare January 15, 2026 03:29

bruno-garcia force-pushed the deps/modules/sentry-cocoa.properties branch 2 times, most recently from 76b917d to 1c85ec4 Compare January 21, 2026 03:29

chore: update modules/sentry-cocoa.properties to 9.2.0

dc6c357

bruno-garcia force-pushed the deps/modules/sentry-cocoa.properties branch from 1c85ec4 to dc6c357 Compare January 22, 2026 03:30

Update bindings for Cocoa SDK v9

c460bad

jpnurmi force-pushed the deps/sentry-cocoa-9 branch from c56e53c to dd04bd0 Compare January 22, 2026 07:42

Adapt to 9.2.0 changes

cf215b1

jpnurmi force-pushed the deps/sentry-cocoa-9 branch from dd04bd0 to cf215b1 Compare January 22, 2026 08:06

Remove problematic SentryAttribute (not sure if needed?)

6ff0514

It has multiple conflicting NSNumber[] constructors for boolean, integer, and float arrays: error CS0111: Type 'SentryAttribute' already defines a member called 'Constructor' with the same parameter types

jpnurmi changed the title ~~WIP: Update bindings for Cocoa SDK v9~~ Update bindings for Cocoa SDK v9 Jan 22, 2026

jpnurmi marked this pull request as ready for review January 22, 2026 12:48

jpnurmi requested review from Flash0ver and jamescrosswell as code owners January 22, 2026 12:48

cursor bot reviewed Jan 22, 2026

View reviewed changes

scripts/patch-cocoa-bindings.cs Outdated Show resolved Hide resolved

Fix typo

f34b077

jamescrosswell approved these changes Jan 22, 2026

View reviewed changes

bruno-garcia force-pushed the deps/modules/sentry-cocoa.properties branch from dc6c357 to f4ed890 Compare January 23, 2026 03:29

Flash0ver reviewed Jan 23, 2026

View reviewed changes

bruno-garcia force-pushed the deps/modules/sentry-cocoa.properties branch from f4ed890 to 117130f Compare January 24, 2026 03:28

		/// As of version 8.39.0-beta.1 of the sentry-cocoa SDK, you can enable AppHangsV2, which is available on iOS and tvOS.
		/// The main difference is that AppHangsV2 differentiates between fully-blocking and non-fully-blocking

Uh oh!

Update bindings for Cocoa SDK v9 #4830

Are you sure you want to change the base?

Update bindings for Cocoa SDK v9 #4830

Uh oh!

Conversation

jpnurmi commented Jan 7, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

linear bot commented Jan 7, 2026

Uh oh!

codecov bot commented Jan 7, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Codecov Report

Uh oh!

cursor bot left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

jamescrosswell left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

5 participants

jpnurmi commented Jan 7, 2026 •

edited

Loading

codecov bot commented Jan 7, 2026 •

edited

Loading