[Gradle] Generieren Sie Javadoc einschließlich JavaScript in Java 1.8.0_121 oder höher

Dieser Inhalt ist für diejenigen gedacht, die JavaScript in Gradles javadoc.options.bottom usw. festgelegt haben.

In Java 1.8.0_121 lässt der Befehl javadoc standardmäßig kein JavaScript mehr zu. http://www.oracle.com/technetwork/java/javase/8u121-relnotes-3315208.html

The javadoc tool will now reject any occurrences of JavaScript code in the javadoc documentation comments and command-line options, unless the command-line option, --allow-script-in-comments is specified.

Das Ausführen der Javadoc-Task führt zu einem Fehler.

$ ./gradlew javadoc
[snip]
:javadoc
javadoc: error - Argument for -bottom contains JavaScript.
Use --allow-script-in-comments to allow use of JavaScript.
1 error
:javadoc FAILED

FAILURE: Build failed with an exception.

Fügen Sie zum Aktivieren von JavaScript die Option "--allow-script-in-comments" hinzu, wie in der obigen Fehlermeldung beschrieben.

build.gradle

javadoc.options {
    def v = JavaVersion.current()
    def g = System.properties['java.version'] =~ /\d+/
    addBooleanOption '-allow-script-in-comments', v.java9Compatible || v.majorVersion == '8' && g.size() == 4 && ((g[2] as int) > 0 || (g[3] as int) >= 121)
}

Geben Sie für das erste Argument von addBooleanOption die Option ohne das führende- an. Geben Sie im zweiten Argument den booleschen Wert an, ob die Option festgelegt werden soll. Wenn Sie diese Option in einer Java-Umgebung von 1.8.0_121 oder früher angeben, tritt beim Ausführen der Javadoc-Task ein Fehler auf. Daher wird anhand der Java-Version bestimmt, ob die Option festgelegt werden soll.

das ist alles.

Referenz

Gradle Problem https://github.com/gradle/gradle/issues/1393 Implementierung von javadoc.options.addBooleanOption https://github.com/gradle/gradle/blob/master/subprojects/language-java/src/main/java/org/gradle/external/javadoc/CoreJavadocOptions.java https://github.com/gradle/gradle/blob/master/subprojects/language-java/src/main/java/org/gradle/external/javadoc/internal/JavadocOptionFile.java https://github.com/gradle/gradle/blob/master/subprojects/language-java/src/main/java/org/gradle/external/javadoc/internal/BooleanJavadocOptionFileOption.java