编写Gradle插件时的Gradle Api源和文档

Question

如何获得集成到Eclipse项目中的gradle-api代码的源代码和Javadoc/GroovyDoc？

我正在使用Gradle构建一个我正在编写的Gradle-插件。我使用Eclipse作为这个项目的IDE，我构建这个插件的Gradle脚本使用'Eclipse'插件来生成我的Eclipse项目。此外，我正在使用Spring的用于Eclipse的Gradle插件，它从build.Gradle文件中获取所有依赖项。

此Gradle脚本的dependencies块具有

dependencies {
    compile localGroovy()
    compile gradleApi()
    // I want something like: 'compile gradleApiSources()' here
    // I want something like: 'compile gradleApiDoc()' here as well
}

当我正在学习编写Gradle插件时，如果能够看到Gradle的文档甚至实现，以帮助我了解我在做什么，那将是很有帮助的。

Answer 1

这对我在Eclipse中起作用：

plugins.withType(EclipsePlugin) {
    plugins.withType(JavaBasePlugin) {
        eclipse {
            classpath {
                file {
                    whenMerged { classpath ->
                        String gradleHome = gradle.getGradleHomeDir()
                            .absolutePath
                            .replace(File.separator, '/')
                        String gradleSourceDirectory = "${gradleHome}/src"
                        classpath.entries.each { entry ->
                            if (entry in org.gradle.plugins.ide.eclipse.model.AbstractLibrary
                                    && entry.library.path.contains('generated-gradle-jars')) {
                                entry.sourcePath =
                                    new org.gradle.plugins.ide.eclipse.model.internal.FileReferenceFactory()
                                        .fromPath(gradleSourceDirectory)
                            }
                        }
                    }
                }
            }
        }
    }
}

确保您的Gradle主页包含源目录。如果使用包装，则可以通过将包装任务中的DistributionURL更新为-all版本来完成。

您还需要停止正在运行的Gradle守护进程，否则它们将保留自己的“家”:./gradlew--stop，然后您可以继续运行任务:./gradlew eclipse

参见GRADLE-2133（本答案改编自该版本）