DataDog · kikoveiga · Nov 26, 2025 · Oct 28, 2025 · Oct 27, 2025 · Oct 28, 2025
diff --git a/detekt_custom_safe_calls.yml b/detekt_custom_safe_calls.yml
@@ -2,6 +2,7 @@ datadog:
   UnsafeThirdPartyFunctionCall:
     knownSafeCalls:
       # region Android APIs
+      - "android.app.Activity.findViewById(kotlin.Int)"
       - "android.app.Activity.getSystemService(kotlin.String)"
       - "android.app.Activity.hashCode()"
       - "android.app.Application.registerActivityLifecycleCallbacks(android.app.Application.ActivityLifecycleCallbacks?)"
@@ -97,6 +98,7 @@ datadog:
       - "android.view.resolveSize(kotlin.Int, kotlin.Int)"
       - "android.view.View.addOnAttachStateChangeListener(android.view.View.OnAttachStateChangeListener?)"
       - "android.view.View.animate()"
+      - "android.view.View.bringToFront()"
       - "android.view.View.findViewById(kotlin.Int)"
       - "android.view.View.getChildAt(kotlin.Int)"
       - "android.view.View.getTag(kotlin.Int)"
@@ -109,8 +111,11 @@ datadog:
       - "android.view.View.setOnTouchListener(android.view.View.OnTouchListener?)"
       - "android.view.View.setTag(kotlin.Int, kotlin.Any?)"
       - "android.view.View.takeIf(kotlin.Function1)"
+      - "android.view.ViewGroup.addView(android.view.View?, android.view.ViewGroup.LayoutParams?)"
       - "android.view.ViewGroup.findViewById(kotlin.Int)"
       - "android.view.ViewGroup.getChildAt(kotlin.Int)"
+      - "android.view.ViewGroup.LayoutParams.constructor(kotlin.Int, kotlin.Int)"
+      - "android.view.ViewGroup.removeView(android.view.View?)"
       - "android.view.ViewPropertyAnimator.alpha(kotlin.Float)"
       - "android.view.ViewPropertyAnimator.cancel()"
       - "android.view.ViewPropertyAnimator.scaleX(kotlin.Float)"
@@ -565,6 +570,9 @@ datadog:
       - "java.util.HashMap.orEmpty()"
       - "java.util.HashSet.addAll(kotlin.collections.Collection)"
       - "java.util.HashSet.find(kotlin.Function1)"
+      - "java.util.IdentityHashMap.clear()"
+      - "java.util.IdentityHashMap.constructor()"
+      - "java.util.IdentityHashMap.remove(android.app.Activity?)"
       - "java.util.Locale.getDefault()"
       - "java.util.Locale.toLanguageTag()"
       - "java.util.Properties.constructor()"

diff --git a/features/dd-sdk-android-rum-debug-widget/README.md b/features/dd-sdk-android-rum-debug-widget/README.md
@@ -4,4 +4,35 @@ This module can be integrated into your application to help visualize RUM data b
 It is intended for debugging and development purposes only and **should not** be included in production builds.
 As shown in the screenshot below, the widget provides a floating overlay that displays key metrics such as **memory usage**, **CPU load** and **RUM events**.
 
