3

我有一个使用 maven 作为其构建系统的多模块项目。我想为项目生成 javadocs。我愿意:

mvn -e javadoc:javadoc

当 maven 进入第一个模块(Util)时,我得到了这个:

退出代码:1 - 错误:找不到模块:Util

[错误] 无法在项目 Util 上执行目标 org.apache.maven.plugins:maven-javadoc-plugin:3.2.0:javadoc (default-cli):Javadoc 报告生成中发生错误:[错误] 退出代码:1 - 错误:找不到模块:Util [ERROR] [ERROR] 命令行是:cmd.exe /X /C "C:\Users\Warren.jdks\adopt-openjdk-11.0.7\bin\javadoc.exe @options @packages @argfile" [错误] [错误] 参考 'C:\Users\Warren\IdeaProjects\Javabot_TOS\Util\target\site\apidocs' 目录中生成的 Javadoc 文件。[ERROR] [ERROR] -> [Help 1] org.apache.maven.lifecycle.LifecycleExecutionException: 未能执行目标 org.apache.maven.plugins:maven-javadoc-plugin:3.2.0:javadoc (default-cli)在项目 Util 上:Javadoc 报告生成中发生错误:退出代码:1 - 错误:找不到模块:Util

从 Util/target/site/apidocs 目录:

argfile 读取:

'C:/Users/Warren/IdeaProjects/Javabot_TOS/Util/src/main/java/module-info.java'

选项内容如下:

m2/repository/javax/xml/stream/stax-api/1.0-2/stax-api-1.0-2.jar;C:/Users/Warren/.m2/repository/relaxngDatatype/relaxngDatatype/20020414/relaxngDatatype-20020414。 jar;C:/Users/Warren/.m2/repository/com/sun/xsom/xsom/20140925/xsom-20140925.jar;C:/Users/Warren/.m2/repository/org/apache/ant/ant/ 1.10.3/ant-1.10.3.jar;C:/Users/Warren/.m2/repository/junit/junit/4.12/junit-4.12.jar' --patch-module Util='C:/Users/Warren /IdeaProjects/Javabot_TOS/Util/src/main/java' -encoding 'UTF-8' -protected --release 11 --module-source-path 'C:/Users/Warren/IdeaProjects/Javabot_TOS/Util/target/site /apidocs/src' -author -bottom '版权所有 © 2020。保留所有权利。' -charset 'UTF-8' -d 'C:/Users/Warren/IdeaProjects/Javabot_TOS/Util/target/site/apidocs' -docencoding 'UTF-8' -doctitle 'Util 5.0-devel API'

包裹内容如下:

org.javabot.util org.javabot.util org.javabot.util org.javabot.util

和 javadoc.bat 读取:

cmd.exe /X /C "C:\Users\Warren.jdks\adopt-openjdk-11.0.7\bin\javadoc.exe @options @packages @argfile"

module-info.java 文件位于 Util/src/main/java

谁能解释为什么它不起作用?

4

2 回答 2

1

要为 Maven 多模块项目生成 JavaDoc,aggregate需要使用目标(例如。mvn javadoc:aggregate

注意:根据文档,自 3.1.0 版以来,JavaDoc 聚合已更改:https ://maven.apache.org/plugins/maven-javadoc-plugin/examples/aggregate.html

于 2020-09-25T12:25:07.290 回答
0

我有同样的问题已经描述在:

带有 maven 的 Java 11/12 Javadoc 导致不生成用于测试的 Javadocs

所以重要的是以下两点:

  • 使用新的 java 版本,如 11.0.10 或更高版本 - 没有旧版本!
  • 留意我的错误报告,因为 maven-javadoc-plugin 中似乎有一个错误
于 2021-02-25T15:58:56.597 回答