Я использую maven с плагином jacoco для генерации метрик покрытия кода. У меня возникли трудности с настройкой плагина surefire с параметрами java, требуемыми плагином jacoco. Я уже видел некоторые ответы об этом на Stack Overflow, но что-то не работает для меня.
У меня есть проект с несколькими модулями, и один из моих модулей настраивает плагин surefire следующим образом:
foo/pom.xml
:
<plugins>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-surefire-plugin</artifactId>
<configuration>
<argLine>-XX:MaxPermSize=512m</argLine>
</configuration>
</plugin>
</plugins>
Это работает как ожидалось.
Теперь я хочу включить jacoco для получения метрик покрытия кода, поэтому я добавил профиль CodeCoverage, который обрабатывает всю конфигурацию jacoco:
parent/pom.xml
:
<profile>
<id>CodeCoverage</id>
<build>
<pluginManagement>
<plugins>
<plugin>
<groupId>org.jacoco</groupId>
<artifactId>jacoco-maven-plugin</artifactId>
<executions>
<execution>
<id>jacoco-initialize</id>
<goals><goal>prepare-agent</goal></goals>
<configuration>
<propertyName>surefire.argLine</propertyName>
</configuration>
...
</execution>
<executions>
</plugin>
</plugins>
</pluginManagement>
</build>
</profile>
Здесь видно, что если указан профиль CodeCoverage, то плагин jacoco настроен на использование свойства surefire.argLine
, и это свойство используется для настройки argLine
для плагина surefire.
Затем я обновил файл pom.xml для модуля foo, чтобы использовать свойство surefire.argLine
, сгенерированное плагином jacoco:
foo/pom.xml
:
<plugins>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-surefire-plugin</artifactId>
<configuration>
<argLine>${surefire.argLine} -XX:MaxPermSize=512m</argLine>
</configuration>
</plugin>
</plugins>
Этот подход указан в документации плагина jacoco (см. [1]).
Когда я создаю модуль foo с профилем CodeCoverage, я вижу следующее:
[foo] $ mvn clean install -X -PCodeCoverage
...
[INFO] --- jacoco-maven-plugin:0.7.0.201403182114:prepare-agent (jacoco-initialize) @ foo ---
[INFO] surefire.argLine set to -javaagent:...\\org.jacoco.agent\\0.7.0.201403182114\\org.jacoco.agent-0.7.0.201403182114-runtime.jar=destfile=...\foo\\\target\\coverage-reports\\jacoco-ut.exec
...
[DEBUG] Configuring mojo 'org.apache.maven.plugins:maven-surefire-plugin:2.13:test' with basic configurator -->
[DEBUG] (s) argLine = -javaagent:...\\org.jacoco.agent\\0.7.0.201403182114\\org.jacoco.agent-0.7.0.201403182114-runtime.jar=destfile=...\\foo\\target\\coverage-reports\\jacoco-ut.exec -XX:MaxPermSize=512m
...
[INFO] --- jacoco-maven-plugin:0.7.0.201403182114:report (jacoco-site) @ foo ---
[INFO] Analyzed bundle 'Foo' with 59 classes`
Итак, выполняется jacoco-плагин, создается свойство surefire.argLine
, argLine
для плагина surefire использует свойство surefire.argLine
и локальный аргумент MaxPermSize
, и создается файл target\code-coverage\jacoc-ut-exec
, так как ожидается.
Однако, если я не использую профиль CodeCoverage, я получаю сообщение об ошибке, потому что свойство ${surefire.argLine}
(используемое в foo/pom.xml
) не создано плагином jacoco и не определено нигде:
[foo] $ mvn clean install -X
...
[DEBUG] Configuring mojo 'org.apache.maven.plugins:maven-surefire-plugin:2.13:test' with basic configurator -->
[DEBUG] (s) argLine = ${surefire.argLine} -XX:MaxPermSize=512m
...
Error: Could not find or load main class ${surefire.argLine}`
Sinec плагин jacoco не был вызван, нет свойства surefire.argLine
, следовательно, ошибка.
Итак, я возвращаюсь к parent/pom.xml
и создаю это свойство без начального значения:
parent/pom.xml
:
<properties>
<surefire.argLine></surefire.argLine>
</properties>
Теперь, когда я создаю модуль foo без использования профиля CodeCoverage, я не получаю ошибок:
[foo] $ mvn clean install -X
...
[DEBUG] Configuring mojo 'org.apache.maven.plugins:maven-surefire-plugin:2.13:test' with basic configurator -->
[DEBUG] (s) argLine = -XX:MaxPermSize=512m
...
[INFO] BUILD SUCCESS`
Правило верной веры теперь корректно (с использованием пустого свойства surefire.argLine
) и не существует каталога target\code-coverage
, как ожидалось.
Итак, теперь я возвращаюсь к генерации метрик кода, используя профиль CodeCoverage:
[foo] $ mvn clean install -X -PCodeCoverage
...
[INFO] --- jacoco-maven-plugin:0.7.0.201403182114:prepare-agent (jacoco-initialize) @ foo ---
[INFO] surefire.argLine set to -javaagent:...\\org.jacoco.agent\\0.7.0.201403182114\\org.jacoco.agent-0.7.0.201403182114-runtime.jar=destfile=...\\foo\\target\\coverage-reports\\jacoco-ut.exec
...
[DEBUG] Configuring mojo 'org.apache.maven.plugins:maven-surefire-plugin:2.13:test' with basic configurator -->
[DEBUG] (s) argLine = -XX:MaxPermSize=512m
...
[INFO] --- jacoco-maven-plugin:0.7.0.201403182114:report (jacoco-site) @ foo ---
[INFO] Skipping JaCoCo execution due to missing execution data file:...\foo\target\coverage-reports\jacoco-ut.exec
Здесь можно заметить, что подключен jacoco-плагин и задает свойство surefire.argLine
, но свойство surefire.argLine
с пустым значением, определенным в файле parent/pom.xml
, фактически используется для создания argline для плагина surefire.
В результате нет файла jacoco-ut.exec
и no target\code-coverage
, когда я использую профиль CodeCoverage.
Я не уверен, что я делаю неправильно здесь. Я объявляю свойство argLine
, как было предложено в документации jacoco, и использую его, когда плагин surefire должен указать дополнительный аргумент. Другие ответы на Qaru предлагают создать свойство с тем же именем, что и свойство jacoco argLine, чтобы обрабатывать случай, когда jacoco не вызывается.
Любые предложения?
изменить
Возможно, одним из решений является явно объявить свойство surefire.argLine
в профиле CodeCoverage и забыть об использовании argLine
плагина jacoco:
<profile>
<id>CodeCoverage</id>
<properties>
<surefire.argLine>-javaagent:${jacoco.agent.jar}=destfile=${jacoco.report.path}</surefire.argLine>
</properties>
<build>
<plugins>
<plugin>
<groupId>org.jacoco</groupId>
<artifactId>jacoco-maven-plugin</artifactId>
<executions>
<execution>
<id>jacoco-initialize</id>
<goals>
<goal>prepare-agent</goal>
</goals>
<!-- no longer specifying 'argLine' for jacoco plugin ... -->
</execution>
<executions>
</plugin>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-surefire-plugin</artifactId>
<configuration>
<!-- ... instead the arg line is configured explicitly for surefire plugin. -->
<argLine>${surefire.argLine}</argLine>
</configuration>
</plugin>
</plugins>
</plugin>
</build>
Это создаст свойство surefire.argLine, чтобы использовать java-агент, требуемый плагином jacoco, и настроить плагин surefire для использования этого свойства для своих аргументов JVM. Плагин jacoco теперь создаст свойство argLine, но это будет проигнорировано. Это не изящное решение (поскольку я делаю предположения о том, как работает плагин jacoco, и это может измениться в будущей версии).
изменить
Свойство jacoco.agent.jar
также должно быть установлено путем указания его местоположения в локальном репозитории (не уверен, является ли это надежным) или с помощью плагина зависимостей для копирования jaroco agent jar в локальный каталог сборки:
<profile>
<id>CodeCoverage</id>
<properties>
<jacoco.agent.jar>${project.build.directory}/jacoco-agent.jar</jacoco.agent.jar>
...
</project>
<build>
...
<plugins>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-dependency-plugin</artifactId>
<executions>
<execution>
<id>download-jacoco-agent</id>
<phase>process-test-resources</phase>
<goals>
<goal>copy</goal>
</goals>
<configuration>
<artifactItems>
<artifactItem>
<groupId>org.jacoco</groupId>
<artifactId>org.jacoco.agent</artifactId>
<version>${jacoco.version}</version>
<classifier>runtime</classifier>
<outputDirectory>${project.build.directory}</outputDirectory>
<destFileName>jacoco-agent.jar</destFileName>
</artifactItem>
</artifactItems>
</configuration>
</execution>
</executions>
</plugin>
</plugins>
</build>
</profile>
изменить
Не уверен, что использование плагина зависимостей является правильным подходом или указывает на артефакт jacoco-агента в локальном репозитории:
<profile>
<id>CodeCoverage</id>
<properties>
<jacoco.agent.jar>${settings.localRepository}/org/jacoco/org.jacoco.agent/${jacoco.version}/org.jacoco.agent-${jacoco.version}-runtime.jar</jacoco.agent.jar>
</properties>
...
</profile>
Это проще и не требует копирования артефакта в локальный каталог сборки, но является хрупким: изменения в макете репозитория нарушают это.
[1] http://www.eclemma.org/jacoco/trunk/doc/prepare-agent-mojo.html