-<img src="../../docs/images/screenshot_rumdebugwidget.png" width="400" alt="Datadog RUM Debug Widget"/>
+<img src="../../docs/images/screenshot_rumdebugwidget.png" width="400" alt="Datadog RUM Debug Widget"/>
+
+## Getting Started
+
+To include this module in your project, simply add the following dependency to your application's `build.gradle` file:
+
+```groovy
+dependencies {
+    debugImplementation("com.datadoghq:dd-sdk-android-rum-debug-widget:<latest-version>")
+}
+```
+
+### Initial Setup
+
+To enable the RUM Debug Widget, add the following line to your `RumConfiguration.Builder` setup in the `Application` class:
+
+```kotlin
+import com.datadog.android.rum.enableRumDebugWidget
+
+RumConfiguration.Builder(...)
+    .enableRumDebugWidget(application = this)
+```
+
+## Contributing
+
+Pull requests are welcome, but please open an issue first to discuss what you
+would like to change. For more information, read the 
+[Contributing Guide](../../CONTRIBUTING.md).
+
+## License
+
+[Apache License, v2.0](../../LICENSE)
diff --git a/features/dd-sdk-android-rum-debug-widget/api/apiSurface b/features/dd-sdk-android-rum-debug-widget/api/apiSurface
@@ -1,20 +1 @@
-class com.datadog.android.insights.DefaultInsightsCollector : com.datadog.android.rum.internal.instrumentation.insights.InsightsCollector
-  constructor(Int = 50, Long = 100L)
-  override var maxSize: Int
-  override var updateIntervalMs: Long
-  override fun onAction()
-  override fun onNewView(String)
-  override fun onSlowFrame(Long, Long)
-  override fun onLongTask(Long, Long)
-  override fun onNetworkRequest(Long, Long)
-  override fun addUpdateListener(com.datadog.android.rum.internal.instrumentation.insights.InsightsUpdatesListener)
-  override fun removeUpdateListener(com.datadog.android.rum.internal.instrumentation.insights.InsightsUpdatesListener)
-  override fun onMemoryVital(Double?)
-  override fun onCpuVital(Double?)
-  override fun onSlowFrameRate(Double?)
-  companion object 
-class com.datadog.android.insights.LocalInsightOverlay : com.datadog.android.rum.internal.instrumentation.insights.InsightsUpdatesListener
-  fun attach(android.app.Activity)
-  fun detach()
-  override fun onDataUpdated()
-  companion object 
+fun com.datadog.android.rum.RumConfiguration.Builder.enableRumDebugWidget(android.app.Application, Boolean = false): com.datadog.android.rum.RumConfiguration.Builder
diff --git a/features/dd-sdk-android-rum-debug-widget/api/dd-sdk-android-rum-debug-widget.api b/features/dd-sdk-android-rum-debug-widget/api/dd-sdk-android-rum-debug-widget.api
@@ -1,34 +1,5 @@
-public final class com/datadog/android/insights/DefaultInsightsCollector : com/datadog/android/rum/internal/instrumentation/insights/InsightsCollector {
-	public static final field Companion Lcom/datadog/android/insights/DefaultInsightsCollector$Companion;
-	public fun <init> (IJ)V
-	public synthetic fun <init> (IJILkotlin/jvm/internal/DefaultConstructorMarker;)V
-	public fun addUpdateListener (Lcom/datadog/android/rum/internal/instrumentation/insights/InsightsUpdatesListener;)V
-	public fun getMaxSize ()I
-	public fun getUpdateIntervalMs ()J
-	public fun onAction ()V
-	public fun onCpuVital (Ljava/lang/Double;)V
-	public fun onLongTask (JJ)V
-	public fun onMemoryVital (Ljava/lang/Double;)V
-	public fun onNetworkRequest (JJ)V
-	public fun onNewView (Ljava/lang/String;)V
-	public fun onSlowFrame (JJ)V
-	public fun onSlowFrameRate (Ljava/lang/Double;)V
-	public fun removeUpdateListener (Lcom/datadog/android/rum/internal/instrumentation/insights/InsightsUpdatesListener;)V
-	public fun setMaxSize (I)V
-	public fun setUpdateIntervalMs (J)V
-}
-
-public final class com/datadog/android/insights/DefaultInsightsCollector$Companion {
-}
-
-public final class com/datadog/android/insights/LocalInsightOverlay : com/datadog/android/rum/internal/instrumentation/insights/InsightsUpdatesListener {
-	public static final field Companion Lcom/datadog/android/insights/LocalInsightOverlay$Companion;
-	public fun <init> ()V
-	public final fun attach (Landroid/app/Activity;)V
-	public final fun detach ()V
-	public fun onDataUpdated ()V
-}
-
-public final class com/datadog/android/insights/LocalInsightOverlay$Companion {
+public final class com/datadog/android/insights/internal/RumDebugWidgetKt {
+	public static final fun enableRumDebugWidget (Lcom/datadog/android/rum/RumConfiguration$Builder;Landroid/app/Application;Z)Lcom/datadog/android/rum/RumConfiguration$Builder;
+	public static synthetic fun enableRumDebugWidget$default (Lcom/datadog/android/rum/RumConfiguration$Builder;Landroid/app/Application;ZILjava/lang/Object;)Lcom/datadog/android/rum/RumConfiguration$Builder;
 }
 
diff --git a/features/dd-sdk-android-rum-debug-widget/build.gradle.kts b/features/dd-sdk-android-rum-debug-widget/build.gradle.kts
@@ -39,6 +39,10 @@ plugins {
 }
 
 android {
+    defaultConfig {
+        consumerProguardFiles("consumer-rules.pro")
+    }
+
     namespace = "com.datadog.android.rumdebugwidget"
 }
 

diff --git a/features/dd-sdk-android-rum-debug-widget/consumer-rules.pro b/features/dd-sdk-android-rum-debug-widget/consumer-rules.pro
@@ -0,0 +1 @@
+-keep class com.datadog.android.insights.internal.RumDebugWidget
diff --git a/...roid-rum-debug-widget/src/main/kotlin/com/datadog/android/insights/LocalInsightOverlay.kt b/...roid-rum-debug-widget/src/main/kotlin/com/datadog/android/insights/LocalInsightOverlay.kt
diff --git a/...k-android-rum-debug-widget/src/main/kotlin/com/datadog/android/insights/RumDebugWidget.kt b/...k-android-rum-debug-widget/src/main/kotlin/com/datadog/android/insights/RumDebugWidget.kt
@@ -0,0 +1,39 @@
+/*
+ * Unless explicitly stated otherwise all files in this repository are licensed under the Apache License Version 2.0.
+ * This product includes software developed at Datadog (https://www.datadoghq.com/).
+ * Copyright 2016-Present Datadog, Inc.
+ */
+
+package com.datadog.android.insights
+
+import android.app.Application
+import android.content.pm.ApplicationInfo
+import com.datadog.android.insights.internal.DefaultInsightsCollector
+import com.datadog.android.insights.internal.overlay.OverlayManager
+import com.datadog.android.rum.RumConfiguration
+import com.datadog.android.rum._RumInternalProxy
+
+/**
+ * Enables the RUM Debug Widget for the given [application].
+ *
+ * By default, the widget is only enabled in debug builds (when the application is debuggable).
+ * To enable it in release builds (e.g., for local testing), set [allowInRelease] to `true` and
+ * add the `dd-sdk-android-rum-debug-widget` module as `implementation` (not `debugImplementation`)
+ * in your `build.gradle` file.
+ *
+ * @param application The application where to enable the RUM Debug Widget.
+ * @param allowInRelease Set to `true` to enable the widget in release builds. Defaults to `false`
+ * to prevent accidental exposure in production.
+ * @return The same [RumConfiguration.Builder] instance.
+ */
+fun RumConfiguration.Builder.enableRumDebugWidget(
+    application: Application,
+    allowInRelease: Boolean = false
+): RumConfiguration.Builder = apply {
+    val isApplicationDebuggable = (application.applicationInfo.flags and ApplicationInfo.FLAG_DEBUGGABLE) != 0
+    if (!isApplicationDebuggable && !allowInRelease) return@apply
+
+    val insightsCollector = DefaultInsightsCollector()
+    _RumInternalProxy.setInsightsCollector(this, insightsCollector)
+    application.registerActivityLifecycleCallbacks(OverlayManager(insightsCollector))
+}
diff --git a/...roid/insights/DefaultInsightsCollector.kt → ...ghts/internal/DefaultInsightsCollector.kt b/...roid/insights/DefaultInsightsCollector.kt → ...ghts/internal/DefaultInsightsCollector.kt
@@ -4,7 +4,7 @@
  * Copyright 2016-Present Datadog, Inc.
  */
 
-package com.datadog.android.insights
+package com.datadog.android.insights.internal
 
 import android.os.Handler
 import android.os.Looper
@@ -13,7 +13,6 @@ import com.datadog.android.insights.internal.extensions.Mb
 import com.datadog.android.insights.internal.extensions.round
 import com.datadog.android.insights.internal.platform.Platform
 import com.datadog.android.internal.collections.EvictingQueue
-import com.datadog.android.rum.ExperimentalRumApi
 import com.datadog.android.rum.internal.instrumentation.insights.InsightsCollector
 import com.datadog.android.rum.internal.instrumentation.insights.InsightsUpdatesListener
 import java.util.concurrent.CopyOnWriteArraySet
@@ -27,8 +26,7 @@ import java.util.concurrent.CopyOnWriteArraySet
  * @param handler Handler to post updates on. Injected for test purposes.
  * @param platform Platform abstraction to access system information. Injected for test purposes.
  */
-@ExperimentalRumApi
-class DefaultInsightsCollector internal constructor(
+internal class DefaultInsightsCollector internal constructor(
     maxSize: Int,
     updateIntervalMs: Long,
     private val handler: Handler,

diff --git a/...debug-widget/src/main/kotlin/com/datadog/android/insights/internal/InsightStateStorage.kt b/...debug-widget/src/main/kotlin/com/datadog/android/insights/internal/InsightStateStorage.kt
@@ -14,7 +14,9 @@ internal class InsightStateStorage private constructor(
     private val sharedPreferences: SharedPreferences
 ) {
 
-    constructor(context: Context) : this(context.getSharedPreferences(INSIGHT_PREFERENCES, Context.MODE_PRIVATE))
+    constructor(context: Context) : this(
+        context.applicationContext.getSharedPreferences(INSIGHT_PREFERENCES, Context.MODE_PRIVATE)
+    )
 
     @Suppress("UnsafeThirdPartyFunctionCall") // safe because there is a putFloat call for each getFloat
     var widgetPosition: Pair<Float, Float>
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1 @@
		-keep class com.datadog.android.insights.internal.RumDebugWidget
Comment thread kikoveiga marked this conversation as resolved.