有没有办法告诉 Gradle 在生成的 Javadoc 中包含依赖项 Javadoc?
Is there a way to tell Gradle to include dependencies Javadocs in generated Javadocs?
我有一个 Java 项目,我正在管理 Gradle。这样的项目将由多个相互独立开发的小型库和一个 "leaf" 项目组成,该项目的目标只是依赖于每个库的最新稳定版本,将所有内容打包在一个 fat Jar 中并提供聚合文档.
每个库都将作为单独的工件上传到 Maven Central。
为了测试这样配置的可行性,我写了一个非常简单的项目,依赖于GNU Trove4j。
我希望能够为这个项目生成一个包含我的源代码和 Trove4j 代码的 Javadoc,但到目前为止我还没有成功。
我的想法是从 Central 导入依赖项的源作为 Gradle 的 sourceSet 的一部分,但我不知道该怎么做。
实现此目的的一种方法是将您想要记录的所有依赖项添加到单独的配置中,然后将其添加到 javadoc
任务中。这是一个带有几个简单库的简单示例:
configurations {
doc {
transitive false
}
}
dependencies {
doc 'com.google.code.gson:gson:2.3.1:sources'
doc 'commons-collections:commons-collections:3.2.1:sources'
}
javadoc {
source configurations.doc.collect { zipTree(it) }
include '**/*.java'
options.addStringOption('Xdoclint:none', '-quiet')
}
我有一个 Java 项目,我正在管理 Gradle。这样的项目将由多个相互独立开发的小型库和一个 "leaf" 项目组成,该项目的目标只是依赖于每个库的最新稳定版本,将所有内容打包在一个 fat Jar 中并提供聚合文档.
每个库都将作为单独的工件上传到 Maven Central。
为了测试这样配置的可行性,我写了一个非常简单的项目,依赖于GNU Trove4j。 我希望能够为这个项目生成一个包含我的源代码和 Trove4j 代码的 Javadoc,但到目前为止我还没有成功。
我的想法是从 Central 导入依赖项的源作为 Gradle 的 sourceSet 的一部分,但我不知道该怎么做。
实现此目的的一种方法是将您想要记录的所有依赖项添加到单独的配置中,然后将其添加到 javadoc
任务中。这是一个带有几个简单库的简单示例:
configurations {
doc {
transitive false
}
}
dependencies {
doc 'com.google.code.gson:gson:2.3.1:sources'
doc 'commons-collections:commons-collections:3.2.1:sources'
}
javadoc {
source configurations.doc.collect { zipTree(it) }
include '**/*.java'
options.addStringOption('Xdoclint:none', '-quiet')
}