feat: add Nintendo Switch 2 support

CHANGELOG.md

@@ -6,6 +6,10 @@
 
 - The `EnableMetrics` option is now marked as `[Obsolete]` and no longer has any effect, following the .NET SDK where metrics are always enabled. Disable the individual `Auto*Metrics` options instead, or filter emitted metrics with `SetBeforeSendMetric`. ([#2828](https://github.com/getsentry/sentry-unity/pull/2828))
 
+### Features
+
+- Added Nintendo Switch 2 support. The SDK now recognises the platform, links the Switch 2 build of the native library from `Assets/Plugins/Sentry/Switch2/`, and uploads its debug symbols. Switch 2 shares the existing `SwitchNativeSupportEnabled` option ([#2834](https://github.com/getsentry/sentry-unity/pull/2834))
+
 ### Fixes
 
 - IL2CPP line numbers now work on Android x86/x86_64 builds. il2cpp fails to report the image UUID there, so the SDK falls back to looking the debug image up by name ([#2817](https://github.com/getsentry/sentry-unity/pull/2817))

package-dev/Runtime/SentryInitialization.cs

@@ -16,7 +16,7 @@
 #define SENTRY_NATIVE
 #endif
 
-#if UNITY_SWITCH
+#if UNITY_SWITCH || UNITY_SWITCH2
 #define SENTRY_NATIVE_SWITCH
 #endif
 

package-dev/Runtime/io.sentry.unity.dev.runtime.asmdef

@@ -9,6 +9,7 @@
         "LinuxStandalone64",
         "macOSStandalone",
         "Switch",
+        "Switch2",
         "PS5",
         "WSA",
         "WebGL",

package/Runtime/io.sentry.unity.runtime.asmdef

@@ -12,6 +12,7 @@
         "macOSStandalone",
         "PS5",
         "Switch",
+        "Switch2",
         "WSA",
         "WebGL",
         "WindowsStandalone32",

src/Sentry.Unity.Editor/ConfigurationWindow/AdvancedTab.cs

@@ -176,7 +176,7 @@ internal static void Display(ScriptableSentryUnityOptions options, SentryCliOpti
                 options.PlayStationNativeSupportEnabled);
 
             options.SwitchNativeSupportEnabled = EditorGUILayout.Toggle(
-                new GUIContent("Nintendo Switch", "Whether to enable native scope sync support on Nintendo Switch."),
+                new GUIContent("Nintendo Switch", "Whether to enable native scope sync support on Nintendo Switch and Switch 2."),
                 options.SwitchNativeSupportEnabled);
         }
 

src/Sentry.Unity.Editor/Native/SwitchNativePluginBuildPreProcess.cs

@@ -1,3 +1,4 @@
+using System;
 using System.IO;
 using System.Linq;
 using Sentry.Extensibility;
@@ -21,32 +22,51 @@ namespace Sentry.Unity.Editor.Native;
 /// </remarks>
 internal class SwitchNativePluginBuildPreProcess : IPreprocessBuildWithReport
 {
-    private static readonly string[] RequiredFiles =
+    private static bool IsSwitchFamily(BuildTarget target) =>
+        target == BuildTarget.Switch || IsSwitch2(target);
+
+    /// <summary>
+    /// <c>BuildTarget.Switch2</c> only exists in Unity 6000.3 and newer.
+    /// </summary>
+    private static bool IsSwitch2(BuildTarget target) =>
+        string.Equals(target.ToString(), "Switch2", StringComparison.Ordinal);
+
+    /// <summary>
+    /// Both platforms share one stub, so the required libraries are what differ between them.
+    /// </summary>
+    private static string[] RequiredFilesFor(string targetDirectory)
     {
-        "Assets/Plugins/Sentry/Switch/libsentry.a",
-        "Assets/Plugins/Sentry/Switch/libzstd.a",
-    };
+        return
+        [
+            $"Assets/Plugins/Sentry/{targetDirectory}/libsentry.a",
+            $"Assets/Plugins/Sentry/{targetDirectory}/libzstd.a"
+        ];
+    }
 
     public int callbackOrder => -100;
 
     public void OnPreprocessBuild(BuildReport report)
     {
-        if (report.summary.platform != BuildTarget.Switch)
+        if (!IsSwitchFamily(report.summary.platform))
         {
             return;
         }
 
         var options = SentryScriptableObject.LoadOptions(isBuilding: true);
         var logger = options?.DiagnosticLogger ?? new UnityLogger(new SentryUnityOptions());
 
-        ConfigureStub(logger, options?.SwitchNativeSupportEnabled ?? false);
+        ConfigureStub(logger, options?.SwitchNativeSupportEnabled ?? false, report.summary.platform);
     }
 
-    internal static void ConfigureStub(IDiagnosticLogger logger, bool nativeSupportEnabled)
+    internal static void ConfigureStub(IDiagnosticLogger logger, bool nativeSupportEnabled, BuildTarget target)
     {
-        logger.LogDebug("Switch native support: checking for required files:\n{0}",
-            string.Join("\n", RequiredFiles.Select(f => $"  - {f}")));
+        var requiredFiles = RequiredFilesFor(nameof(target));
+
+        logger.LogDebug("{0} native support: checking for required files:\n{1}",
+            target, string.Join("\n", requiredFiles.Select(f => $"  - {f}")));
 
+        // One stub serves both platforms; the importer tracks compatibility per build target, so
+        // enabling it for one does not affect the other.
         var stubPath = Path.Combine("Packages", SentryPackageInfo.GetName(), "Plugins", "Switch", "sentry_native_stubs.c");
 
         var importer = AssetImporter.GetAtPath(stubPath) as PluginImporter;
@@ -56,45 +76,45 @@ internal static void ConfigureStub(IDiagnosticLogger logger, bool nativeSupportE
             return;
         }
 
-        var existingFiles = RequiredFiles.Where(File.Exists).ToList();
-        var missingFiles = RequiredFiles.Except(existingFiles).ToList();
+        var existingFiles = requiredFiles.Where(File.Exists).ToList();
+        var missingFiles = requiredFiles.Except(existingFiles).ToList();
 
         var someFilesPresent = existingFiles.Count > 0 && missingFiles.Count > 0;
         if (someFilesPresent)
         {
-            logger.LogError(
-                "Switch native support is partially configured. Missing files:\n{0}\n" +
+            logger.LogWarning(
+                "{0} native support is partially configured. Missing files:\n{1}\n" +
                 "Please add all required files to enable native support, or remove all files to fall back on no-op stubs.\n" +
                 "Build sentry-switch and copy the libraries to the expected locations. " +
                 "See: https://github.com/getsentry/sentry-switch",
-                string.Join("\n", missingFiles.Select(f => $"  - {f}"))
+                target, string.Join("\n", missingFiles.Select(f => $"  - {f}"))
             );
             return;
         }
 
         var allFilesPresent = missingFiles.Count == 0;
         if (allFilesPresent)
         {
-            logger.LogInfo("Switch native libraries found:\n{0}",
-                string.Join("\n", existingFiles.Select(f => $"  - {f}")));
-            importer.SetCompatibleWithPlatform(BuildTarget.Switch, false);
+            logger.LogInfo("{0} native libraries found:\n{1}",
+                target, string.Join("\n", existingFiles.Select(f => $"  - {f}")));
+            importer.SetCompatibleWithPlatform(target, false);
         }
         else
         {
             if (nativeSupportEnabled)
             {
                 logger.LogWarning(
-                    "Switch native support is enabled but required files are missing:\n{0}\n" +
+                    "{0} native support is enabled but required files are missing:\n{1}\n" +
                     "Build sentry-switch and copy the libraries to the expected locations. " +
                     "See: https://github.com/getsentry/sentry-switch",
-                    string.Join("\n", missingFiles.Select(f => $"  - {f}"))
+                    target, string.Join("\n", missingFiles.Select(f => $"  - {f}"))
                 );
             }
             else
             {
-                logger.LogDebug("Switch native support is disabled. Enabling stubs (native calls will be no-op).");
+                logger.LogDebug("{0} native support is disabled. Enabling stubs (native calls will be no-op).", target);
             }
-            importer.SetCompatibleWithPlatform(BuildTarget.Switch, true);
+            importer.SetCompatibleWithPlatform(target, true);
         }
 
         importer.SaveAndReimport();

src/Sentry.Unity/SentryUnityOptionsExtensions.cs

@@ -49,6 +49,12 @@ internal static bool IsValid(this SentryUnityOptions options)
         return true;
     }
 
+    /// <summary>
+    /// <c>RuntimePlatform.Switch2</c> was only added in Unity 6000.3.
+    /// </summary>
+    internal static bool IsSwitch2(this RuntimePlatform platform) =>
+        string.Equals(platform.ToString(), "Switch2", StringComparison.Ordinal);
+
     internal static bool IsNativeSupportEnabled(this SentryUnityOptions options, RuntimePlatform? platform = null)
     {
         platform ??= ApplicationAdapter.Instance.Platform;
@@ -62,6 +68,8 @@ internal static bool IsNativeSupportEnabled(this SentryUnityOptions options, Run
             RuntimePlatform.GameCoreXboxSeries or RuntimePlatform.GameCoreXboxOne => options.XboxNativeSupportEnabled,
             RuntimePlatform.PS5 => options.PlayStationNativeSupportEnabled,
             RuntimePlatform.Switch => options.SwitchNativeSupportEnabled,
+            // Switch 2 reuses the Switch native support.
+            _ when platform.Value.IsSwitch2() => options.SwitchNativeSupportEnabled,
             _ => false
         };
     }

test/Sentry.Unity.Tests/SentryUnityOptionsExtensionsTests.cs

@@ -1,3 +1,4 @@
+using System;
 using System.Linq;
 using NUnit.Framework;
 using Sentry.Unity.Tests.Stubs;
@@ -207,4 +208,33 @@ public void IsNativeSupportEnabled_ConsolePlatforms_ReturnsExpectedValue(
 
         Assert.AreEqual(expectedResult, result);
     }
+
+    /// <summary>
+    /// Switch 2 shares the Switch option. It is resolved by name because
+    /// <c>RuntimePlatform.Switch2</c> does not exist on the Unity versions the SDK still supports,
+    /// so this parses the member instead of referencing it and skips where it is unavailable.
+    /// </summary>
+    [Test]
+    [TestCase(true, true)]
+    [TestCase(false, false)]
+    public void IsNativeSupportEnabled_Switch2_FollowsSwitchOption(bool optionEnabled, bool expectedResult)
+    {
+        if (!Enum.TryParse<RuntimePlatform>("Switch2", out var switch2))
+        {
+            Assert.Ignore("This Unity version predates 'RuntimePlatform.Switch2'.");
+        }
+
+        var options = _fixture.GetSut();
+        options.SwitchNativeSupportEnabled = optionEnabled;
+
+        Assert.AreEqual(expectedResult, options.IsNativeSupportEnabled(switch2));
+    }
+
+    [Test]
+    public void IsSwitch2_OtherPlatforms_ReturnsFalse()
+    {
+        Assert.IsFalse(RuntimePlatform.Switch.IsSwitch2());
+        Assert.IsFalse(RuntimePlatform.PS5.IsSwitch2());
+        Assert.IsFalse(RuntimePlatform.WindowsPlayer.IsSwitch2());
+    }
 }