fix(android): Read Timber Logs option after configuration

Resolve the auto-installed Timber integration's Logs opt-in lazily when the integration registers. This honors programmatic configuration and manifest overrides applied after default integrations are constructed.

Co-Authored-By: Claude <noreply@anthropic.com>

Author: adinauer

sentry-android-core/build.gradle.kts

@@ -122,6 +122,7 @@ dependencies {
   testImplementation(projects.sentrySpotlight)
   testImplementation(projects.sentryAndroidFragment)
   testImplementation(projects.sentryAndroidTimber)
+  testImplementation(libs.timber)
   testImplementation(projects.sentryAndroidReplay)
   testImplementation(projects.sentryCompose)
   testImplementation(projects.sentryAndroidNdk)
@@ -132,5 +133,4 @@ dependencies {
   testImplementation(libs.androidx.compose.foundation.layout)
   testImplementation(libs.androidx.compose.material3)
   testRuntimeOnly(libs.androidx.fragment.ktx)
-  testRuntimeOnly(libs.timber)
 }

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

@@ -473,7 +473,7 @@ static void installDefaultIntegrations(
     }
 
     if (isTimberAvailable) {
-      options.addIntegration(new SentryTimberIntegration(options.isEnableTimberLogs()));
+      options.addIntegration(new SentryTimberIntegration(options::isEnableTimberLogs));
     }
     options.addIntegration(new AppComponentsBreadcrumbsIntegration(context));
     options.addIntegration(new SystemEventsBreadcrumbsIntegration(context));

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

@@ -23,6 +23,7 @@ import io.sentry.SentryEnvelope
 import io.sentry.SentryLevel
 import io.sentry.SentryLevel.DEBUG
 import io.sentry.SentryLevel.FATAL
+import io.sentry.SentryLogEvent
 import io.sentry.SentryOptions
 import io.sentry.SentryOptions.BeforeSendCallback
 import io.sentry.Session
@@ -84,6 +85,7 @@ import org.robolectric.annotation.Config
 import org.robolectric.shadow.api.Shadow
 import org.robolectric.shadows.ShadowActivityManager
 import org.robolectric.shadows.ShadowActivityManager.ApplicationExitInfoBuilder
+import timber.log.Timber
 
 @RunWith(AndroidJUnit4::class)
 @Config(sdk = [Build.VERSION_CODES.N], shadows = [SentryShadowProcess::class])
@@ -238,6 +240,46 @@ class SentryAndroidTest {
     assertNotEquals(0, AppStartMetrics.getInstance().appStartTimeSpan.durationMs)
   }
 
+  @Test
+  fun `auto-installed Timber integration uses Logs option set in configuration callback`() {
+    val logs = mutableListOf<SentryLogEvent>()
+    fixture.initSut { options ->
+      options.isEnableTimberLogs = true
+      options.logs.beforeSend =
+        SentryOptions.Logs.BeforeSendLogCallback { log ->
+          logs.add(log)
+          log
+        }
+    }
+
+    Timber.i("message")
+
+    assertEquals(1, logs.size)
+  }
+
+  @Test
+  fun `auto-installed Timber integration uses configuration callback override of manifest option`() {
+    val metadata =
+      Bundle().apply {
+        putString(ManifestMetadataReader.DSN, "https://key@sentry.io/123")
+        putBoolean(ManifestMetadataReader.ENABLE_TIMBER_LOGS, true)
+      }
+    val mockContext = ContextUtilsTestHelper.mockMetaData(metaData = metadata)
+    val logs = mutableListOf<SentryLogEvent>()
+
+    initForTest(mockContext) { options ->
+      options.isEnableTimberLogs = false
+      options.logs.beforeSend =
+        SentryOptions.Logs.BeforeSendLogCallback { log ->
+          logs.add(log)
+          log
+        }
+    }
+    Timber.i("message")
+
+    assertTrue(logs.isEmpty())
+  }
+
   @Test
   fun `deduplicates fragment, timber and system events integrations`() {
     var refOptions: SentryAndroidOptions? = null

sentry-android-timber/api/sentry-android-timber.api

@@ -12,6 +12,7 @@ public final class io/sentry/android/timber/SentryTimberIntegration : io/sentry/
 	public fun <init> (Lio/sentry/SentryLevel;Lio/sentry/SentryLevel;Lio/sentry/SentryLogLevel;)V
 	public synthetic fun <init> (Lio/sentry/SentryLevel;Lio/sentry/SentryLevel;Lio/sentry/SentryLogLevel;ILkotlin/jvm/internal/DefaultConstructorMarker;)V
 	public fun <init> (Lio/sentry/SentryLevel;Lio/sentry/SentryLevel;Lio/sentry/SentryLogLevel;Z)V
+	public fun <init> (Ljava/util/function/BooleanSupplier;)V
 	public fun <init> (Z)V
 	public fun close ()V
 	public final fun getEnableLogs ()Z

sentry-android-timber/src/main/java/io/sentry/android/timber/SentryTimberIntegration.kt

@@ -10,6 +10,7 @@ import io.sentry.SentryOptions
 import io.sentry.android.timber.BuildConfig.VERSION_NAME
 import io.sentry.util.IntegrationUtils.addIntegrationToSdkVersion
 import java.io.Closeable
+import java.util.function.BooleanSupplier
 import timber.log.Timber
 
 /** Sentry integration for Timber. */
@@ -18,11 +19,13 @@ public class SentryTimberIntegration(
   public val minBreadcrumbLevel: SentryLevel = SentryLevel.INFO,
   public val minLogsLevel: SentryLogLevel = SentryLogLevel.INFO,
 ) : Integration, Closeable {
-  public var enableLogs: Boolean = false
-    private set
+  public val enableLogs: Boolean
+    get() = enableLogsProvider.asBoolean
+
+  private var enableLogsProvider: BooleanSupplier = BooleanSupplier { false }
 
   public constructor(enableLogs: Boolean) : this() {
-    this.enableLogs = enableLogs
+    enableLogsProvider = BooleanSupplier { enableLogs }
   }
 
   public constructor(
@@ -31,7 +34,11 @@ public class SentryTimberIntegration(
     minLogsLevel: SentryLogLevel,
     enableLogs: Boolean,
   ) : this(minEventLevel, minBreadcrumbLevel, minLogsLevel) {
-    this.enableLogs = enableLogs
+    enableLogsProvider = BooleanSupplier { enableLogs }
+  }
+
+  public constructor(enableLogsProvider: BooleanSupplier) : this() {
+    this.enableLogsProvider = enableLogsProvider
   }
 
   private lateinit var tree: SentryTimberTree
@@ -47,7 +54,14 @@ public class SentryTimberIntegration(
   override fun register(scopes: IScopes, options: SentryOptions) {
     logger = options.logger
 
-    tree = SentryTimberTree(scopes, minEventLevel, minBreadcrumbLevel, minLogsLevel, enableLogs)
+    tree =
+      SentryTimberTree(
+        scopes,
+        minEventLevel,
+        minBreadcrumbLevel,
+        minLogsLevel,
+        enableLogsProvider.asBoolean,
+      )
     Timber.plant(tree)
 
     logger.log(SentryLevel.DEBUG, "SentryTimberIntegration installed.")

sentry-android-timber/src/test/java/io/sentry/android/timber/SentryTimberIntegrationTest.kt

@@ -12,6 +12,7 @@ import io.sentry.logger.ILoggerApi
 import io.sentry.logger.SentryLogParameters
 import io.sentry.protocol.SdkVersion
 import io.sentry.transport.ITransport
+import java.util.function.BooleanSupplier
 import kotlin.test.BeforeTest
 import kotlin.test.Test
 import kotlin.test.assertEquals
@@ -108,6 +109,18 @@ class SentryTimberIntegrationTest {
     verify(fixture.logs).log(any(), any<SentryLogParameters>(), any<String>())
   }
 
+  @Test
+  fun `Integration evaluates Logs provider when registered`() {
+    var enableLogs = false
+    val sut = SentryTimberIntegration(BooleanSupplier { enableLogs })
+    enableLogs = true
+
+    sut.register(fixture.scopes, fixture.options)
+    Timber.i("message")
+
+    verify(fixture.logs).log(any(), any<SentryLogParameters>(), any<String>())
+  }
+
   @Test
   fun `Integrations removes a tree from Timber on close integration`() {
     val sut = fixture.getSut()