Add proguard uuid option for android (#436)

* Add ProGuard UUID support for Android platform in Sentry options

Co-authored-by: giancarlo.buenaflor <giancarlo.buenaflor@sentry.io>

* Update

* Update

* Api dump

---------

Co-authored-by: Cursor Agent <cursoragent@cursor.com>

Author: buenaflor

CHANGELOG.md

@@ -1,5 +1,10 @@
 # Changelog
 
+## Features
+
+- Add `proguardUuid` option to `SentryOptions` ([#436](https://github.com/getsentry/sentry-kotlin-multiplatform/pull/436))
+  - This will propagate the `proguardUuid` value to Sentry Android
+
 ## 0.17.1
 
 ### Fixes

sentry-kotlin-multiplatform/api/android/sentry-kotlin-multiplatform.api

@@ -183,6 +183,7 @@ public class io/sentry/kotlin/multiplatform/SentryOptions {
 	public final fun getFailedRequestTargets ()Ljava/util/List;
 	public final fun getMaxAttachmentSize ()J
 	public final fun getMaxBreadcrumbs ()I
+	public final fun getProguardUuid ()Ljava/lang/String;
 	public final fun getRelease ()Ljava/lang/String;
 	public final fun getSampleRate ()Ljava/lang/Double;
 	public final fun getSdk ()Lio/sentry/kotlin/multiplatform/protocol/SdkVersion;
@@ -213,6 +214,7 @@ public class io/sentry/kotlin/multiplatform/SentryOptions {
 	public final fun setFailedRequestTargets (Ljava/util/List;)V
 	public final fun setMaxAttachmentSize (J)V
 	public final fun setMaxBreadcrumbs (I)V
+	public final fun setProguardUuid (Ljava/lang/String;)V
 	public final fun setRelease (Ljava/lang/String;)V
 	public final fun setSampleRate (Ljava/lang/Double;)V
 	public final fun setSdk (Lio/sentry/kotlin/multiplatform/protocol/SdkVersion;)V

sentry-kotlin-multiplatform/api/jvm/sentry-kotlin-multiplatform.api

@@ -180,6 +180,7 @@ public class io/sentry/kotlin/multiplatform/SentryOptions {
 	public final fun getFailedRequestTargets ()Ljava/util/List;
 	public final fun getMaxAttachmentSize ()J
 	public final fun getMaxBreadcrumbs ()I
+	public final fun getProguardUuid ()Ljava/lang/String;
 	public final fun getRelease ()Ljava/lang/String;
 	public final fun getSampleRate ()Ljava/lang/Double;
 	public final fun getSdk ()Lio/sentry/kotlin/multiplatform/protocol/SdkVersion;
@@ -210,6 +211,7 @@ public class io/sentry/kotlin/multiplatform/SentryOptions {
 	public final fun setFailedRequestTargets (Ljava/util/List;)V
 	public final fun setMaxAttachmentSize (J)V
 	public final fun setMaxBreadcrumbs (I)V
+	public final fun setProguardUuid (Ljava/lang/String;)V
 	public final fun setRelease (Ljava/lang/String;)V
 	public final fun setSampleRate (Ljava/lang/Double;)V
 	public final fun setSdk (Lio/sentry/kotlin/multiplatform/protocol/SdkVersion;)V

sentry-kotlin-multiplatform/src/androidMain/kotlin/io/sentry/kotlin/multiplatform/extensions/SentryOptionsExtensions.android.kt

@@ -20,6 +20,10 @@ internal fun SentryOptions.toAndroidSentryOptionsCallback(): (SentryAndroidOptio
     androidOptions.isAnrEnabled = kmpOptions.isAnrEnabled
     androidOptions.anrTimeoutIntervalMillis = kmpOptions.anrTimeoutIntervalMillis
 
+    kmpOptions.proguardUuid?.let { uuid ->
+        androidOptions.proguardUuid = uuid
+    }
+
     // Replay options
     androidOptions.sessionReplay.maskAllText =
         kmpOptions.sessionReplay.maskAllText

sentry-kotlin-multiplatform/src/androidUnitTest/kotlin/io/sentry/kotlin/multiplatform/PlatformOptions.android.kt

@@ -15,6 +15,7 @@ actual interface PlatformOptions : CommonPlatformOptions {
     val attachScreenshot: Boolean
     val attachViewHierarchy: Boolean
     val sessionReplay: AndroidSentryReplayOptions
+    val proguardUuid: String?
 }
 
 class SentryAndroidOptionsWrapper(private val androidOptions: SentryAndroidOptions) :
@@ -76,6 +77,9 @@ class SentryAndroidOptionsWrapper(private val androidOptions: SentryAndroidOptio
     override val sendDefaultPii: Boolean
         get() = androidOptions.isSendDefaultPii
 
+    override val proguardUuid: String?
+        get() = androidOptions.proguardUuid
+
     override fun applyFromOptions(options: SentryOptions) {
         options.toAndroidSentryOptionsCallback().invoke(androidOptions)
     }
@@ -113,6 +117,7 @@ actual fun PlatformOptions.assertPlatformSpecificOptions(kmpOptions: SentryOptio
         kmpReplayOptions.sessionSampleRate
     )
     assertEquals(androidOptions.sessionReplay.quality.name, kmpReplayOptions.quality.name)
+    assertEquals(androidOptions.proguardUuid, kmpOptions.proguardUuid)
 }
 
 actual fun createSentryPlatformOptionsConfiguration(): PlatformOptionsConfiguration = {

sentry-kotlin-multiplatform/src/commonMain/kotlin/io/sentry/kotlin/multiplatform/SentryOptions.kt

@@ -213,6 +213,20 @@ public open class SentryOptions {
     public var experimental: ExperimentalOptions = ExperimentalOptions()
         private set
 
+    /**
+     * Sets the ProGuard UUID for the app. This option is used to match ProGuard/R8/DexGuard mapping
+     * files to your app. The UUID is typically generated automatically during the build process
+     * and included in the AndroidManifest.xml file.
+     *
+     * **Platform Availability**: Android only.
+     *
+     * On non-Android platforms, this option is ignored and has no effect.
+     *
+     * For more information on ProGuard mapping files and obfuscation, see:
+     * [ProGuard & DexGuard Documentation](https://docs.sentry.io/platforms/android/enhance-errors/proguard/)
+     */
+    public var proguardUuid: String? = null
+
     /**
      * Experimental options for new features, these options are going to be promoted to SentryOptions
      * before GA.

sentry-kotlin-multiplatform/src/commonTest/kotlin/io/sentry/kotlin/multiplatform/SentryOptionsTest.kt

@@ -134,6 +134,7 @@ class SentryOptionsTest : BaseSentryTest() {
         assertEquals(SentryReplayOptions.Quality.MEDIUM, options.sessionReplay.quality)
         assertTrue(options.enableWatchdogTerminationTracking)
         assertFalse(options.sendDefaultPii)
+        assertNull(options.proguardUuid)
     }
 
     @Test
@@ -165,6 +166,7 @@ class SentryOptionsTest : BaseSentryTest() {
             sessionReplay.maskAllImages = false
             sessionReplay.quality = SentryReplayOptions.Quality.LOW
             sendDefaultPii = true
+            proguardUuid = "test-proguard-uuid-12345"
         }
 
         val platformOptions = createPlatformOptions()