Gradle:使用javadocs进行gradle安装

Question

我正在使用Gradle maven插件来构建一个用于另一个不相关项目的人工制品.除了构建的.jar工件外,我还想生成并安装-javadoc.jar工件.

使用gradle clean build javadoc install在本地构建文件中生成JavaDoc ,并将构建的artefact安装到本地存储库,但它目前不构建并安装-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任务来捆绑javadoc并告诉您的构建通过将该工件添加到artifacts {...}块中来发布该工件.

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

artifacts {
    archives javadocJar
}

install然后运行应该创建javadoc jar并将其发布到maven local.此外,运行uploadArchives然后将该工件发布到任何已配置的存储库.

编辑:已更新以添加javadoc jar任务的定义.