java - Lombok Maven javadoc :aggregate report with generated sources

Question

我有一个用 Maven 构建的多模块 java 项目，我想用 javadoc:aggregate 生成 javadocs。项目结构如下:

parent
├─lomboklib
└─other

我也在使用 Project Lombok在项目中生成一些方法。通过首先运行 delombok，我已成功将其配置为与单个模块一起使用与 Lombok maven plugin .对于单个模块(lomboklib)，这将在

中生成源代码

target/generated-sources/delombok

然后由 ma​​ven-javadoc-plugin 和 javadoc 工具处理。这最初是在 This SO question 中解决的。 .

如何配置 javadoc:aggregate 报告以同时使用生成的源？

我已经在 Github 中的所有模块定义中建立了一个问题沙盒。 .理想情况下，我应该能够运行

mvn clean compile javadoc:aggregate

在父项目中，编译整个项目并获取整个项目的 javadocs。

Answer 1

我创建了一个解决方法构建配置，它将从生成的源创建聚合的 javadocs，尽管调用顺序有两个步骤:

mvn package
mvn -N pre-site

构建配置现已发布在 Github .当前版本仅支持深度为一的项目树，但当然可以修改。它的工作原理是收集父 target 目录下的依赖项，然后运行包含的 Ant 脚本。

最后，如果在 Jenkins 下运行，mvn -N pre-site 可以通过 Execute shell post 步骤在同一个作业中调用。在我们的 Jenkins 版本中发布 javadocs 需要使用构建后操作“使用来自另一个项目的发布者”。