如何在 Eclipse 中为 Gradle 依赖项附加 Javadoc？

Question

我的 Gradle 项目正在从文件中提取一些 jar 依赖项，如下所示：

dependencies {
    compile fileTree(dir: 'lib', include: '*.jar')
}

我已将其中一个依赖项的 Javadoc 下载为 zip 文件，如何在 Eclipse 中添加 Javadoc？

当我右键单击 Gradle 依赖项并尝试添加 Javadoc 时，我看到：

当前类路径条目属于容器“Gradle Dependencies (persisted)”，它不允许用户修改其条目上的 Javadoc 位置。

Answer 1

您必须通过eclipse闭包添加 javadoc zip。可以使用以下代码来实现

eclipse {
    classpath {
        file {
            whenMerged { cp ->
                // Add sources to a classpath entry
                def fileReferenceFactory = new org.gradle.plugins.ide.eclipse.model.internal.FileReferenceFactory()

                def entry = cp.entries.find{ entry -> entry.path.endsWith('$YOUR_JAR.jar') }
                // add javadoc jar
                entry.javadocPath = fileReferenceFactory.fromPath(file('$JAVADOC_FOLDER/$JAVADOC_FILE.zip'))
            }
        }
    }
}

顺便提一句。我建议添加 a，*-sources.jar因为如果可能的话，这也会使 javadoc 提示可用。这可以使用上面的代码来完成

// add sources jar
entry.sourcePath = fileReferenceFactory.fromPath(file('$SOURCES_FOLDER/$SOURCE_FILE.jar')

代替entry.javadocPath。