Настройте сборку gradle для подавления предупреждений консоли Javadoc - PullRequest
Новая
       26

Настройте сборку gradle для подавления предупреждений консоли Javadoc

0 голосов
/ 06 сентября 2018

Я настраиваю сборку Gradle, используя плагин javadoc . Мне удалось предотвратить сбой сборки из-за ошибок javadoc lint, но все еще есть сотни строк вывода на консоль для тех ошибок lint, которые меня не волнуют.

Есть идеи, как подавить эти сообщения консоли, связанные с линтированием?

Пример вывода, о котором я говорю (но экраны и экраны заполнены): 

/home/user/projects/my-project/src/main/java/my/package/MyObject.java:89: warning: no description for @param
     * @param myParam
       ^
/home/user/projects/my-project/src/main/java/my/package/MyObject.java:90: warning: no description for @return
     * @return
       ^
/home/user/projects/my-project/src/main/java/my/package/MyObject.java:101: warning: no @param for itemId
    List<MyItem> getMyItems(Long itemId);
                        ^

Я должен уточнить, я ищу решение в конфигурации сборки, а не флаг, который нужно передавать команде gradle build каждый раз, когда я ее запускаю.

Ответы [ 2 ]

0 голосов
/ 06 сентября 2018

Предупреждения / ошибки могут быть подавлены с помощью опции Xdoclint: 

javadoc.options.addStringOption('Xdoclint:none', '-quiet')

Это покажет несколько худших предупреждений, но устранит подавляющее большинство из них.

См .: https://blog.joda.org/2014/02/turning-off-doclint-in-jdk-8-javadoc.html

Кроме того, согласно документации javadoc для gradle, вы можете напрямую установить уровень выходного сигнала (VERBOSE или QUIET). Проблема в том, что QUIET по-прежнему отображает все предупреждения и сообщения об ошибках, и, похоже, все равно является поведением по умолчанию.

0 голосов
/ 06 сентября 2018

Вы можете установить outputLevel внутри блока options задачи javadoc, но, к сожалению, даже уровня QUIET вам будет недостаточно

Отключает сообщения без ошибок и предупреждений, оставляя только появляются предупреждения и ошибки, облегчающие их просмотр.

Так что, используя предоставленные настройки задачи, я думаю, что вы застряли.

Другое решение: исправьте проблемы с Javadoc.

...