Gradle:使用javadocs进行gradle安装

Question

我正在使用Gradle maven插件来构建一个将用于另一个无关项目的伪制品。除了已构建的.jar伪制品之外，我还希望生成并安装-javadoc.jar伪制品。

使用gradle clean build javadoc install在本地构建文件中生成JavaDoc，并将构建的伪构件安装到本地存储库，但它目前没有在本地存储库旁边构建和安装-javadoc.jar。

有没有办法在Gradle中使用maven或javadoc插件来实现这一点？我不介意编写一个定制的任务来完成它，但是如果存在的话，我宁愿使用“官方支持的”方式。

build.gradle文件：

project.group = "org.example.artefact"
project.version = "1.0-SNAPSHOT"

apply plugin: 'java'
apply plugin: 'maven'

dependencies {
    // ...
}

uploadArchives {
    repositories {
        mavenDeployer {
            // Custom repository location
            repository(url: "file:///home/user/.m3/repository")
        }
    }
}

Answer 1

Javadocs是由javadoc 生成的(我认为您错误地将它称为插件)。在运行build或install时，默认情况下不实际执行此任务。此外，您还需要定义一个jar任务来绑定javadocs，并告诉您的构建通过将它添加到artifacts {...}块来发布该工件。

task javadocJar(type: Jar) {
    classifier = 'javadoc'
    from javadoc
}   

artifacts {
    archives javadocJar
}

然后，运行install应该创建javadoc并将其发布到maven本地。此外，运行uploadArchives之后会将该工件发布到任何配置的存储库中。

编辑：更新以添加javadoc jar任务的定义。