build: fix javadoc build tasks

Author: gudzpoz

.github/workflows/build-natives.yml

@@ -317,16 +317,16 @@ jobs:
 
       - name: Release example
         uses: softprops/action-gh-release@v1
-        if: ${{ github.ref == 'refs/heads/main' && startsWith(github.ref, 'refs/tags/') }}
+        if: ${{ startsWith(github.ref, 'refs/tags/') }}
         with:
           draft: true
           files: example/build/libs/example-all.jar
 
       - name: Release?
-        if: ${{ github.ref == 'refs/heads/main' && startsWith(github.ref, 'refs/tags/') }}
+        if: ${{ startsWith(github.ref, 'refs/tags/') }}
         run: echo "IS_RELEASE=true" >> $GITHUB_ENV
       - name: Release to Maven Central
-        if: ${{ github.ref == 'refs/heads/main' }}
+        if: ${{ github.ref == 'refs/heads/main' || startsWith(github.ref, 'refs/tags/') }}
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
           MAVEN_USERNAME: ${{ secrets.MAVEN_USERNAME }}

build.gradle

@@ -33,12 +33,6 @@ subprojects { it ->
     }
 }
 
-ext {
-    jdk = JavaVersion.current().majorVersion
-    jdkJavadoc = "https://docs.oracle.com/javase/8/docs/api/"
-    println "JDK Javadoc link for this build is ${rootProject.jdkJavadoc}"
-}
-
 apply from: 'jacoco.gradle'
 
 configure([
@@ -55,6 +49,15 @@ configure([
     apply from: project(':').file('publish.gradle')
 }
 
+
+apply plugin: 'java'
+java {
+    toolchain {
+        languageVersion = JavaLanguageVersion.of(17)
+    }
+}
+
+// Javadoc configs. See javadoc.gradle.
 tasks.register('allJavadoc', Javadoc) {
     Set<String> projects = [
             'lua51',
@@ -78,11 +81,17 @@ tasks.register('allJavadoc', Javadoc) {
     destinationDir = layout.buildDirectory.file("docs/javadoc").get().asFile
 
     title = "${project.name} $version"
-    options.header = "$project.name"
-    options.encoding = 'UTF-8'
-    options.memberLevel = JavadocMemberLevel.PROTECTED
-    options.links([
-            rootProject.jdkJavadoc,
-            "https://javadoc.io/doc/com.badlogicgames.jnigen/jnigen-loader/latest/",
-    ] as String[])
+    (options as StandardJavadocDocletOptions).with {
+        header = "$project.name"
+        encoding = 'UTF-8'
+        memberLevel = JavadocMemberLevel.PROTECTED
+        linksOffline(
+                "https://docs.oracle.com/javase/8/docs/api/",
+                "https://docs.oracle.com/en/java/javase/25/docs/api/",
+        )
+        linksOffline(
+                "https://javadoc.io/doc/com.badlogicgames.jnigen/jnigen-loader/3.1.1/",
+                "https://javadoc.io/doc/com.badlogicgames.jnigen/jnigen-loader/3.1.1/",
+        )
+    }
 }

javadoc.gradle

@@ -16,23 +16,38 @@
 
 apply plugin: 'java-library'
 
+java {
+    toolchain {
+        // We generally don't care about the toolchain version as long as
+        // it is Java 8 compatible.
+        // But older Javadoc will fail because online links are moving away
+        // from package-list to element-list.
+        languageVersion = JavaLanguageVersion.of(17)
+    }
+}
+
 javadoc {
     dependsOn jar
     group = 'documentation'
     description = 'Generates aggregated Javadoc API documentation.'
 
-    title = "${project.name} $version"
-    options.header = "$project.name"
-    options.encoding = 'UTF-8'
-    options.memberLevel = JavadocMemberLevel.PROTECTED
-
-    options.links([
-            rootProject.jdkJavadoc,
-            "https://javadoc.io/doc/com.badlogicgames.jnigen/jnigen-loader/latest/",
-    ] as String[])
+    title = "${project.name} $project.version"
+    (options as StandardJavadocDocletOptions).with {
+        header = "$project.name"
+        encoding = 'UTF-8'
+        memberLevel = JavadocMemberLevel.PROTECTED
+        linksOffline(
+                "https://docs.oracle.com/javase/8/docs/api/",
+                "https://docs.oracle.com/en/java/javase/25/docs/api/",
+        )
+        linksOffline(
+                "https://javadoc.io/doc/com.badlogicgames.jnigen/jnigen-loader/3.1.1/",
+                "https://javadoc.io/doc/com.badlogicgames.jnigen/jnigen-loader/3.1.1/",
+        )
 
-    options.tags = ['apiNote:a:API Note:', 'implSpec:a:Implementation Requirements:',
-                    'implNote:a:Implementation Note:']
+        tags = ['apiNote:a:API Note:', 'implSpec:a:Implementation Requirements:',
+                'implNote:a:Implementation Note:']
+    }
 
     classpath += sourceSets.main.compileClasspath
 }

publish.gradle

@@ -22,7 +22,9 @@ afterEvaluate { project ->
                         fromResolutionResult()
                     }
                 }
+            }
 
+            withType(MavenPublication).configureEach {
                 setPom(pom, '')
             }
         }