此bounty已结束,回答此问题可获得+50声望奖励,奖励宽限期18小时后结束,Geoffrey De Smet希望引起更多关注此问题。
我正在构建一个附带maven-javadoc-plugin的Maven项目。
更新到maven-javadoc-plugin 3.5.0后,在运行jar
目标时出现此错误:
Execution build-javadoc-jar of goal org.apache.maven.plugins:maven-javadoc-plugin:3.5.0:jar failed:
Unable to derive module descriptor for /.../rewrite-gradle-7.38.0.jar
PluginSpec.class found in top-level directory (unnamed package not allowed in module)
我不控制第三方的依赖性,也不使用JPMS。
有没有办法告诉javadoc工具忽略模块命名?
Source code that reproduces the problem:
<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 https://maven.apache.org/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0</modelVersion>
<groupId>reproducer</groupId>
<artifactId>reproducer</artifactId>
<version>0.1</version>
<build>
<pluginManagement>
<plugins>
<plugin>
<artifactId>maven-compiler-plugin</artifactId>
<version>3.11.0</version>
</plugin>
<plugin>
<artifactId>maven-jar-plugin</artifactId>
<version>3.3.0</version>
<configuration>
<archive>
<manifestEntries>
<Automatic-Module-Name>org.acme.reproducer</Automatic-Module-Name>
</manifestEntries>
</archive>
</configuration>
</plugin>
<plugin>
<artifactId>maven-javadoc-plugin</artifactId>
<version>3.5.0</version><!-- Regression from 3.2.0 which did not have the problem-->
</plugin>
</plugins>
</pluginManagement>
<plugins>
<plugin>
<artifactId>maven-javadoc-plugin</artifactId>
<executions>
<execution>
<goals>
<goal>jar</goal>
</goals>
</execution>
</executions>
</plugin>
</plugins>
</build>
<dependencyManagement>
<dependencies>
<dependency>
<groupId>org.openrewrite.recipe</groupId>
<artifactId>rewrite-recipe-bom</artifactId>
<version>1.17.0</version>
<type>pom</type>
<scope>import</scope>
</dependency>
</dependencies>
</dependencyManagement>
<dependencies>
<dependency>
<groupId>org.openrewrite</groupId>
<artifactId>rewrite-gradle</artifactId>
</dependency>
</dependencies>
</project>
1条答案
按热度按时间svmlkihl1#
要禁用模块描述符的生成,避免出现错误,可以配置maven-javadoc-plugin使用**--add-modules选项,参数列表为空,该选项指示javadoc工具忽略JPMS配置。
为此,请在maven-javadoc-plugin**中添加以下配置:
完整的插件配置如下所示:
通过这种配置,***maven-javadoc-plugin***应该能够生成Javadoc jar,而无需尝试为有问题的依赖项派生模块描述符。