Включить HTML5 Javadoc в Gradle - PullRequest
Новая
       13

Включить HTML5 Javadoc в Gradle

0 голосов
/ 07 мая 2018

Мы обновили проект Java до JDK 10. При запуске сценария сборки Javadoc выводит предупреждение: 

javadoc: warning - You have not specified the version of HTML to use.
The default is currently HTML 4.01, but this will change to HTML5
in a future release. To suppress this warning, please specify the
version of HTML used in your documentation comments and to be
generated by this doclet, using the -html4 or -html5 options.

Для построения проекта мы используем gradle . Как мы можем указать HTML 5 (-html5) в Gradle?

Пока что раздел javadoc нашего build.gradle файла довольно прост: 

javadoc {
    include 'com/company/project/pkg/*'
}

Ответы [ 2 ]

0 голосов
/ 29 августа 2018

При получении упомянутой выше ошибки для вашего проекта maven вы можете поместить следующий фрагмент в ваш pom.xml: 

       <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-javadoc-plugin</artifactId>
            <version>${javadocplugin.version}</version>
            <executions>
                <execution>
                    <id>attach-javadocs</id>
                    <goals>
                        <goal>jar</goal>
                    </goals>
                </execution>
            </executions>
            <configuration>
                <additionalOptions>-html5</additionalOptions>
            </configuration>
        </plugin>
0 голосов
/ 07 мая 2018

Это просто с options.addBooleanOption: 

javadoc {
    include 'com/company/project/pkg/*'
    options.addBooleanOption('html5', true)
}

Обратите внимание, что вы должны использовать addBooleanOption, а не addStringOption. Последний не работает без значения (например, ""), а затем создает неверную командную строку.

...