build(samples): [Sample Tests 47] Move the JVM samples to their own build (#6394)

* build(samples): Move the JVM samples to their own build

The 28 JVM samples are now a standalone Gradle build in sentry-samples
that includes the SDK build, like the Android sample and the Android
integration tests. They depend on io.sentry:* coordinates, which Gradle
substitutes with the SDK's projects. The SDK build doesn't include them
back, so the Spring Boot, gretty and shadow plugins the samples apply no
longer load in the SDK build.

The three bootRunWithAgent tasks find the agent jar from the repository
root and take the SDK version from the catalog, since the samples build
has its own root directory and gradle.properties.

With no samples or integration tests left in the SDK build, the name
filters that skipped them for publishing and CodeQL go too.

Root check and spotlessApply no longer reach the samples, so preMerge runs
this build's check, which covers what the root check ran for them:
compilation, jars and spotless. The format workflow runs its
spotlessApply.

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

* build(samples): Link the JVM samples' Gradle files to the SDK build's

gradle.properties, gradlew, gradle/wrapper and
gradle/gradle-daemon-jvm.properties are now symlinks to the SDK build's
files, as in the Android sample and integration test builds. The copied
gradle.properties had drifted from the root one (-Xmx6g and
CrashOnOutOfMemoryError), and the build had no wrapper or daemon JDK pin.

The settings read the SDK version from the shared versionName property,
use the root build's Develocity plugin version, and include each sample
on its own line, matching the other separate builds.

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

* build(samples): Apply the convention plugins in each JVM sample

Each sample applies io.sentry.spotless and io.sentry.jdk-target in its
own plugins block, as the modules of the other separate builds do,
instead of the root script applying them to every subproject.

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

* ci(samples): Check the JVM samples in the Samples workflow

The JVM samples' check runs as its own job in the Samples workflow, like
the other separate builds, instead of through checkSamples in make
preMerge, so it no longer lengthens the required Build job. Dependabot
scans their build too.

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

* build: Drop the root's Spring dependency-management declaration

With the JVM samples in their own build, no project in the SDK build
applies io.spring.dependency-management.

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

* build(samples): Drop the comment on the JVM samples' root plugins

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

* build(samples): Drop the header comment from the JVM samples' settings

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

* build(samples): Declare the servlet sample's SDK version before using it

The dependencies block read sentryVersion before its declaration ran, so the
sample asked for io.sentry:sentry-servlet:null. The composite build substitutes
the SDK project by group and name, which hid it, but resolving published
artifacts would fail.

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

---------

Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>

Author: runningcode

.cursor/rules/new_module.mdc

@@ -31,16 +31,11 @@ the release that first ships it. All of the following have to be merged **before
 
 2. Add the module to the include list in `settings.gradle.kts`
 
-If adding a `sentry-samples` module, also add it to the `ignoredProjects` list in the root `build.gradle.kts`:
-
-```kotlin
-ignoredProjects.addAll(
-    listOf(
-        // ... existing projects ...
-        "sentry-samples-{module-name}"
-    )
-)
-```
+If adding a sample, add an `include("…")` line for it to `sentry-samples/settings.gradle.kts`
+instead, and apply `id("io.sentry.spotless")` and `id("io.sentry.jdk-target")` in its `plugins`
+block. The samples are a separate Gradle build that includes the SDK build, so a sample depends on
+`"io.sentry:sentry-{module-name}:$sentryVersion"` (with `val sentryVersion =
+libs.versions.sentry.get()`), and Gradle substitutes the SDK's project for it.
 
 3. Add a `SENTRY_{MODULE}_SDK_NAME` constant to the `Config.Sentry` block in
    `buildSrc/src/main/java/Config.kt`:

.github/dependabot.yml

@@ -12,6 +12,7 @@ updates:
       - "/"
       - "/sentry-samples/sentry-samples-android"
       - "/sentry-android-integration-tests"
+      - "/sentry-samples"
     registries:
       - gradle-plugin-portal
     schedule:

.github/workflows/samples.yml

@@ -24,6 +24,8 @@ jobs:
             path: sentry-samples/sentry-samples-android
           - name: sentry-android-integration-tests
             path: sentry-android-integration-tests
+          - name: sentry-samples
+            path: sentry-samples
 
     steps:
       - name: Checkout Repo

AGENTS.md

@@ -67,6 +67,9 @@ resolves the per-module test task, including integration test suites, for you.
 
 # Build the Android sample, a separate Gradle build that includes this one
 ./gradlew -p sentry-samples/sentry-samples-android assembleDebug
+
+# Build the JVM samples, another separate Gradle build that includes this one
+./gradlew -p sentry-samples assemble
 ```
 
 ## Development Workflow Rules
@@ -113,7 +116,7 @@ The repository is organized into multiple modules:
 
 ### Utility Modules
 - **`sentry-test-support`** - Shared test utilities, including `MockSentryServer` and envelope matchers
-- **`sentry-samples`** - Example applications. `sentry-samples-android` is a separate Gradle build that includes this one, so root tasks such as `check` and `spotlessApply` don't reach it
+- **`sentry-samples`** - Example applications, in two separate Gradle builds that include this one: `sentry-samples` (JVM) and `sentry-samples/sentry-samples-android`. Root tasks such as `check` and `spotlessApply` don't reach them, and `sentry-android-integration-tests` is a separate build too
 - **`sentry-bom`** - Bill of Materials for dependency management
 
 ### Key Architectural Patterns

Makefile

@@ -28,12 +28,14 @@ update:
 # Spotless formats the code. The root spotlessApply doesn't reach the separate builds.
 format:
 	./gradlew spotlessApply
+	./gradlew -p sentry-samples spotlessApply
 	./gradlew -p sentry-samples/sentry-samples-android spotlessApply
 	./gradlew -p sentry-android-integration-tests spotlessApply
 
 # Spotless check's code
 checkFormat:
 	./gradlew spotlessJavaCheck spotlessKotlinCheck
+	./gradlew -p sentry-samples spotlessJavaCheck spotlessKotlinCheck
 	./gradlew -p sentry-samples/sentry-samples-android spotlessJavaCheck spotlessKotlinCheck
 	./gradlew -p sentry-android-integration-tests spotlessJavaCheck spotlessKotlinCheck
 

build.gradle.kts

@@ -17,7 +17,6 @@ plugins {
     alias(libs.plugins.kotlin.compose) apply false
     alias(libs.plugins.errorprone) apply false
     alias(libs.plugins.gradle.versions) apply false
-    alias(libs.plugins.spring.dependency.management) apply false
     id("io.sentry.javadoc.aggregate")
     alias(libs.plugins.android.application) apply false
 }
@@ -51,9 +50,7 @@ allprojects {
 tasks.register("buildForCodeQL") {
     subprojects
         .filter {
-            !it.displayName.contains("sample") &&
-                !it.displayName.contains("integration-tests") &&
-                !it.displayName.contains("bom") &&
+            !it.displayName.contains("bom") &&
                 it.name != "sentry-opentelemetry"
         }
         .forEach { proj ->

sentry-samples/build.gradle.kts

@@ -0,0 +1,8 @@
+plugins {
+  alias(libs.plugins.kotlin.jvm) apply false
+  alias(libs.plugins.kotlin.spring) apply false
+  alias(libs.plugins.spring.dependency.management) apply false
+  alias(libs.plugins.gradle.versions) apply false
+  id("io.sentry.spotless") apply false
+  id("io.sentry.jdk-target") apply false
+}

sentry-samples/gradle.properties

@@ -0,0 +1 @@
+../gradle.properties

sentry-samples/gradle/gradle-daemon-jvm.properties

@@ -0,0 +1 @@
+../../gradle/gradle-daemon-jvm.properties

sentry-samples/gradle/wrapper

@@ -0,0 +1 @@
+../../gradle/wrapper