Как установить кодировку символов для Groovydoc в Gradle?
У меня есть Groovy-код с кодировкой UTF-8, и мне нужно, чтобы сгенерированный Groovydoc HTML использовал его. Но как мне настроить это в Gradle?
2 ответа
Инструмент Groovydoc, а следовательно, и Gradle's Groovydoc задача, в настоящее время не поддерживает encoding вариант. Настройка file.encoding Системное свойство для Gradle JVM должно работать. Вы можете сделать это через GRADLE_OPTS переменная среды, или путем добавления systemProp.file.encoding=utf-8 в gradle.properties,
Удивительно, но эта проблема все еще актуальна после шести лет и множества версий Gradle:)
Я столкнулся с этой проблемой, когда добавил символы Unicode (а именно стрелки) в свой обзорный файл Groovydoc и попытался собрать Groovydoc на компьютере с кодировкой Windows-1251 по умолчанию.
Начиная с Gradle 4.10.2, можно использовать дополнительные параметры для Groovydoc, предоставляя собственную реализацию AntGroovydoc к groovydoc задание через его setAntGroovydoc метод. Но так как этот метод считается внутренним, это было бы немного хакерским решением. Кроме того, AntGroovydoc явно не предназначен для расширения, и для его подклассов потребуется много копий-вставок из исходного класса.