使用Gradle发布SNAPSHOT版本到JCenter(oss.jfrog.org)

时间:2023-03-08 16:52:40

本文原创。

转载请注明****博客出处:

http://blog.****.net/maosidiaoxian/article/details/47608573

在以前我发过一篇 使用Gradle发布Android开源项目到JCenter ,但随后发布SNAPSHOT版本却折腾了好久没弄出来,而昨晚在参考了两篇博客后终于成功。

回顾历史

在发布 aar 到JCenter的时候,一开始指定上传文件的时候是使用publications,然后使用bundleRelease任务的输出做为aar的artifact。

publishing {
    publications {
        mavenJava(MavenPublication) {
            artifactId PROJ_ARTIFACTID
            artifact javadocJar
            artifact sourcesJar
            artifact bundleRelease
            //省略
        }
    }
}

bintray {
    user = BINTRAY_USER
    key = BINTRAY_KEY

    publications = ['mavenJava']
    // 省略
}

但是在当时却导致了Android Studio里编译失败,理由是没有bundleRelease这个属性(或任务)。其原因是,这个任务一开始的时候是没有的,是在分析计算了build.gradle之后才创建的。

后来找到了一个迂回的方法,那就是使用artifacts方法来把源码和注释的jar包添加到artifact中,然后上传的时候publicationsconfigurations一起用。如下:

artifacts {
    archives javadocJar
    archives sourcesJar
}
publishing {
    publications {
        mavenJava(MavenPublication) {
            artifactId PROJ_ARTIFACTID
            // 省略
    }
}
bintray {
    user = BINTRAY_USER
    key = BINTRAY_KEY
    configurations = ['archives']
    publications = ['mavenJava']
    //省略
}

发布SNAPSHOT版本的问题

首先参考了这篇博客,知道如何传上SNAPSHOT版本到oss.jfrog.org(JCenter是不支持SNAPSHOT版本的)。但是这里却只能用publications而不像bintray那样有configurations

artifactory {
    contextUrl = 'http://oss.jfrog.org/artifactory'
    resolve {
        repository {
            repoKey = 'libs-release'
        }
    }
    publish {
        repository {
            repoKey = 'oss-snapshot-local' //The Artifactory repository key to publish to
            username = bintray.user
            password = bintray.key
            maven = true
        }
        defaults {
//这里的名字和上面红色的名字一致即可,会将其包含的输出上传到jfrog上去
            publications('mavenJava')
            publishArtifacts = true
        }
    }
}

解决问题

于是只能再次面对以前那个问题,那就是怎么解决打包输出aar并加到mavenJava的配置中。先是找到一个github上的issue,老外用指定的文件路径来添加。*上也有不少类似的答案。但这并不是我想要的,因为这样的指定并不灵活,而且也没有对打包aar的任务形成依赖,所以最后还是回归到如何解决在配置中添加bundleRelease的问题上。google之后,终于在小日本的这篇博客找到答案:

afterEvaluate {
    publishing.publications.aar.artifact(bundleRelease)
    publishing.publications.jar.artifact(packageReleaseJar)
}

即,使用afterEvaluate,在这里的闭包中进行添加。因为在这个时候,已经有bundleRelease这个任务了。

完整脚本

完整脚本如下:

group = PROJ_GROUP
version = PROJ_VERSION
project.archivesBaseName = PROJ_ARTIFACTID

apply plugin: 'com.jfrog.bintray'
apply plugin: "com.jfrog.artifactory"
apply plugin: 'maven-publish'

task sourcesJar(type: Jar) {
    from android.sourceSets.main.java.srcDirs
    classifier = 'sources'
}

task javadoc(type: Javadoc) {
    source = android.sourceSets.main.java.srcDirs
    classpath += configurations.compile
    classpath += project.files(android.getBootClasspath().join(File.pathSeparator))
}

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

javadoc {
    options{
        encoding "UTF-8"
        charSet 'UTF-8'
        author true
        version true
        links "http://docs.oracle.com/javase/7/docs/api"
        title PROJ_ARTIFACTID
    }
}

def pomConfig = {
    licenses {
        license {
            name "The Apache Software License, Version 2.0"
            url "http://www.apache.org/licenses/LICENSE-2.0.txt"
            distribution "repo"
        }
    }
    developers {
        developer {
            id DEVELOPER_ID
            name DEVELOPER_NAME
            email DEVELOPER_EMAIL
        }
    }
}

publishing {
    publications {
        mavenJava(MavenPublication) {
            artifactId PROJ_ARTIFACTID
            artifact javadocJar
            artifact sourcesJar

            pom{
                packaging 'aar'
            }
            pom.withXml {
                def root = asNode()
                root.appendNode('description', PROJ_DESCRIPTION)
                root.children().last() + pomConfig
            }
        }
    }
}

afterEvaluate {
    publishing.publications.mavenJava.artifact(bundleRelease)
}

bintray {
    user = hasProperty("bintrayUser")?getProperty("bintrayUser"):getProperty("BINTRAY_USER")
    key = hasProperty("bintrayKey")?getProperty("bintrayKey"):getProperty("BINTRAY_KEY")

    publications = ['mavenJava']
    publish = true

    pkg {
        repo = 'maven'
        name = PROJ_NAME
        desc = PROJ_DESCRIPTION
        websiteUrl = PROJ_WEBSITEURL
        issueTrackerUrl = PROJ_ISSUETRACKERURL
        vcsUrl = PROJ_VCSURL
        licenses = ['Apache-2.0']
        publicDownloadNumbers = true
    }
}

artifactory {
    contextUrl = 'http://oss.jfrog.org/artifactory'
    resolve {
        repository {
            repoKey = 'libs-release'
        }
    }
    publish {
        repository {
            repoKey = 'oss-snapshot-local' //The Artifactory repository key to publish to
            username = bintray.user
            password = bintray.key
            maven = true
        }
        defaults {
            //这里的名字和上面红色的名字一致即可,会将其包含的输出上传到jfrog上去
            publications('mavenJava')
            publishArtifacts = true
        }
    }
}

使用方法

使用方法与之前的一样,这里不多赘述。稍有区别的是,在build.gradle中需要添加多一个依赖:

    classpath "org.jfrog.buildinfo:build-info-extractor-gradle:3.1.1"

这里可以参考gradle-publish项目上的build.gradle文件。

还有,发布SNAPSHOT版本的时候,在配置里的版本名称应该是xxx.xxx.xxx-SNAPSHOT,执行gradle artifactoryPublish就可以发布上去了。如果要使用,需要声明以下仓库:

    maven { url "http://oss.jfrog.org/oss-snapshot-local/" }

另外就是建议把bintray.gradle文件拷到项目中使用。

如果使用过程有问题,欢迎在我的项目中提issue