feat(android): Warn when Gradle resolves unsupported sentry-android version

CHANGELOG.md

@@ -11,6 +11,7 @@
 ### Features
 
 - Add `enableAutoConsoleLogs` option to opt out of automatic `console.*` capture while keeping `enableLogs: true` for manual `Sentry.logger.*` calls ([#6235](https://github.com/getsentry/sentry-react-native/pull/6235))
+- Warn when Gradle resolves `sentry-android` to a version incompatible with the SDK ([#6238](https://github.com/getsentry/sentry-react-native/pull/6238))
 
 ### Internal
 

packages/core/android/build.gradle

@@ -52,11 +52,13 @@ android {
     }
 }
 
+def sentryAndroidVersion = '8.43.0'
+
 dependencies {
     compileOnly files('libs/replay-stubs.jar')
     implementation 'com.facebook.react:react-native:+'
-    api 'io.sentry:sentry-android:8.43.0'
-    debugImplementation 'io.sentry:sentry-spotlight:8.43.0'
+    api "io.sentry:sentry-android:$sentryAndroidVersion"
+    debugImplementation "io.sentry:sentry-spotlight:$sentryAndroidVersion"
 
     testImplementation 'junit:junit:4.13.2'
     testImplementation 'org.mockito:mockito-core:5.12.0'

packages/core/sentry.gradle.kts

@@ -3,9 +3,43 @@ import org.codehaus.groovy.runtime.DefaultGroovyMethods
 import org.gradle.api.tasks.Exec
 import java.io.FileInputStream
 import java.util.Properties
+import java.util.concurrent.atomic.AtomicBoolean
 import java.util.regex.Pattern
 import javax.inject.Inject
 
+val expectedSentryAndroidVersion = "8.43.0"
+
+val sentryVersionCheckWarned = AtomicBoolean(false)
+project.configurations.configureEach {
+    if (isCanBeResolved) {
+        incoming.afterResolve {
+            if (sentryVersionCheckWarned.get()) return@afterResolve
+            resolutionResult.allComponents {
+                val id = moduleVersion
+                if (id != null &&
+                    id.group == "io.sentry" &&
+                    id.name == "sentry-android-core" &&
+                    id.version != expectedSentryAndroidVersion
+                ) {
+                    if (sentryVersionCheckWarned.compareAndSet(false, true)) {
+                        logger.warn(
+                            "\nWARNING: @sentry/react-native depends on sentry-android " +
+                                "$expectedSentryAndroidVersion, but version ${id.version} was resolved. " +
+                                "This may cause build errors or unexpected behavior.\n" +
+                                "The most common cause is the Sentry Android Gradle Plugin (SAGP) " +
+                                "overriding the version via autoInstallation. To fix this, set " +
+                                "autoInstallation.enabled = false in your app/build.gradle.\n" +
+                                "Other causes include resolutionStrategy.force, BOMs, or another " +
+                                "library depending on a different sentry-android version.\n" +
+                                "See: https://docs.sentry.io/platforms/react-native/manual-setup/manual-setup/#android\n",
+                        )
+                    }
+                }
+            }
+        }
+    }
+}
+
 extra["shouldSentryAutoUploadNative"] =
     object : groovy.lang.Closure<Boolean>(this) {
         fun doCall(): Boolean = System.getenv("SENTRY_DISABLE_NATIVE_DEBUG_UPLOAD") != "true"

scripts/update-android.sh

@@ -5,28 +5,29 @@ ORIGINAL_DIR=$(cd "$(dirname "$0")" && pwd)
 cd $(dirname "$0")/../packages/core/android
 file='build.gradle'
 content=$(cat $file)
-regex='(io\.sentry:sentry-android:)([0-9\.]+)'
+regex="sentryAndroidVersion = '([0-9\.]+)'"
 if ! [[ $content =~ $regex ]]; then
-    echo "Failed to find the android plugin version in $file"
+    echo "Failed to find the sentryAndroidVersion in $file"
     exit 1
 fi
 
 case $1 in
 get-version)
-    echo ${BASH_REMATCH[2]}
+    echo ${BASH_REMATCH[1]}
     ;;
 get-repo)
     echo "https://github.com/getsentry/sentry-java.git"
     ;;
 set-version)
-    # Update all io.sentry dependencies to the same version
-    newContent="$content"
-    # Update sentry-android
-    newContent=$(echo "$newContent" | sed -E "s/(io\.sentry:sentry-android:)([0-9\.]+)/\1$2/g")
-    # Update sentry-spotlight
-    newContent=$(echo "$newContent" | sed -E "s/(io\.sentry:sentry-spotlight:)([0-9\.]+)/\1$2/g")
+    newContent=$(echo "$content" | sed -E "s/(sentryAndroidVersion = ')([0-9\.]+)(')/\1$2\3/g")
     echo "$newContent" >$file
 
+    # Update sentry.gradle.kts version check to match
+    sentryGradleFile='../sentry.gradle.kts'
+    sentryGradleContent=$(cat $sentryGradleFile)
+    sentryGradleContent=$(echo "$sentryGradleContent" | sed -E "s/(expectedSentryAndroidVersion = \")([0-9\.]+)(\")/\1$2\3/g")
+    echo "$sentryGradleContent" >$sentryGradleFile
+
     # Update expo-handler to match
     expoHandlerFile='expo-handler/build.gradle'
     expoHandlerContent=$(cat $expoHandlerFile)