chore(samples-android): Support mavenLocal for builds that apply the SAGP

Adds wiring that lets us prefer mavenLocal SAGP artifacts, when present, for Android sample app builds that set -PuseSagp=true. If no local artifact is found, we fall back to libs.versions.toml.

Author: 0xadam-brown

gradle/libs.versions.toml

@@ -29,6 +29,7 @@ otelInstrumentationAlpha = "2.26.0-alpha"
 otelSemanticConventions = "1.40.0"
 otelSemanticConventionsAlpha = "1.40.0-alpha"
 retrofit = "2.9.0"
+sagp = "6.6.0"
 slf4j = "1.7.30"
 springboot2 = "2.7.18"
 springboot3 = "3.5.0"
@@ -66,7 +67,7 @@ springboot4 = { id = "org.springframework.boot", version.ref = "springboot4" }
 spring-dependency-management = { id = "io.spring.dependency-management", version = "1.1.7" }
 gretty = { id = "org.gretty", version = "4.0.0" }
 animalsniffer = { id = "ru.vyarus.animalsniffer", version = "2.0.1" }
-sentry = { id = "io.sentry.android.gradle", version = "6.6.0"}
+sentry = { id = "io.sentry.android.gradle", version.ref = "sagp"}
 shadow = { id = "com.gradleup.shadow", version = "9.4.1" }
 
 [libraries]

sentry-samples/sentry-samples-android/README.md

@@ -40,6 +40,26 @@ Regardless of `useSagp`, the sample always depends on sentry-java modules from t
 auto-installation is disabled, so the sample never pulls a separate SDK version from Maven. Local SDK changes in your branch are picked up
 directly.
 
+### Testing an unpublished SAGP build
+
+#### I. Publish to Maven Local:
+
+`-PuseSagp=true` builds check `mavenLocal()` first when resolving SAGP, so you can test a local SAGP branch by publishing it to your local
+Maven repository:
+
+```
+# In your sentry-android-gradle-plugin checkout:
+./gradlew publishToMavenLocal
+```
+
+Re-run `publishToMavenLocal` after each SAGP change; a previously published artifact stays in `~/.m2` and keeps winning until you republish
+or remove it.
+
+#### II. Update `sagp` version in `libs.versions.toml` if needed
+
+The sample requests the SAGP version pinned in `gradle/libs.versions.toml` (`[versions].sagp`), so either publish your branch at that
+version, or temporarily bump the pin to your branch's version (e.g., a `-SNAPSHOT`) without committing the change.
+
 ## Viewing SDK output
 
 ### Locally

sentry-samples/sentry-samples-android/build.gradle.kts

@@ -2,6 +2,8 @@ import com.android.build.api.artifact.SingleArtifact
 import com.android.build.api.variant.impl.VariantImpl
 import io.sentry.android.gradle.extensions.InstrumentationFeature
 import io.sentry.android.gradle.extensions.SentryPluginExtension
+import java.io.File
+import java.time.Instant
 import org.apache.tools.ant.taskdefs.condition.Os
 import org.gradle.internal.extensions.stdlib.capitalized
 
@@ -20,6 +22,8 @@ if (useSagp.get()) {
 }
 
 plugins.withId("io.sentry.android.gradle") {
+  logSagpOrigin()
+
   // Extension configs match non-SAGP builds. Update locally to test your feature.
   extensions.configure<SentryPluginExtension>("sentry") {
     autoInstallation.enabled.set(false)
@@ -230,3 +234,46 @@ abstract class ToggleNativeLoggingTask : Exec() {
       )
   }
 }
+
+fun Project.logSagpOrigin() {
+  // A locally published SAGP in ~/.m2 silently shadows the released artifact (see README,
+  // "Testing an unpublished SAGP build"); we log so developers don't wonder what's going on.
+  val sagpVersion =
+    SentryPluginExtension::class
+      .java
+      .protectionDomain
+      .codeSource
+      ?.location
+      ?.toURI()
+      ?.let { File(it).name }
+      ?.removePrefix("sentry-android-gradle-plugin-")
+      ?.removeSuffix(".jar")
+
+  val sagpLocalJar =
+    sagpVersion?.let {
+      File(
+        System.getProperty("user.home"),
+        ".m2/repository/io/sentry/sentry-android-gradle-plugin/$it/sentry-android-gradle-plugin-$it.jar",
+      )
+    }
+
+  val sagpOrigin =
+    when {
+      sagpVersion == null -> "unknown origin"
+      sagpLocalJar?.isFile == true ->
+        "mavenLocal (published ${Instant.ofEpochMilli(sagpLocalJar.lastModified())})"
+      else -> "remote repository"
+    }
+
+  val colorize =
+    gradle.startParameter.consoleOutput != org.gradle.api.logging.configuration.ConsoleOutput.Plain
+  val (magenta, reset) = if (colorize) "\u001B[35m" to "\u001B[0m" else "" to ""
+
+  logger.lifecycle(
+    "\n{}🧩 Applied Sentry Android Gradle Plugin {} from {}{}",
+    magenta,
+    sagpVersion ?: "<unknown version>",
+    sagpOrigin,
+    reset,
+  )
+}

settings.gradle.kts

@@ -2,6 +2,15 @@ enableFeaturePreview("TYPESAFE_PROJECT_ACCESSORS")
 
 pluginManagement {
     repositories {
+        // Prefer local SAGP artifact if one exists; otherwise fall back to libs.versions.toml.
+        if (providers.gradleProperty("useSagp").orNull.equals("true", ignoreCase = true)) {
+            mavenLocal {
+                content {
+                    includeGroup("io.sentry")
+                    includeGroup("io.sentry.android.gradle")
+                }
+            }
+        }
         mavenCentral()
         gradlePluginPortal()
     }