feat(profiling): Skip legacy app-start profiling when useProfilingManager is set

When useProfilingManager is true, SentryPerformanceProvider now skips
creating the legacy Debug-based profiler at app start. This ensures
AndroidOptionsInitializer creates a Perfetto profiler instead, without
needing special handover logic between the two profiling engines.

The useProfilingManager flag is persisted in SentryAppStartProfilingOptions
(written at end of Sentry.init(), read on next app launch) so the
decision is available before SDK initialization.

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

squash into options commit

Author: 43jay

sentry-android-core/src/main/java/io/sentry/android/core/ManifestMetadataReader.java

@@ -497,8 +497,7 @@ static void applyMetadata(
                 metadata, logger, ENABLE_APP_START_PROFILING, options.isEnableAppStartProfiling()));
 
         options.setUseProfilingManager(
-            readBool(
-                metadata, logger, USE_PROFILING_MANAGER, options.isUseProfilingManager()));
+            readBool(metadata, logger, USE_PROFILING_MANAGER, options.isUseProfilingManager()));
 
         options.setEnableScopePersistence(
             readBool(

sentry-android-core/src/main/java/io/sentry/android/core/SentryPerformanceProvider.java

@@ -129,6 +129,14 @@ private void launchAppStartProfiler(final @NotNull AppStartMetrics appStartMetri
         return;
       }
 
+      if (profilingOptions.isUseProfilingManager()) {
+        logger.log(
+            SentryLevel.DEBUG,
+            "useProfilingManager is enabled. Skipping legacy app-start profiling — "
+                + "ProfilingManager will be initialized after Sentry.init().");
+        return;
+      }
+
       if (profilingOptions.isContinuousProfilingEnabled()
           && profilingOptions.isStartProfilerOnAppStart()) {
         createAndStartContinuousProfiler(context, profilingOptions, appStartMetrics);
@@ -163,7 +171,7 @@ private void createAndStartContinuousProfiler(
 
     final @NotNull SentryExecutorService startupExecutorService = new SentryExecutorService();
     final @NotNull IContinuousProfiler appStartContinuousProfiler =
-        new AndroidContinuousProfiler(
+        AndroidContinuousProfiler.createLegacy(
             buildInfoProvider,
             new SentryFrameMetricsCollector(
                 context.getApplicationContext(), logger, buildInfoProvider),

sentry/src/main/java/io/sentry/SentryAppStartProfilingOptions.java

@@ -24,6 +24,7 @@ public final class SentryAppStartProfilingOptions implements JsonUnknown, JsonSe
   boolean continuousProfileSampled;
   boolean isEnableAppStartProfiling;
   boolean isStartProfilerOnAppStart;
+  boolean useProfilingManager;
   @NotNull ProfileLifecycle profileLifecycle;
 
   private @Nullable Map<String, Object> unknown;
@@ -42,6 +43,7 @@ public SentryAppStartProfilingOptions() {
     profilingTracesHz = 0;
     isEnableAppStartProfiling = true;
     isStartProfilerOnAppStart = false;
+    useProfilingManager = false;
   }
 
   SentryAppStartProfilingOptions(
@@ -62,6 +64,7 @@ public SentryAppStartProfilingOptions() {
     profilingTracesHz = options.getProfilingTracesHz();
     isEnableAppStartProfiling = options.isEnableAppStartProfiling();
     isStartProfilerOnAppStart = options.isStartProfilerOnAppStart();
+    useProfilingManager = options.isUseProfilingManager();
   }
 
   public void setProfileSampled(final boolean profileSampled) {
@@ -160,6 +163,14 @@ public boolean isStartProfilerOnAppStart() {
     return isStartProfilerOnAppStart;
   }
 
+  public void setUseProfilingManager(final boolean useProfilingManager) {
+    this.useProfilingManager = useProfilingManager;
+  }
+
+  public boolean isUseProfilingManager() {
+    return useProfilingManager;
+  }
+
   // JsonSerializable
 
   public static final class JsonKeys {
@@ -175,6 +186,7 @@ public static final class JsonKeys {
     public static final String PROFILING_TRACES_HZ = "profiling_traces_hz";
     public static final String IS_ENABLE_APP_START_PROFILING = "is_enable_app_start_profiling";
     public static final String IS_START_PROFILER_ON_APP_START = "is_start_profiler_on_app_start";
+    public static final String USE_PROFILING_MANAGER = "use_profiling_manager";
   }
 
   @Override
@@ -195,6 +207,7 @@ public void serialize(final @NotNull ObjectWriter writer, final @NotNull ILogger
     writer.name(JsonKeys.PROFILING_TRACES_HZ).value(logger, profilingTracesHz);
     writer.name(JsonKeys.IS_ENABLE_APP_START_PROFILING).value(logger, isEnableAppStartProfiling);
     writer.name(JsonKeys.IS_START_PROFILER_ON_APP_START).value(logger, isStartProfilerOnAppStart);
+    writer.name(JsonKeys.USE_PROFILING_MANAGER).value(logger, useProfilingManager);
 
     if (unknown != null) {
       for (String key : unknown.keySet()) {
@@ -308,6 +321,12 @@ public static final class Deserializer
               options.isStartProfilerOnAppStart = isStartProfilerOnAppStart;
             }
             break;
+          case JsonKeys.USE_PROFILING_MANAGER:
+            @Nullable Boolean useProfilingManager = reader.nextBooleanOrNull();
+            if (useProfilingManager != null) {
+              options.useProfilingManager = useProfilingManager;
+            }
+            break;
           default:
             if (unknown == null) {
               unknown = new ConcurrentHashMap<>();