问题标签 [maven-javadoc-plugin]

For questions regarding programming in ECMAScript (JavaScript/JS) and its various dialects/implementations (excluding ActionScript). Note JavaScript is NOT the same as Java! Please include all relevant tags on your question; e.g., [node.js], [jquery], [json], [reactjs], [angular], [ember.js], [vue.js], [typescript], [svelte], etc.

0 投票
1 回答
2309 浏览

java - 由于未解决的依赖关系,Maven Javadoc aggregate-jar 插件失败

我有一个多模块 Maven 项目,我在其中运行 maven-javadoc-plugin 来生成 javadoc。在我的父 pom.xml 中,我定义了插件构建如下:

当我运行mvn clean install构建失败并出现未解决的依赖项时,但我看到以下警告:

[警告] 依赖项:[my.application:my-module:jar:1.7.1] 无法解析,但已在反应器中找到(可能是快照)。此依赖项已从 Javadoc 类路径中排除。您应该在执行 mvn install 后重新运行 javadoc。

由于我目前正在构建 my-module 1.7.1,因此我假设 Maven 会检测到这一点并在构建 my-module 后运行聚合 jar,但由于某种原因,它希望 my-module 已经安装在 repo 中。

我的 Maven 版本是 3.0.4。请记住,我是 Maven 构建的新手,所以这可能是一个非常简单的问题,但我找不到任何答案。

一些观察:

  • 如果我在mvn clean install没有 javadoc 插件aggregate-jar目标的情况下首次运行,则构建成功
  • javadoc 插件aggregate目标运行良好。
  • 这个错误完全是我的问题,但应该在 Maven 3 (2010) 中得到解决
0 投票
1 回答
356 浏览

maven-3 - Maven 为一个子模块生成 javadoc

我有一个带有子模块的 Maven 项目。

是否可以在根 pom 上运行:

并构建所有项目(子模块)但仅为其中一个子模块生成 javadoc?因为我只对发布其中一个的 javadoc 感兴趣。

我的 pom.xml 包含 maven-javadoc-plugin。

谢谢。

0 投票
1 回答
1554 浏览

maven - Maven JavaDoc Plugin 通过提供 Source 路径

以 maven javadoc:javadoc 运行目标时无法生成 Javadoc。由于maven项目中没有源代码。我直接传递svn url。是否正确,如果我错了请纠正我

0 投票
2 回答
982 浏览

java - 由于 StringIndexOutOfBoundsException 导致的 maven-javadoc-plugin 失败

跑步时总是有StringIndexOutOfBoundsException问题mvn javadoc:javadoc。有人知道这个错误吗?以下是完整的堆栈跟踪:

笔记

  1. 是的,我正在使用 eclipse 编译器
  2. 使用 Eclipse 编译器而不是 javac 导致 javadoc 崩溃的问题的答案无济于事
  3. 现在我切换到java编译器,但它仍然不起作用
  4. 这是一个在其上运行 javadoc 时将失败的单个 java 文件(可以编译):https ://github.com/greenlaw110/java-tool/blob/master/src/main/java/org/osgl/ _.java
  5. 具有循环依赖关系的 pom.xml 问题与此问题无关在 Aleksandr 的回答之后删除循环依赖项确实使项目能够构建,甚至能够使用“mvn package -Pdist”构建,但它并不能解决 javadoc 问题。您可以构建和生成 javadoc 的原因是我已经删除了带有<excludePackageNames>org.osgl:org.osgl.util</excludePackageNames>. 尝试将该行从 pom.xml 中取出并mvn clean package -Pdist再次运行以重现 javadoc 问题
  6. 我选择作为underscore.js项目_之后的类名。它用于将一些常见的实用程序聚合到一个类似元的命名空间中。对于不喜欢的人,只需使用替换,因为他们互相别名Osgl_
  7. 在我将项目克隆到数字海洋上的 linux 盒子中之后,它确实取得了成功,这真的很奇怪。我的 Windows 开发机器一定有问题!
  8. 问题解决了!删除循环依赖确实解决了这个问题。我的猜测是循环依赖带回了旧的 osgl-tool pom.xml 版本,它使用 eclipse 编译代码并与 javadoc 冲突
0 投票
0 回答
473 浏览

java - 正确生成指向外部库的 javadocs 链接

我开发了一个 Java 库,它使用了我也开发的一些其他库。所有这些都在线发布并使用 Maven 进行管理。

我的问题涉及在生成的 Javadocs 中正确包含链接。例如,如果我的库中的一个类扩展了各种接口,那么指向这些类的链接只会出现在我项目中的接口中。

然后,我的问题是:如何指示 maven 生成 javadocs,以便正确解决项目外部类的链接(可在线获取)?

0 投票
1 回答
460 浏览

java - Maven Javadoc 报告:聚合和检测链接

在 Maven 站点构建中,我想生成一个聚合的 Javadoc 报告,其中包含指向其他 Javadocs 的链接(detectLinks = true)。

在我在报告部分定义的父 POM 之一中:

多模块聚合器项目的有效 POM 报告部分是:

尽管如此,detectLinks 仅适用于单个 Javadoc 报告,而不适用于聚合的 Javadoc 报告。

如何为聚合的 Javadoc 报告启用检测链接?

0 投票
1 回答
1267 浏览

maven - Maven:禁用多模块项目中单个模块的 javadoc 生成

我有一个大型多模块项目,我想加快构建速度。

我已经在 pom.xml 的构建部分中添加了这个(属于我不想要 javadoc 的模块)

但它禁用了所有模块的 javadoc 生成。

我的配置在“执行”标签内,所以它不应该是全局插件配置,而是显示为全局的?

我在配置 Maven 方面相当新,所以欢迎任何建议!

0 投票
0 回答
112 浏览

maven - Gradle 等同于 Maven javadoc:fix

是否有任何用于 gradle 的插件,其性能类似于 maven 的mvn javadoc:fix. 如果有这样的插件,创建 javadoc 会很容易。

0 投票
1 回答
2691 浏览

maven-3 - 将 javadocs 附加到 Maven 部署

描述

我想通过一个mvn clean deploy.

第一次尝试

我找到的示例在默认阶段(包)使用此 POM 提取生成 javadoc:

这对我来说并不完美,因为即使是简单的mvn clean install.

当前状态

我的想法是在执行中指定部署阶段:

但问题是部署是在生成 javadocs 之前完成的,所以 nexus 只接收库......

如果我强制 deploy:deploy 阶段在 javadoc 阶段之后执行,我有 2 个 deploy 阶段,第一个只发送 lib,第二个可以发送 lib+javadoc,因为 lib 已经发送。

构建的摘录(SNAPSHOT Vs RELEASE):

SNAPSHOT:上传2次快照没问题

RELEASE : 不允许重新部署

我怎样才能做到这一点而不必创建特定的构建配置文件?

谢谢。

0 投票
1 回答
107 浏览

maven - 默认情况下应该跳过 Maven javadoc 插件,但应该能够在需要时执行

我想maven-javadoc-pluginmvn clean install命令期间默认跳过,所以我添加<skip>true<skip>pom.xml 但我希望它在需要时执行,所以我正在尝试类似 mvn clean install -Dmaven.javadoc.skip=false 但它似乎用它覆盖这个设置pom.xml而不执行javadoc插件。

我能做些什么来解决这个问题?