ci: Add Java 8 API compatibility check

Author: adinauer

.github/gradle/java8-api-compatibility.init.gradle.kts

@@ -0,0 +1,64 @@
+import org.gradle.api.Project
+import org.gradle.api.JavaVersion
+import org.gradle.api.plugins.JavaPluginExtension
+import ru.vyarus.gradle.plugin.animalsniffer.AnimalSnifferPlugin
+
+initscript {
+  repositories {
+    gradlePluginPortal()
+    mavenCentral()
+  }
+  dependencies {
+    classpath("ru.vyarus:gradle-animalsniffer-plugin:2.0.1")
+  }
+}
+
+val excludedPathPrefixes =
+  setOf(
+    ":sentry-samples",
+    ":sentry-system-test-support",
+    ":sentry-test-support",
+  )
+
+fun Project.isJava8SdkModule(): Boolean {
+  val java = extensions.findByType(JavaPluginExtension::class.java) ?: return false
+  return plugins.hasPlugin("java-library") &&
+    java.targetCompatibility == JavaVersion.VERSION_1_8 &&
+    excludedPathPrefixes.none { path == it || path.startsWith("$it:") }
+}
+
+allprojects {
+  if (rootProject.name != "sentry-root") return@allprojects
+
+  afterEvaluate {
+    if (!isJava8SdkModule()) return@afterEvaluate
+
+    if (!plugins.hasPlugin("ru.vyarus.animalsniffer")) {
+      apply<AnimalSnifferPlugin>()
+    }
+
+    configurations.named("signature").configure {
+      dependencies.clear()
+    }
+    dependencies.add("signature", "org.codehaus.mojo.signature:java18:1.0@signature")
+  }
+}
+
+rootProject {
+  tasks.register("java8ApiCompatibility") {
+    group = "verification"
+    description = "Checks Java 8 SDK modules against the Java 8 runtime API signature."
+  }
+}
+
+gradle.projectsEvaluated {
+  val java8SdkModules = rootProject.allprojects.filter { it.isJava8SdkModule() }
+  rootProject.tasks.named("java8ApiCompatibility").configure {
+    dependsOn(java8SdkModules.map { it.tasks.named("animalsnifferMain") })
+    doFirst {
+      logger.lifecycle(
+        "Checking Java 8 API compatibility for: ${java8SdkModules.joinToString { it.path }}"
+      )
+    }
+  }
+}

.github/workflows/java-8-api-compatibility.yml

@@ -0,0 +1,50 @@
+name: 'Java 8 API Compatibility'
+
+on:
+  push:
+    branches:
+      - main
+  pull_request:
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  java-8-api-compatibility:
+    name: Java 8 API Compatibility
+    runs-on: ubuntu-latest
+
+    env:
+      GRADLE_ENCRYPTION_KEY: ${{ secrets.GRADLE_ENCRYPTION_KEY }}
+
+    steps:
+      - name: Checkout Repo
+        uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
+        with:
+          ref: ${{ github.event.pull_request.head.sha || github.sha }}
+          submodules: 'recursive'
+
+      - name: Setup Java Version
+        uses: actions/setup-java@0f481fcb613427c0f801b606911222b5b6f3083a # v5
+        with:
+          distribution: 'temurin'
+          java-version: '17'
+
+      - name: Cache buildSrc
+        uses: actions/cache@55cc8345863c7cc4c66a329aec7e433d2d1c52a9 # v6.1.0
+        with:
+          path: buildSrc/build
+          key: build-logic-${{ hashFiles('buildSrc/src/**', 'buildSrc/build.gradle.kts','buildSrc/settings.gradle.kts') }}
+
+      - name: Setup Gradle
+        uses: gradle/actions/setup-gradle@3f131e8634966bd73d06cc69884922b02e6faf92 # v6.2.0
+        with:
+          cache-encryption-key: ${{ secrets.GRADLE_ENCRYPTION_KEY }}
+
+      - name: Check Java 8 API compatibility
+        run: |
+          ./gradlew java8ApiCompatibility \
+            --init-script .github/gradle/java8-api-compatibility.init.gradle.kts \
+            --no-configuration-cache \
+            -Dorg.gradle.configureondemand=false