我正在使用 Maven Javadoc 插件,如下所示
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-javadoc-plugin</artifactId>
<version>3.1.1</version>
<executions>
<execution>
<id>attach-javadocs</id>
<goals>
<goal>jar</goal>
</goals>
</execution>
</executions>
</plugin>
我安装了多个 JDK 版本,并且希望能够使用其中任何一个版本构建项目。上述配置在 Java 8 上运行良好,但在 Java 11 上失败并出现以下错误
未能执行目标
org.apache.maven.plugins:maven-javadoc-plugin:3.1.1:jar
(attach-javadocs) 在项目上...: MavenReportException: Error while
生成 Javadoc:无法找到 javadoc 命令:环境
变量 JAVA_HOME 未正确设置。
显而易见的解决方案是设置 JAVA_HOME。但正如我提到的,我有多个版本的 JDK,因此每次我想使用另一个版本时都重新配置 JAVA_HOME 一点也不方便。
另一种解决方案(来自无法找到 javadoc 命令 - maven https://stackoverflow.com/questions/13961615/unable-to-find-javadoc-command-maven)就是在插件中添加如下配置:
<configuration>
<javadocExecutable>${java.home}/bin/javadoc</javadocExecutable>
</configuration>
这使得它可以与 Java 11 一起使用,但会破坏 Java 8,因为javadoc
位置是${java.home}/../bin/javadoc
在这种情况下。
理想情况下我总是想使用javadoc
从 Maven 使用的 java 可执行文件所在的目录,但我还没有找到使用 Maven Javadoc Plugin 执行此操作的方法。
Maven 配置文件 https://maven.apache.org/guides/introduction/introduction-to-profiles.html或许能帮上忙。
将这样的内容添加到您的 POM 中。
<profiles>
<profile>
<id>jdk-8-config</id>
<activation>
<jdk>1.8</jdk>
</activation>
<properties>
<javadocExecutable>${java.home}/../bin/javadoc</javadocExecutable>
</properties>
</profile>
<profile>
<id>jdk-11-config</id>
<activation>
<jdk>11</jdk>
</activation>
<properties>
<javadocExecutable>${java.home}/bin/javadoc</javadocExecutable>
</properties>
</profile>
</profiles>
JDK 范围也是可能的,请阅读链接文档中的更多信息。
Maven 将选择用于运行自身的 Java 版本、激活正确的配置文件并定义正确的属性。
一个警告 - 通常我们构建JAVA_HOME
设置,或者通过 Jenkins 可以配置为定义JAVA_HOME
每份工作。这种方法在这些情况下效果很好。
您还可以研究 Maven 工具链。我对这些没有任何经验,除了阅读之外,它们还有助于更轻松地定义各种机器上的工具位置。
本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系:hwhale#tublm.com(使用前将#替换为@)