我有一个用 Maven 构建的多模块 java 项目,我想用 javadoc:aggregate
生成 javadocs。项目结构如下:
parent
├─lomboklib
└─other
我也在使用 Project Lombok在项目中生成一些方法。通过首先运行 delombok,我已成功将其配置为与单个模块一起使用与 Lombok maven plugin .对于单个模块(lomboklib),这将在
中生成源代码target/generated-sources/delombok
然后由 maven-javadoc-plugin 和 javadoc 工具处理。这最初是在 This SO question 中解决的。 .
如何配置 javadoc:aggregate
报告以同时使用生成的源?
我已经在 Github 中的所有模块定义中建立了一个问题沙盒。 .理想情况下,我应该能够运行
mvn clean compile javadoc:aggregate
在父项目中,编译整个项目并获取整个项目的 javadocs。
最佳答案
我创建了一个解决方法构建配置,它将从生成的源创建聚合的 javadocs,尽管调用顺序有两个步骤:
mvn package
mvn -N pre-site
构建配置现已发布在 Github .当前版本仅支持深度为一的项目树,但当然可以修改。它的工作原理是收集父 target
目录下的依赖项,然后运行包含的 Ant 脚本。
最后,如果在 Jenkins 下运行,mvn -N pre-site
可以通过 Execute shell post 步骤在同一个作业中调用。在我们的 Jenkins 版本中发布 javadocs 需要使用构建后操作“使用来自另一个项目的发布者”。
关于java - Lombok Maven javadoc :aggregate report with generated sources,我们在Stack Overflow上找到一个类似的问题: https://stackoverflow.com/questions/29563593/