Gradle:使用javadocs进行gradle安装

时间:2015-01-09 00:04:02

标签: java gradle

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

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

有没有办法在Gradle中使用mavenjavadoc插件执行此操作?我不介意编写自定义任务来执行此操作,但我宁愿使用"官方支持"如果存在的话。

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")
        }
    }
}

1 个答案:

答案 0 :(得分:7)

Javadocs由javadoc 任务生成(我认为你错误地称它为插件)。运行buildinstall时,默认情况下,此任务实际上并未执行。此外,您还要定义一个jar任务来捆绑javadoc并告诉您的构建通过将其添加到artifacts {...}块来发布该工件。

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

artifacts {
    archives javadocJar
}

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

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