[Gradle] Générer Javadoc, y compris JavaScript dans Java 1.8.0_121 ou version ultérieure

Ce contenu est destiné à ceux qui ont défini JavaScript dans javadoc.options.bottom de Gradle, etc.

Dans Java 1.8.0_121, la commande javadoc n'autorise plus JavaScript par défaut. 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.

L'exécution de la tâche javadoc entraînera une erreur.

$ ./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.

Pour activer JavaScript, ajoutez l'option --allow-script-in-comments comme décrit dans le message d'erreur ci-dessus.

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)
}

Pour le premier argument de ʻaddBooleanOption, spécifiez l'option sans le début-. Dans le deuxième argument, spécifiez la valeur booléenne` pour définir l'option ou non. Si vous spécifiez cette option dans un environnement Java de 1.8.0_121 ou antérieur, une erreur se produira lors de l'exécution de la tâche javadoc, la version Java est donc utilisée pour déterminer s'il faut définir l'option.

c'est tout.

référence

Problème Gradle https://github.com/gradle/gradle/issues/1393 Implémentation de 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