Add iOS experimental EnableAppHangTrackingV2 binding (#3877)

* Add experimental EnableAppHangTrackingV2 configuration flag to the dotnet SDK

* Update CHANGELOG.md

* reformatted BindableSentryOptions

* Apply suggestions from code review

---------

Co-authored-by: Bruno Garcia <[email protected]>

Author: thisisthekap

CHANGELOG.md

@@ -2,6 +2,10 @@
 
 ## 5.0.1
 
+### Features
+
+- .NET on iOS: Add experimental EnableAppHangTrackingV2 configuration flag to the options binding SDK ([#3877](https://github.com/getsentry/sentry-dotnet/pull/3877))
+
 ### Fixes
 
 - .NET Mobile: Disable and made obsolete the iOS Watchdog termination feature which is based on heuristics that don't work in .NET ([#3867](https://github.com/getsentry/sentry-dotnet/pull/3867))

src/Sentry/Platforms/Cocoa/BindableSentryOptions.cs

@@ -14,6 +14,7 @@ public class NativeOptions
         public TimeSpan? AppHangTimeoutInterval { get; set; }
         public TimeSpan? IdleTimeout { get; set; }
         public bool? EnableAppHangTracking { get; set; }
+        public bool? EnableAppHangTrackingV2 { get; set; }
         public bool? EnableAutoBreadcrumbTracking { get; set; }
         public bool? EnableAutoPerformanceTracing { get; set; }
         public bool? EnableCoreDataTracing { get; set; }
@@ -32,6 +33,7 @@ public void ApplyTo(SentryOptions.NativeOptions options)
             options.AppHangTimeoutInterval = AppHangTimeoutInterval ?? options.AppHangTimeoutInterval;
             options.IdleTimeout = IdleTimeout ?? options.IdleTimeout;
             options.EnableAppHangTracking = EnableAppHangTracking ?? options.EnableAppHangTracking;
+            options.EnableAppHangTrackingV2 = EnableAppHangTrackingV2 ?? options.EnableAppHangTrackingV2;
             options.EnableAutoBreadcrumbTracking = EnableAutoBreadcrumbTracking ?? options.EnableAutoBreadcrumbTracking;
             options.EnableAutoPerformanceTracing = EnableAutoPerformanceTracing ?? options.EnableAutoPerformanceTracing;
             options.EnableCoreDataTracing = EnableCoreDataTracing ?? options.EnableCoreDataTracing;

src/Sentry/Platforms/Cocoa/SentryOptions.cs

@@ -68,6 +68,23 @@ internal NativeOptions(SentryOptions options)
         /// </remarks>
         public bool EnableAppHangTracking { get; set; } = true;
 
+        /// <summary>
+        /// IMPORTANT: This feature is experimental and may have bugs.
+        /// <br/>
+        /// 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
+        /// app hangs, which you might choose to ignore. A fully-blocking app hang is when the main thread is stuck
+        /// completely, and the app can't render a single frame.
+        /// A non-fully-blocking app hang is when the app appears stuck to the user, but can still render a few frames.
+        /// Fully-blocking app hangs are more actionable because the stacktrace shows the exact blocking location on
+        /// the main thread. Non-fully-blocking app hangs can have a stacktrace that doesn't highlight the exact
+        /// blocking location, since the main thread isn't completely blocked.
+        /// </summary>
+        /// <remarks>
+        /// See https://docs.sentry.io/platforms/apple/configuration/app-hangs/#app-hangs-v2
+        /// </remarks>
+        public bool EnableAppHangTrackingV2 { get; set; } = true;
+
         /// <summary>
         /// When enabled, the SDK adds breadcrumbs for various system events.
         /// The default value is <c>true</c> (enabled).

src/Sentry/Platforms/Cocoa/SentrySdk.cs

@@ -121,6 +121,7 @@ private static void InitSentryCocoaSdk(SentryOptions options)
         nativeOptions.IdleTimeout = options.Native.IdleTimeout.TotalSeconds;
         nativeOptions.Dist = options.Distribution;
         nativeOptions.EnableAppHangTracking = options.Native.EnableAppHangTracking;
+        nativeOptions.EnableAppHangTrackingV2 = options.Native.EnableAppHangTrackingV2;
         nativeOptions.EnableAutoBreadcrumbTracking = options.Native.EnableAutoBreadcrumbTracking;
         nativeOptions.EnableAutoPerformanceTracing = options.Native.EnableAutoPerformanceTracing;
         nativeOptions.EnableCoreDataTracing = options.Native.EnableCoreDataTracing;