(1) ref(tracing): extract app start to a standalone integration

CHANGELOG.md

@@ -2,6 +2,27 @@
 
 ## Unreleased
 
+### Changes
+
+- New App Start Integration ([#3852](https://github.com/getsentry/sentry-react-native/pull/3852))
+
+  By default app start spans are attached to the first created transaction.
+  Standalone mode creates single root span (transaction) including only app start data.
+
+  ```js
+  import Sentry from '@sentry/react-native';
+
+  Sentry.init({
+    tracesSampleRate: 1.0,
+    enableAppStartTracking: true, // default true
+    integrations: [
+      Sentry.appStartIntegration({
+        standalone: false, // default false
+      }),
+    ],
+  });
+  ```
+
 ### Fixes
 
 - Pass `sampleRate` option to the Android SDK ([#3979](https://github.com/getsentry/sentry-react-native/pull/3979))

samples/react-native/src/App.tsx

@@ -88,6 +88,9 @@ Sentry.init({
         maskAllVectors: true,
         // maskAllText: false,
       }),
+      Sentry.appStartIntegration({
+        standalone: false,
+      }),
     );
     return integrations.filter(i => i.name !== 'Dedupe');
   },

src/js/integrations/default.ts

@@ -6,6 +6,7 @@ import type { ReactNativeClientOptions } from '../options';
 import { ReactNativeTracing } from '../tracing';
 import { isExpoGo, notWeb } from '../utils/environment';
 import {
+  appStartIntegration,
   breadcrumbsIntegration,
   browserApiErrorsIntegration,
   browserGlobalHandlersIntegration,
@@ -100,6 +101,9 @@ export function getDefaultIntegrations(options: ReactNativeClientOptions): Integ
   if (hasTracingEnabled && options.enableAutoPerformanceTracing) {
     integrations.push(new ReactNativeTracing());
   }
+  if (hasTracingEnabled && options.enableAppStartTracking) {
+    integrations.push(appStartIntegration());
+  }
   if (options.enableCaptureFailedRequests) {
     integrations.push(httpClientIntegration());
   }

src/js/integrations/exports.ts

@@ -13,6 +13,7 @@ export { viewHierarchyIntegration } from './viewhierarchy';
 export { expoContextIntegration } from './expocontext';
 export { spotlightIntegration } from './spotlight';
 export { mobileReplayIntegration } from '../replay/mobilereplay';
+export { appStartIntegration } from '../tracing/integrations/appStart';
 
 export {
   breadcrumbsIntegration,

src/js/options.ts

@@ -188,6 +188,16 @@ export interface BaseReactNativeOptions {
    */
   beforeScreenshot?: (event: Event, hint: EventHint) => boolean;
 
+  /**
+   * Track the app start time by adding measurements to the first route transaction. If there is no routing instrumentation
+   * an app start transaction will be started.
+   *
+   * Requires performance monitoring to be enabled.
+   *
+   * Default: true
+   */
+  enableAppStartTracking?: boolean;
+
   /**
    * Options which are in beta, or otherwise not guaranteed to be stable.
    */

src/js/sdk.tsx

@@ -14,7 +14,6 @@ import type { ReactNativeClientOptions, ReactNativeOptions, ReactNativeWrapperOp
 import { shouldEnableNativeNagger } from './options';
 import { enableSyncToNative } from './scopeSync';
 import { TouchEventBoundary } from './touchevents';
-import type { ReactNativeTracing } from './tracing';
 import { ReactNativeProfiler } from './tracing';
 import { useEncodePolyfill } from './transports/encodePolyfill';
 import { DEFAULT_BUFFER_SIZE, makeNativeTransportFactory } from './transports/native';
@@ -34,6 +33,7 @@ const DEFAULT_OPTIONS: ReactNativeOptions = {
   attachStacktrace: true,
   enableCaptureFailedRequests: false,
   enableNdk: true,
+  enableAppStartTracking: true,
 };
 
 /**
@@ -112,11 +112,6 @@ export function wrap<P extends Record<string, unknown>>(
   RootComponent: React.ComponentType<P>,
   options?: ReactNativeWrapperOptions
 ): React.ComponentType<P> {
-  const tracingIntegration = getClient()?.getIntegrationByName?.('ReactNativeTracing') as ReactNativeTracing | undefined;
-  if (tracingIntegration) {
-    tracingIntegration.useAppStartWithProfiler = true;
-  }
-
   const profilerProps = {
     ...(options?.profilerProps ?? {}),
     name: RootComponent.displayName ?? 'Root',