如何在Gradle项目中使用IntelliJ IDEA生成包含javadoc的.jar？

Question

我正在使用IntelliJ IDEA在Java中开发一个库，我也使用gradle进行项目。 我的问题是，当我构建项目的工件时，构建的.jar文件不包含任何我的javadocs，并且接口中方法参数的名称也会丢失。 如何在Gradle项目中使用IntelliJ IDEA生成包含javadoc的.jar？

Answer 1

task sourcesJar(type: Jar, dependsOn: classes) {
    classifier = 'sources'
    from sourceSets.main.allSource
}

task javadocJar(type: Jar, dependsOn: javadoc) {
    classifier = 'javadoc'
    from javadoc.destinationDir
}

artifacts {
    archives sourcesJar
    archives javadocJar
}

Answer 2

这是预期的行为。 但是有一个默认的'javadoc'任务可以将javadoc生成到'build / docs'目录中。 所以你可以这样做：

task makeJavadoc (type :Jar, dependsOn: javadoc){
    from docsDir
    classifier='docs'
    description='Creates a Javadoc Jar'
}

生成的javadoc必须手动附加。