Como posso desativar o plug-in Maven Javadoc na linha de comando?

231

No pom.xml eu tenho uma declaração como esta

    <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-javadoc-plugin</artifactId>
        <executions>
            <execution>
                <id>attach-javadocs</id>
                <goals>
                    <goal>jar</goal>
                </goals>
            </execution>
        </executions>
    </plugin>

existe alguma maneira de desativar isso na linha de comando?

Eu sei que posso extrair isso em um perfil, mas não é isso que eu quero.

— IAdapter
fonte

438

A geração Javadoc pode ser ignorada definindo a propriedade maven.javadoc.skipcomo true [ 1 ], ou seja,

-Dmaven.javadoc.skip=true

(e não falso)

— mswientek
fonte

1

Consulte a resposta de Christoph-Tobias Schenke para obter uma abordagem a seguir com módulos filhos.

— eCoE

Este argumento também pode ser definida diretamente em Jenkins para evitar este problema (da Global MAVEN_OPTS definido no Configure System)

— Rei Midas

11

Isso não funcionou para mim, mas aprendi que quando você usa o plugin maven release, você precisa passar esse parâmetro de maneira diferente. Isso funcionou: mvn release:perform -Darguments="-Dmaven.javadoc.skip=true".

— PatS

181

Parece que a maneira simples

-Dmaven.javadoc.skip=true

não funciona com o release-plugin. neste caso, você deve passar o parâmetro como um "argumento"

mvn release:perform -Darguments="-Dmaven.javadoc.skip=true"

— Christoph-Tobias Schenke
fonte

9

Se você precisa adicionar dois argumentos que você pode separá-los com um espaço como este-Darguments="-DskipTests -Dmaven.javadoc.skip=true"

— Graham

4

Também funciona para adicioná-los à configuração do plugin release no pom.xml no nível raiz:<configuration><arguments>-DskipTests -Dmaven.javadoc.skip=true</arguments></configuration>

— nclark 11/16

1

Além disso, o skipTests tem um sabor mais forte que também ignora a compilação de testes:-Dmaven.tests.skip=true

— nclark 11/16

120

Você pode usar a maven.javadoc.skippropriedade para ignorar a execução do plug-in, passando pelo javadoc do Mojo. Você pode especificar o valor como uma propriedade Maven:

<properties>
    <maven.javadoc.skip>true</maven.javadoc.skip>
</properties>

ou como um argumento da linha de comandos -Dmaven.javadoc.skip=true:, para ignorar a geração dos Javadocs.

— Vineet Reynolds
fonte

1

Essa resposta realmente não responde à pergunta, pois nela afirma que a troca deve ser feita via linha de comando.

— Sinisha Mihajlovski

3

Esta é a solução perfeita para um projeto de vários módulos com alguns módulos que não geram nenhum javadoc e causam um erro caso contrário.

— Emmanuel Bourg

19

Adicione à configuração do plug-in de liberação no pom.xml no nível raiz:

<configuration>
    <arguments>-Dmaven.javadoc.skip=true</arguments>
</configuration>

— nclark
fonte

isso não é adequadamente da linha de comando, conforme exigido pela pergunta, mas funciona muito bem se você precisar desativar permanentemente o javadoc.

— Lorenzo Sciuto

1

Para usuários novatos do Powershell, é importante saber que '.' é um elemento sintático do Powershell, portanto, o comutador deve ser colocado entre aspas duplas:

Instalação limpa do mvn "-Dmaven.javadoc.skip = true"

— Det
fonte