feat(profiling): Add useProfilingManager option

Adds a new boolean option `useProfilingManager` that gates whether
the SDK uses Android's ProfilingManager API (API 35+) for Perfetto-based
profiling. On devices below API 35 where ProfilingManager is not
available, no profiling data is collected — the legacy Debug-based
profiler is not used as a fallback.

Wired through SentryOptions and ManifestMetadataReader (AndroidManifest
meta-data). Defaults to false (opt-in).

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

Author: 43jay

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

@@ -108,6 +108,8 @@ final class ManifestMetadataReader {
 
   static final String ENABLE_APP_START_PROFILING = "io.sentry.profiling.enable-app-start";
 
+  static final String USE_PROFILING_MANAGER = "io.sentry.profiling.use-profiling-manager";
+
   static final String ENABLE_SCOPE_PERSISTENCE = "io.sentry.enable-scope-persistence";
 
   static final String REPLAYS_SESSION_SAMPLE_RATE = "io.sentry.session-replay.session-sample-rate";
@@ -494,6 +496,10 @@ static void applyMetadata(
             readBool(
                 metadata, logger, ENABLE_APP_START_PROFILING, options.isEnableAppStartProfiling()));
 
+        options.setUseProfilingManager(
+            readBool(
+                metadata, logger, USE_PROFILING_MANAGER, options.isUseProfilingManager()));
+
         options.setEnableScopePersistence(
             readBool(
                 metadata, logger, ENABLE_SCOPE_PERSISTENCE, options.isEnableScopePersistence()));

sentry-android-core/src/test/java/io/sentry/android/core/ManifestMetadataReaderTest.kt

@@ -1469,6 +1469,31 @@ class ManifestMetadataReaderTest {
     assertFalse(fixture.options.isEnableAppStartProfiling)
   }
 
+  @Test
+  fun `applyMetadata reads useProfilingManager flag to options`() {
+    // Arrange
+    val bundle = bundleOf(ManifestMetadataReader.USE_PROFILING_MANAGER to true)
+    val context = fixture.getContext(metaData = bundle)
+
+    // Act
+    ManifestMetadataReader.applyMetadata(context, fixture.options, fixture.buildInfoProvider)
+
+    // Assert
+    assertTrue(fixture.options.isUseProfilingManager)
+  }
+
+  @Test
+  fun `applyMetadata reads useProfilingManager flag to options and keeps default if not found`() {
+    // Arrange
+    val context = fixture.getContext()
+
+    // Act
+    ManifestMetadataReader.applyMetadata(context, fixture.options, fixture.buildInfoProvider)
+
+    // Assert
+    assertFalse(fixture.options.isUseProfilingManager)
+  }
+
   @Test
   fun `applyMetadata reads enableScopePersistence flag to options`() {
     // Arrange

sentry/api/sentry.api

@@ -3688,6 +3688,7 @@ public class io/sentry/SentryOptions {
 	public fun isTraceOptionsRequests ()Z
 	public fun isTraceSampling ()Z
 	public fun isTracingEnabled ()Z
+	public fun isUseProfilingManager ()Z
 	public fun merge (Lio/sentry/ExternalOptions;)V
 	public fun setAttachServerName (Z)V
 	public fun setAttachStacktrace (Z)V
@@ -3809,6 +3810,7 @@ public class io/sentry/SentryOptions {
 	public fun setTransactionProfiler (Lio/sentry/ITransactionProfiler;)V
 	public fun setTransportFactory (Lio/sentry/ITransportFactory;)V
 	public fun setTransportGate (Lio/sentry/transport/ITransportGate;)V
+	public fun setUseProfilingManager (Z)V
 	public fun setVersionDetector (Lio/sentry/IVersionDetector;)V
 	public fun setViewHierarchyExporters (Ljava/util/List;)V
 }

sentry/src/main/java/io/sentry/SentryOptions.java

@@ -622,6 +622,13 @@ public class SentryOptions {
    */
   private boolean startProfilerOnAppStart = false;
 
+  /**
+   * When true, the SDK uses Android's {@code ProfilingManager} (Perfetto-based stack sampling) on
+   * API 35+ devices. On older devices where ProfilingManager is not available, no profiling data is
+   * collected — the legacy {@code Debug}-based profiler is not used as a fallback.
+   */
+  private boolean useProfilingManager = false;
+
   /**
    * Controls the deadline timeout in milliseconds for automatic transactions. When set to a
    * positive value, that value is used as the deadline timeout. When set to a value less than or
@@ -2213,6 +2220,25 @@ public void setStartProfilerOnAppStart(final boolean startProfilerOnAppStart) {
     this.startProfilerOnAppStart = startProfilerOnAppStart;
   }
 
+  /**
+   * Whether to use Android's ProfilingManager (Perfetto) for profiling on Android 35+.
+   *
+   * @return true if ProfilingManager-based profiling is enabled.
+   */
+  public boolean isUseProfilingManager() {
+    return useProfilingManager;
+  }
+
+  /**
+   * Set whether to use Android's ProfilingManager (Perfetto) for profiling on Android 35+. On
+   * devices below API 35 where ProfilingManager is not available, no profiling data is collected.
+   *
+   * @param useProfilingManager true to use ProfilingManager-based profiling.
+   */
+  public void setUseProfilingManager(final boolean useProfilingManager) {
+    this.useProfilingManager = useProfilingManager;
+  }
+
   public long getDeadlineTimeout() {
     return deadlineTimeout;
   }

sentry/src/test/java/io/sentry/SentryOptionsTest.kt

@@ -750,6 +750,17 @@ class SentryOptionsTest {
     assertTrue(options.isEnableAppStartProfiling)
   }
 
+  @Test
+  fun `when options are initialized, useProfilingManager is set to false by default`() {
+    assertFalse(SentryOptions().isUseProfilingManager)
+  }
+
+  @Test
+  fun `when setUseProfilingManager is called, value is set`() {
+    val options = SentryOptions().apply { isUseProfilingManager = true }
+    assertTrue(options.isUseProfilingManager)
+  }
+
   @Test
   fun `when options are initialized, profilingTracesHz is set to 101 by default`() {
     assertEquals(101, SentryOptions().profilingTracesHz)