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

Question

我使用IntelliJ IDEA在Java中开发一个库，我也使用Gradle作为项目。 我的问题是，当我构建项目的工件时，构建的.jar文件不包括我的任何javadoc，而且接口中方法参数的名称也会丢失。如何在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必须手动连接。