Aconteceu comigo de vários componentes maven de um projeto herdarem um POM Parent que configura a utilização do Plugin maven-javadoc-plugin. Esse plugin varre todo o código do componente e gera os HTMLs da documentação estilo JavaDoc. No entanto, esse plugin parece demandar muitos recursos para ser executado, onerando o tempo de build. No caso de projetos com muitos componentes, isso pode inclusive significar um tempo muito grande de fila de builds para integração contínua. Para desabilitar a execução do plugin adicionei a entrada project/build/pluginManagement abaixo ao pom.xml dos componentes em questão:
<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">
...
<build>
<pluginManagement>
<plugins>
<plugin>
<artifactId>maven-javadoc-plugin</artifactId>
<configuration>
<skip>true</skip>
</configuration>
</plugin>
</plugins>
</pluginManagement>
</build>
...
</project>
|
Se você desejar ainda desabilitar esse plugin por padrão mas eventualmente gerar o JavaDoc quando for necessário, é possível colocar essa configuração de build acima dentro de um profile do Maven, bastando assim escolhê-lo no momento da execução.