fix: fall back SignalHandlerStrategy.ChainAtStart on incompatible .NET runtimes

Add a runtime version check that falls back to Default on .NET 10.0.0–10.0.3,
which crash with ChainAtStart due to dotnet/runtime#123346. Also fix swapped
runtime/SDK version numbers in XML docs.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: jpnurmi

src/Sentry/Platforms/Android/NativeOptions.cs

@@ -160,10 +160,11 @@ internal NativeOptions(SentryOptions options)
         /// The default value is <c>SignalHandlerStrategy.Default</c> (enabled).
         /// </summary>
         /// <remarks>
-        /// When set to <see cref="Android.SignalHandlerStrategy.ChainAtStart"/>, .NET runtimes
-        /// 10.0.100–10.0.301 shipped in .NET SDKs 10.0.0–10.0.3 will crash. The issue was fixed in
-        /// <see href="https://github.com/dotnet/runtime/pull/123346">dotnet/runtime#123346</see>,
-        /// which shipped as .NET runtime 10.0.400 in .NET SDK 10.0.4.
+        /// .NET runtimes 10.0.0–10.0.3 (.NET SDKs 10.0.100–10.0.301) are not compatible with
+        /// <see cref="Android.SignalHandlerStrategy.ChainAtStart"/>. On affected versions, the
+        /// SDK automatically falls back to <see cref="Android.SignalHandlerStrategy.Default"/>.
+        /// The issue was resolved in .NET runtime 10.0.4 (.NET SDK 10.0.400). See
+        /// <see href="https://github.com/dotnet/runtime/pull/123346">dotnet/runtime#123346</see>.
         /// </remarks>
         public SignalHandlerStrategy SignalHandlerStrategy { get; set; } = SignalHandlerStrategy.Default;
 

src/Sentry/Platforms/Android/SentrySdk.cs

@@ -64,7 +64,17 @@ private static void InitSentryAndroidSdk(SentryOptions options)
             o.ServerName = options.ServerName;
             o.SessionTrackingIntervalMillis = (long)options.AutoSessionTrackingInterval.TotalMilliseconds;
             o.ShutdownTimeoutMillis = (long)options.ShutdownTimeout.TotalMilliseconds;
-            o.SetNativeHandlerStrategy(options.Native.SignalHandlerStrategy switch
+            var signalHandlerStrategy = options.Native.SignalHandlerStrategy;
+            if (signalHandlerStrategy == SignalHandlerStrategy.ChainAtStart
+                && System.Environment.Version is { Major: 10, Minor: 0, Build: < 4 })
+            {
+                options.LogWarning(
+                    "SignalHandlerStrategy.ChainAtStart is not compatible with .NET runtime {0}. " +
+                    "Falling back to SignalHandlerStrategy.Default. Update to .NET runtime 10.0.4 or later.",
+                    System.Environment.Version);
+                signalHandlerStrategy = SignalHandlerStrategy.Default;
+            }
+            o.SetNativeHandlerStrategy(signalHandlerStrategy switch
             {
                 SignalHandlerStrategy.ChainAtStart => NdkHandlerStrategy.SentryHandlerStrategyChainAtStart,
                 _ => NdkHandlerStrategy.SentryHandlerStrategyDefault

src/Sentry/Platforms/Android/SignalHandlerStrategy.cs

@@ -16,10 +16,11 @@ public enum SignalHandlerStrategy
     /// signal handler.
     /// </summary>
     /// <remarks>
-    /// .NET runtimes 10.0.100–10.0.301 shipped in .NET SDKs 10.0.0–10.0.3 crash when used
-    /// with this option. The issue was fixed in
-    /// <see href="https://github.com/dotnet/runtime/pull/123346">dotnet/runtime#123346</see>,
-    /// which shipped as .NET runtime 10.0.400 in .NET SDK 10.0.4.
+    /// .NET runtimes 10.0.0–10.0.3 (.NET SDKs 10.0.100–10.0.301) are not compatible with
+    /// this strategy. On affected versions, the SDK automatically falls back to
+    /// <see cref="Default"/>. The issue was resolved in .NET runtime 10.0.4
+    /// (.NET SDK 10.0.400). See
+    /// <see href="https://github.com/dotnet/runtime/pull/123346">dotnet/runtime#123346</see>.
     /// </remarks>
     ChainAtStart
 }