feat: Support for programmatic option configuration

CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## Unreleased
+
+### Features
+
+- Support for programmatic options configuration ([#564](https://github.com/getsentry/sentry-unity/pull/564))
+
 ## 0.10.0
 
 ### Features

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

@@ -64,6 +64,19 @@ internal static void Display(ScriptableSentryUnityOptions options)
                 new GUIContent("Windows Native Support", "Whether to enable Native Windows support to " +
                                                          "capture errors written in languages such as C and C++."),
                 options.WindowsNativeSupportEnabled);
+
+            EditorGUILayout.Space();
+            EditorGUI.DrawRect(EditorGUILayout.GetControlRect(false, 1), Color.gray);
+            EditorGUILayout.Space();
+
+            GUILayout.Label("Programmatic Options Configuration", EditorStyles.boldLabel);
+
+            options.OptionsConfiguration = EditorGUILayout.ObjectField(
+                new GUIContent("Options Configuration", "A scriptable object that inherits from " +
+                                                        "'ScriptableOptionsConfiguration' that allows you to " +
+                                                        "programmatically modify Sentry options i.e. implement the " +
+                                                        "'BeforeSend' callback."),
+                    options.OptionsConfiguration, typeof(ScriptableOptionsConfiguration), false) as ScriptableOptionsConfiguration;
         }
     }
 }

src/Sentry.Unity.Editor/ScriptableSentryUnityOptionsEditor.cs

@@ -66,6 +66,17 @@ public override void OnInspectorGUI()
             EditorGUI.DrawRect(EditorGUILayout.GetControlRect(false, 1), Color.gray);
             EditorGUILayout.Space();
 
+            EditorGUILayout.ObjectField("Options Configuration", options.OptionsConfiguration,
+                typeof(ScriptableOptionsConfiguration), false);
+
+            EditorGUILayout.Space();
+            EditorGUI.DrawRect(EditorGUILayout.GetControlRect(false, 1), Color.gray);
+            EditorGUILayout.Space();
+
+            EditorGUILayout.Space();
+            EditorGUI.DrawRect(EditorGUILayout.GetControlRect(false, 1), Color.gray);
+            EditorGUILayout.Space();
+
             EditorGUILayout.LabelField("Debug", EditorStyles.boldLabel);
             EditorGUILayout.Toggle("Enable Debug Output", options.Debug);
             EditorGUILayout.Toggle("Only In Editor", options.DebugOnlyInEditor);

src/Sentry.Unity/ScriptableOptionsConfiguration.cs

@@ -0,0 +1,9 @@
+using UnityEngine;
+
+namespace Sentry.Unity
+{
+    public abstract class ScriptableOptionsConfiguration : ScriptableObject
+    {
+        public abstract void Configure(SentryUnityOptions options);
+    }
+}

src/Sentry.Unity/ScriptableSentryUnityOptions.cs

@@ -44,15 +44,20 @@ public static string GetConfigPath(string? notDefaultConfigName = null)
         [field: SerializeField] public bool IsEnvironmentUser { get; set; }
 
         [field: SerializeField] public bool EnableOfflineCaching { get; set; }
-        [field: SerializeField] public int MaxCacheItems { get; set; }
+
+        // At least 1 item must be allowed in the cache.
+        [field: SerializeField] public int MaxCacheItems { get; set; } = 1;
         [field: SerializeField] public int InitCacheFlushTimeout { get; set; }
         [field: SerializeField] public float? SampleRate { get; set; }
         [field: SerializeField] public int ShutdownTimeout { get; set; }
-        [field: SerializeField] public int MaxQueueItems { get; set; }
+        // At least 1 item must be allowed in the queue.
+        [field: SerializeField] public int MaxQueueItems { get; set; } = 1;
         [field: SerializeField] public bool IosNativeSupportEnabled { get; set; } = true;
         [field: SerializeField] public bool AndroidNativeSupportEnabled { get; set; } = true;
         [field: SerializeField] public bool WindowsNativeSupportEnabled { get; set; } = true;
 
+        [field: SerializeField] public ScriptableOptionsConfiguration? OptionsConfiguration { get; set; }
+
         [field: SerializeField] public bool Debug { get; set; }
         [field: SerializeField] public bool DebugOnlyInEditor { get; set; }
         [field: SerializeField] public SentryLevel DiagnosticLevel { get; set; }
@@ -125,6 +130,9 @@ internal static SentryUnityOptions ToSentryUnityOptions(ScriptableSentryUnityOpt
             options.DiagnosticLevel = scriptableOptions.DiagnosticLevel;
 
             SentryOptionsUtility.TryAttachLogger(options);
+
+            scriptableOptions.OptionsConfiguration?.Configure(options);
+
             return options;
         }
     }

test/Sentry.Unity.Editor.Tests/ScriptableSentryUnityOptionsTests.cs

@@ -40,6 +40,7 @@ public void ScriptableSentryUnityOptions_Creation_AllPropertiesPresent()
             StringAssert.Contains("IosNativeSupportEnabled", optionsAsString);
             StringAssert.Contains("AndroidNativeSupportEnabled", optionsAsString);
             StringAssert.Contains("WindowsNativeSupportEnabled", optionsAsString);
+            StringAssert.Contains("OptionsConfiguration", optionsAsString);
             StringAssert.Contains("Debug", optionsAsString);
             StringAssert.Contains("DebugOnlyInEditor", optionsAsString);
             StringAssert.Contains("DiagnosticLevel", optionsAsString);

test/Sentry.Unity.Tests/ScriptableSentryUnityOptions.cs

@@ -2,6 +2,7 @@
 using System.IO;
 using System.Reflection;
 using NUnit.Framework;
+using Sentry.Extensibility;
 using Sentry.Unity.Json;
 using Sentry.Unity.Tests.Stubs;
 using UnityEngine;
@@ -21,6 +22,15 @@ class Fixture
                 persistentDataPath: "test/persistent/data/path");
         }
 
+        class TestOptionsConfiguration : ScriptableOptionsConfiguration
+        {
+            public bool GotCalled;
+            public override void Configure(SentryUnityOptions options)
+            {
+                GotCalled = true;
+            }
+        }
+
         [SetUp]
         public void Setup() => _fixture = new Fixture();
         private Fixture _fixture = null!;
@@ -118,6 +128,20 @@ public void ToSentryUnityOptions_ValueMapping_AreEqual(bool isBuilding, bool ena
             AssertOptions(expectedOptions, optionsActual);
         }
 
+        [Test]
+        [TestCase(true)]
+        [TestCase(false)]
+        public void ToSentryUnityOptions_HasOptionsConfiguration_GetsCalled(bool isBuilding)
+        {
+            var optionsConfiguration = ScriptableObject.CreateInstance<TestOptionsConfiguration>();
+            var scriptableOptions = ScriptableObject.CreateInstance<ScriptableSentryUnityOptions>();
+            scriptableOptions.OptionsConfiguration = optionsConfiguration;
+
+            ScriptableSentryUnityOptions.ToSentryUnityOptions(scriptableOptions, isBuilding);
+
+            Assert.IsTrue(optionsConfiguration.GotCalled);
+        }
+
         [Test]
         [TestCase(true)]
         [TestCase(false)]