Как настроить кодировку в Maven?
Когда я запускаю maven install
в моем мультимодульном проекте maven, я всегда получаю следующий вывод:
[WARNING] File encoding has not been set, using platform encoding UTF-8, i.e. build is platform dependent!
Итак, я немного искал googled, но все, что я могу найти, это то, что я должен добавить:
<properties>
<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
</properties>
... в мой pom.xml. Но он уже существует (в родительском pom.xml
).
Настройка <encoding>
для плагина maven-resources или плагина maven-compiler также не исправляет его.
Так в чем проблема?
Ответы
Ответ 1
ОК, я нашел проблему.
Я использую некоторые плагины отчетности. В документации к файлу failafe-maven-plugin (http://maven.apache.org/plugins/maven-failsafe-plugin/integration-test-mojo.html) я обнаружил, что конфигурация <encoding>
- конечно - использует ${project.reporting.outputEncoding}
по умолчанию. Поэтому я добавил свойство как дочерний элемент элемента project
, и теперь все в порядке:
<properties>
<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
<project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
</properties>
См. также http://maven.apache.org/general.html#encoding-warning
Ответ 2
Это было бы в дополнение к предыдущему, если кто-то встретит проблему со скандальными буквами, которые не решены с помощью вышеприведенного решения.
Если исходные файлы java содержат скандальные буквы, их нужно правильно интерпретировать с помощью Java, используемой для компиляции. (например, скандические буквы, используемые в константах)
Даже если файлы хранятся в UTF-8, а Maven настроен на использование UTF-8, системная Java, используемая Maven, по-прежнему будет использовать системную систему по умолчанию (например, в Windows: cp1252).
Это будет видно только при выполнении тестов через maven (возможно, печать значений этих констант в тестах. Печатные скандические буквы будут отображаться как "<? > " )
Если не проверено правильно, это приведет к повреждению файлов классов в качестве результата компиляции и останется незамеченным.
Чтобы предотвратить это, вы должны установить Java, используемую для компиляции, для использования кодировки UTF-8.
Недостаточно иметь настройки кодирования в maven pom.xml, вам нужно установить переменную среды:
JAVA_TOOL_OPTIONS = -Dfile.encoding = UTF8
Кроме того, если вы используете Eclipse в Windows, вам может потребоваться установить кодировку, используемую в дополнение к этому (если вы запускаете отдельный тест через eclipse).
Ответ 3
Если вы объедините ответы выше, наконец, pom.xml, настроенный для UTF-8, должен выглядеть так.
pom.xml
<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0</modelVersion>
<groupId>YOUR_COMPANY</groupId>
<artifactId>YOUR_APP</artifactId>
<version>1.0.0-SNAPSHOT</version>
<properties>
<project.java.version>1.8</project.java.version>
<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
<project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
</properties>
<dependencies>
<!-- Your dependencies -->
</dependencies>
<build>
<plugins>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-compiler-plugin</artifactId>
<version>3.7.0</version>
<configuration>
<source>${project.java.version}</source>
<target>${project.java.version}</target>
<encoding>${project.build.sourceEncoding}</encoding>
</configuration>
</plugin>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-resources-plugin</artifactId>
<version>3.0.2</version>
<configuration>
<encoding>${project.build.sourceEncoding}</encoding>
</configuration>
</plugin>
</plugins>
</build>
</project>
Ответ 4
Попробуйте следующее:
<project>
...
<build>
<plugins>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-resources-plugin</artifactId>
<version>2.7</version>
<configuration>
...
<encoding>UTF-8</encoding>
...
</configuration>
</plugin>
</plugins>
...
</build>
...
</project>