feat: promote standalone app start out of experimental

CHANGELOG.md

@@ -4,6 +4,7 @@
 
 ### Features
 
+- Promote `enableStandaloneAppStartTracing` from `options.experimental` to a top-level option on `Options` (#8715)
 - Add experimental option `enableUIViewControllerInitSwizzling` that defers `UIViewController` swizzling to first instantiation instead of eagerly discovering and swizzling all subclasses at SDK start. This avoids realizing `@available`-gated `UIViewController` subclasses on OS versions below their gate, which crashes apps on start (#8687).
 
 ### Fixes

Samples/SentrySampleShared/SentrySampleShared/SentrySDKWrapper.swift

@@ -201,7 +201,7 @@
         options.enableUserInteractionTracing = !isBenchmarking && !SentrySDKOverrides.UIEventTracking.disableTracing.boolValue
 
         options.enablePreWarmedAppStartTracing = !isBenchmarking && !SentrySDKOverrides.AppStart.disablePrewarmedTracing.boolValue
-        options.experimental.enableStandaloneAppStartTracing = SentrySDKOverrides.AppStart.enableStandaloneTracing.boolValue
+        options.enableStandaloneAppStartTracing = SentrySDKOverrides.AppStart.enableStandaloneTracing.boolValue
         options.enableUIViewControllerTracing = !SentrySDKOverrides.UIViewControllerTracing.disable.boolValue
         options.experimental.enableUIViewControllerInitSwizzling = SentrySDKOverrides.UIViewControllerTracing.enableInitSwizzling.boolValue
 
@@ -410,27 +410,27 @@
     var layoutOffset: UIOffset { UIOffset(horizontal: 25, vertical: 75) }
 
     func configureFeedbackWidget(config: SentryUserFeedbackWidgetConfiguration) {
         config.autoInject = false
         config.layoutUIOffset = layoutOffset
 
         guard !SentrySDKOverrides.Feedback.allDefaults.boolValue else { return }
 
         if Locale.current.languageCode == "ar" { // arabic
             config.labelText = "﷽"
         } else if Locale.current.languageCode == "ur" { // urdu
             config.labelText = "نستعلیق"
         } else if Locale.current.languageCode == "he" { // hebrew
             config.labelText = "עִבְרִית‎"
         } else if Locale.current.languageCode == "hi" { // Hindi
             config.labelText = "नागरि"
         } else {
             config.labelText = "Report Jank"
         }
 
         if SentrySDKOverrides.Feedback.noWidgetText.boolValue {
             config.labelText = nil
         }
         config.showIcon = !SentrySDKOverrides.Feedback.noWidgetIcon.boolValue
     }
 
     func configureFeedbackForm(config: SentryUserFeedbackFormConfiguration) {
@@ -481,7 +481,7 @@
         guard !args.contains(SentrySDKOverrides.Feedback.allDefaults.rawValue) else {
 #if !SDK_V10
             if shouldConfigureDeprecatedWidget {
                 config.configureWidget = configureFeedbackWidget(config:)
             }
 #endif // !SDK_V10
             configureHooks(config: config)
@@ -493,7 +493,7 @@
         config.showFormForScreenshots = !SentrySDKOverrides.Feedback.noScreenshots.boolValue
 #if !SDK_V10
         if shouldConfigureDeprecatedWidget {
             config.configureWidget = configureFeedbackWidget(config:)
         }
 #endif // !SDK_V10
         config.configureForm = configureFeedbackForm(config:)
@@ -502,7 +502,7 @@
 
 #if !SDK_V10
         if SentrySDKOverrides.Feedback.useCustomFeedbackButton.boolValue {
             config.customButton = feedbackButton
         }
 #endif // !SDK_V10
     }

Sources/SentryObjC/Public/SentryObjCOptions.h

@@ -572,6 +572,13 @@ NS_ASSUME_NONNULL_BEGIN
  */
 @property (nonatomic) BOOL enablePreWarmedAppStartTracing;
 
+/**
+ * When enabled, the SDK sends a standalone app start transaction instead of attaching app
+ * start data to the first UIViewController transaction.
+ * @note Default value is @c NO.
+ */
+@property (nonatomic) BOOL enableStandaloneAppStartTracing;
+
 /**
  * When enabled, the SDK reports non-fully-blocking app hangs. A non-fully-blocking app hang is
  * when the app appears stuck to the user but can still render a few frames.

Sources/SentryObjCCompat/SentryObjCOptions.swift

@@ -344,6 +344,11 @@ import Foundation
         set { wrapped.enablePreWarmedAppStartTracing = newValue }
     }
 
+    @objc public var enableStandaloneAppStartTracing: Bool {
+        get { wrapped.enableStandaloneAppStartTracing }
+        set { wrapped.enableStandaloneAppStartTracing = newValue }
+    }
+
     @objc public var enableReportNonFullyBlockingAppHangs: Bool {
         get { wrapped.enableReportNonFullyBlockingAppHangs }
         set { wrapped.enableReportNonFullyBlockingAppHangs = newValue }

Sources/Swift/Helper/SentryEnabledFeaturesBuilder.swift

@@ -52,7 +52,7 @@
         if options.enableMetrics {
             features.append("metrics")
         }
-        if options.experimental.enableStandaloneAppStartTracing {
+        if options.enableStandaloneAppStartTracing {
             features.append("standaloneAppStartTracing")
         }
         if options.experimental.enableWatchdogTerminationsV2 {

Sources/Swift/Helper/SentrySDK.swift

@@ -582,7 +582,7 @@ extension SentrySDK {
     /// func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
     ///     SentrySDK.start(configureOptions: { options in
     ///         ...
-    ///         options.experimental.enableStandaloneAppStartTracing = true
+    ///         options.enableStandaloneAppStartTracing = true
     ///     })
     ///     SentrySDK.extendAppStart()
     ///

Sources/Swift/Options.swift

@@ -345,6 +345,12 @@
     /// @note Default value is @c true.
     @objc public var enablePreWarmedAppStartTracing: Bool = true
 
+    /// When enabled, the SDK sends a standalone app start transaction instead of attaching app
+    /// start data to the first UIViewController transaction.
+    ///
+    /// @note Default value is @c false.
+    @objc public var enableStandaloneAppStartTracing: Bool = false
+
     /// When enabled the SDK reports non-fully-blocking app hangs. A non-fully-blocking app hang is when
     /// the app appears stuck to the user but can still render a few frames.
     ///

Sources/Swift/SentryDependencyContainer.swift

@@ -324,7 +324,7 @@ extension SentryFileManager: SentryFileManagerProtocol { }
             appStateManager: appStateManager,
             framesTracker: framesTracker,
             enablePreWarmedAppStartTracing: options.enablePreWarmedAppStartTracing,
-            enableStandaloneAppStartTracing: options.experimental.enableStandaloneAppStartTracing,
+            enableStandaloneAppStartTracing: options.enableStandaloneAppStartTracing,
             dateProvider: dateProvider,
             sysctlWrapper: sysctlWrapper,
             appStartInfoProvider: appStartInfoProvider,

Sources/Swift/SentryExperimentalOptions.swift

@@ -16,12 +16,6 @@ public final class SentryExperimentalOptions: NSObject {
     /// When enabled, the SDK uses a more efficient mechanism for detecting watchdog terminations.
     public var enableWatchdogTerminationsV2 = false
 
-    /**
-     * When enabled, the SDK sends a standalone app start transaction instead of attaching app
-     * start data to the first UIViewController transaction.
-     */
-    public var enableStandaloneAppStartTracing = false
-
     /**
      * Reduces SDK start overhead by swizzling each `UIViewController` subclass lazily, the first
      * time an instance of it is created, instead of eagerly discovering and swizzling every

Tests/SentryTests/Helper/SentryEnabledFeaturesBuilderTests.swift

@@ -308,7 +308,7 @@ final class SentryEnabledFeaturesBuilderTests: XCTestCase {
     func testEnableStandaloneAppStartTracing_isEnabled_shouldAddFeature() throws {
         // -- Arrange --
         let options = Options()
-        options.experimental.enableStandaloneAppStartTracing = true
+        options.enableStandaloneAppStartTracing = true
 
         // -- Act --
         let features = SentryEnabledFeaturesBuilder.getEnabledFeatures(options: options)
@@ -320,7 +320,7 @@ final class SentryEnabledFeaturesBuilderTests: XCTestCase {
     func testEnableStandaloneAppStartTracing_isDisabled_shouldNotAddFeature() throws {
         // -- Arrange --
         let options = Options()
-        options.experimental.enableStandaloneAppStartTracing = false
+        options.enableStandaloneAppStartTracing = false
 
         // -- Act --
         let features = SentryEnabledFeaturesBuilder.getEnabledFeatures(options: options)

sdk_api.json

@@ -24380,6 +24380,82 @@
             "printedName": "enableSpotlight",
             "usr": "c:@M@Sentry@objc(cs)SentryOptions(py)enableSpotlight"
           },
+          {
+            "accessors": [
+              {
+                "accessorKind": "get",
+                "children": [
+                  {
+                    "kind": "TypeNominal",
+                    "name": "Bool",
+                    "printedName": "Swift.Bool",
+                    "usr": "s:Sb"
+                  }
+                ],
+                "declAttributes": [
+                  "Final",
+                  "ObjC"
+                ],
+                "declKind": "Accessor",
+                "implicit": true,
+                "kind": "Accessor",
+                "mangledName": "$s6Sentry7OptionsC31enableStandaloneAppStartTracingSbvg",
+                "moduleName": "Sentry",
+                "name": "Get",
+                "printedName": "Get()",
+                "usr": "c:@M@Sentry@objc(cs)SentryOptions(im)enableStandaloneAppStartTracing"
+              },
+              {
+                "accessorKind": "set",
+                "children": [
+                  {
+                    "kind": "TypeNominal",
+                    "name": "Bool",
+                    "printedName": "Swift.Bool",
+                    "usr": "s:Sb"
+                  },
+                  {
+                    "kind": "TypeNominal",
+                    "name": "Void",
+                    "printedName": "()"
+                  }
+                ],
+                "declAttributes": [
+                  "Final",
+                  "ObjC"
+                ],
+                "declKind": "Accessor",
+                "implicit": true,
+                "kind": "Accessor",
+                "mangledName": "$s6Sentry7OptionsC31enableStandaloneAppStartTracingSbvs",
+                "moduleName": "Sentry",
+                "name": "Set",
+                "printedName": "Set()",
+                "usr": "c:@M@Sentry@objc(cs)SentryOptions(im)setEnableStandaloneAppStartTracing:"
+              }
+            ],
+            "children": [
+              {
+                "kind": "TypeNominal",
+                "name": "Bool",
+                "printedName": "Swift.Bool",
+                "usr": "s:Sb"
+              }
+            ],
+            "declAttributes": [
+              "Final",
+              "HasStorage",
+              "ObjC"
+            ],
+            "declKind": "Var",
+            "hasStorage": true,
+            "kind": "Var",
+            "mangledName": "$s6Sentry7OptionsC31enableStandaloneAppStartTracingSbvp",
+            "moduleName": "Sentry",
+            "name": "enableStandaloneAppStartTracing",
+            "printedName": "enableStandaloneAppStartTracing",
+            "usr": "c:@M@Sentry@objc(cs)SentryOptions(py)enableStandaloneAppStartTracing"
+          },
           {
             "accessors": [
               {
@@ -38652,82 +38728,6 @@
             "printedName": "init()",
             "usr": "c:@M@Sentry@objc(cs)SentryExperimentalOptions(im)init"
           },
-          {
-            "accessors": [
-              {
-                "accessorKind": "get",
-                "children": [
-                  {
-                    "kind": "TypeNominal",
-                    "name": "Bool",
-                    "printedName": "Swift.Bool",
-                    "usr": "s:Sb"
-                  }
-                ],
-                "declAttributes": [
-                  "Final",
-                  "ObjC"
-                ],
-                "declKind": "Accessor",
-                "implicit": true,
-                "kind": "Accessor",
-                "mangledName": "$s6Sentry0A19ExperimentalOptionsC31enableStandaloneAppStartTracingSbvg",
-                "moduleName": "Sentry",
-                "name": "Get",
-                "printedName": "Get()",
-                "usr": "c:@M@Sentry@objc(cs)SentryExperimentalOptions(im)enableStandaloneAppStartTracing"
-              },
-              {
-                "accessorKind": "set",
-                "children": [
-                  {
-                    "kind": "TypeNominal",
-                    "name": "Bool",
-                    "printedName": "Swift.Bool",
-                    "usr": "s:Sb"
-                  },
-                  {
-                    "kind": "TypeNominal",
-                    "name": "Void",
-                    "printedName": "()"
-                  }
-                ],
-                "declAttributes": [
-                  "Final",
-                  "ObjC"
-                ],
-                "declKind": "Accessor",
-                "implicit": true,
-                "kind": "Accessor",
-                "mangledName": "$s6Sentry0A19ExperimentalOptionsC31enableStandaloneAppStartTracingSbvs",
-                "moduleName": "Sentry",
-                "name": "Set",
-                "printedName": "Set()",
-                "usr": "c:@M@Sentry@objc(cs)SentryExperimentalOptions(im)setEnableStandaloneAppStartTracing:"
-              }
-            ],
-            "children": [
-              {
-                "kind": "TypeNominal",
-                "name": "Bool",
-                "printedName": "Swift.Bool",
-                "usr": "s:Sb"
-              }
-            ],
-            "declAttributes": [
-              "Final",
-              "HasStorage",
-              "ObjC"
-            ],
-            "declKind": "Var",
-            "hasStorage": true,
-            "kind": "Var",
-            "mangledName": "$s6Sentry0A19ExperimentalOptionsC31enableStandaloneAppStartTracingSbvp",
-            "moduleName": "Sentry",
-            "name": "enableStandaloneAppStartTracing",
-            "printedName": "enableStandaloneAppStartTracing",
-            "usr": "c:@M@Sentry@objc(cs)SentryExperimentalOptions(py)enableStandaloneAppStartTracing"
-          },
           {
             "accessors": [
               {

sdk_api_objc.json

@@ -2075,6 +2075,13 @@
     "returnType": "BOOL",
     "instance": true
   },
+  {
+    "kind": "ObjCMethodDecl",
+    "name": "enableStandaloneAppStartTracing",
+    "parent": "SentryObjCOptions",
+    "returnType": "BOOL",
+    "instance": true
+  },
   {
     "kind": "ObjCMethodDecl",
     "name": "enableSwizzling",
@@ -5876,6 +5883,13 @@
     "returnType": "void",
     "instance": true
   },
+  {
+    "kind": "ObjCMethodDecl",
+    "name": "setEnableStandaloneAppStartTracing:",
+    "parent": "SentryObjCOptions",
+    "returnType": "void",
+    "instance": true
+  },
   {
     "kind": "ObjCMethodDecl",
     "name": "setEnableSwizzling:",
@@ -9128,6 +9142,12 @@
     "parent": "SentryObjCOptions",
     "type": "BOOL"
   },
+  {
+    "kind": "ObjCPropertyDecl",
+    "name": "enableStandaloneAppStartTracing",
+    "parent": "SentryObjCOptions",
+    "type": "BOOL"
+  },
   {
     "kind": "ObjCPropertyDecl",
     "name": "enableSwizzling",

sdk_api_objc_v10.json

@@ -2162,6 +2162,13 @@
     "returnType": "BOOL",
     "instance": true
   },
+  {
+    "kind": "ObjCMethodDecl",
+    "name": "enableStandaloneAppStartTracing",
+    "parent": "SentryObjCOptions",
+    "returnType": "BOOL",
+    "instance": true
+  },
   {
     "kind": "ObjCMethodDecl",
     "name": "enableSwizzling",
@@ -6026,6 +6033,13 @@
     "returnType": "void",
     "instance": true
   },
+  {
+    "kind": "ObjCMethodDecl",
+    "name": "setEnableStandaloneAppStartTracing:",
+    "parent": "SentryObjCOptions",
+    "returnType": "void",
+    "instance": true
+  },
   {
     "kind": "ObjCMethodDecl",
     "name": "setEnableSwizzling:",
@@ -9320,6 +9334,12 @@
     "parent": "SentryObjCOptions",
     "type": "BOOL"
   },
+  {
+    "kind": "ObjCPropertyDecl",
+    "name": "enableStandaloneAppStartTracing",
+    "parent": "SentryObjCOptions",
+    "type": "BOOL"
+  },
   {
     "kind": "ObjCPropertyDecl",
     "name": "enableSwizzling",