[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

Recommended Posts

[Gradle] Générer Javadoc, y compris JavaScript dans Java 1.8.0_121 ou version ultérieure
Essayez d'appeler JavaScript en Java
Faites HelloWorld avec Java / IntelliJ / Gradle
Java, JavaScript, C # (différence d'affectation)
Générer l'URL de l'API CloudStack en Java
Bonjour tout le monde en Java et Gradle
(Limité à Java 7 ou version ultérieure) Je souhaite que vous compariez des objets dans Objects.equals
Appel de méthodes Java à partir de JavaScript exécutées en Java
Raccourci pour générer automatiquement javadoc dans IntelliJ
Comment déboguer à distance Java 9 ou version ultérieure
Utilisez "Rhino" qui exécute JavaScript en Java
Générer de la documentation DB à l'aide de SchemaSpy dans Gradle
[Java 7 ou version ultérieure] Empêcher l'omission de la suppression de fichiers temporaires
Exemple de contre-mesure NullPointerException (facultatif) pour Java8 ou version ultérieure
[Gradle] Opérations de construction souvent effectuées dans les projets Java
Analyse de code statique par Checkstyle avec Java + Gradle
Différences dans l'écriture des classes Java, C # et Javascript
Conseils Java - Créez un projet Spring Boot avec Gradle
Générer OffsetDateTime à partir de Clock et LocalDateTime en Java