Android通过Gradle发布开源项目到binary/Jcenter

一、保存bintary账号信息

首先,我们需要一个bintray帐号,通过https://bintray.com进行注册。

在登陆后,点击edit打开编辑,然后点击api key

注意每个人的api key都是不一样的,这里需要对它进行保密,不要告诉别人,否则别人可以通过你的api key对提交的库进行调整。得到API key之后就需要在我们的项目中对它进行设置保存了。

此处有两种方式进行配置,值分别是你在bintray上的api key和你的user name。

  1. 到你的.gradle目录下(如果你没有配置过GRADLE_USER_HOME的环境变量,则是在你的用户目录下),编辑gradle.properties(如果没有则创建),加入配置:
BINTRAY_USER=xxx  
BINTRAY_KEY=xxx  
  1. 找到项目本地的local.properties(如果没有就新建它),这是本地的配置文件,一般我们提交到github的时候,这个文件都会被ignore,所以我们不用担心信息被别人看到。然后同样加上如上配置。
二、编辑Gradle文件

在最外面的那个build.gradle文件中入如下配置

classpath 'com.jfrog.bintray.gradle:gradle-bintray-plugin:1.6'
classpath 'com.github.dcendents:android-maven-gradle-plugin:1.5'

 // Remove it if you won't to publish SNAPSHOT version.
classpath "org.jfrog.buildinfo:build-info-extractor-gradle:4.0.0"

最新版本信息可以在以下链接查看。

https://github.com/bintray/gradle-bintray-plugin

https://github.com/dcendents/android-maven-gradle-plugin

在library中添加binary.gradle文件,加入如下代码

group = PROJ_GROUP
version = PROJ_VERSION
project.archivesBaseName = PROJ_ARTIFACTID

apply plugin: 'com.jfrog.bintray'
apply plugin: 'com.github.dcendents.android-maven'

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 "https://androiddoc.qiniudn.com/reference/"
        title "$PROJ_NAME $PROJ_VERSION"
    }
}

artifacts {
    archives sourcesJar
    archives javadocJar
}

install {
    repositories.mavenInstaller {
        pom.project {
            name PROJ_NAME
            description PROJ_DESCRIPTION
            url PROJ_WEBSITEURL
            inceptionYear '2016'

            packaging 'aar'
            groupId PROJ_GROUP
            artifactId PROJ_ARTIFACTID
            version PROJ_VERSION

            licenses {
                license {
                    name 'The Apache Software License, Version 2.0'
                    url 'http://www.apache.org/licenses/LICENSE-2.0.txt'
                    distribution 'repo'
                }
            }
            scm {
                connection PROJ_VCSURL
                url PROJ_WEBSITEURL

            }
            developers {
                developer {
                    id DEVELOPER_ID
                    name DEVELOPER_NAME
                    email DEVELOPER_EMAIL
                }
            }
        }
    }
}

bintray {
    user = project.hasProperty('bintrayUser') ? project.property('bintrayUser') : project.property('BINTRAY_USER')
    key = project.hasProperty('bintrayKey') ? project.property('bintrayKey') : project.property('BINTRAY_KEY')

    configurations = ['archives']

    dryRun = false
    publish = true

    pkg {
        repo = 'maven'   //仓库名
        name = PROJ_NAME
        licenses = ['Apache-2.0']
        vcsUrl = PROJ_VCSURL
        websiteUrl = PROJ_WEBSITEURL
        issueTrackerUrl = PROJ_ISSUETRACKERURL
        publicDownloadNumbers = true
        version {
            name = PROJ_VERSION
            desc = PROJ_DESCRIPTION
            vcsTag = PROJ_VERSION

            gpg {
                sign = true
            }
        }
    }
}

//以下内容用于发布SNAPSHOT版本,如果不需要可以移除。
//参考自:https://www.jfrog.com/confluence/display/RTF/Gradle+Artifactory+Plugin

apply plugin: "com.jfrog.artifactory"
artifactory {
    contextUrl = 'http://oss.jfrog.org/artifactory' //The base Artifactory URL if not overridden by the publisher/resolver
    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 {
            //这里的名字和前面bintray.configurations的值一致即可,会将其包含的输出上传到jfrog上去
            publishConfigs('archives')
        }
    }
}

在library的bulid.gradle下添加

apply from: './bintray.gradle'
三、在gradle.properties 文件添加如下配置
PROJ_GROUP=com.iceuncle(项目组名)
PROJ_VERSION=1.1.1(版本号)
PROJ_NAME=PasswordBox(项目名)
PROJ_WEBSITEURL=https://github.com/iceuncle/PasswordBox(项目地址)
PROJ_ISSUETRACKERURL=(不管它)
PROJ_VCSURL=https://github.com/iceuncle/PasswordBox.git(项目仓库)
PROJ_DESCRIPTION=android passwordbox widget(项目描述)
PROJ_ARTIFACTID=passwordbox(项目标签)

DEVELOPER_ID=xxxxxx
DEVELOPER_NAME=xxxxxx
DEVELOPER_EMAIL=tianyang.wu998@gmail.com

上面的例子最终在Android Studio中的引用形式为

dependencies {
    compile 'com.iceuncle:passwordbox:1.1.1'
}

可以发现,它的格式是 PROJ_GROUP:PROJ_ARTIFACTID:PROJ_VERSION组成。

四、执行命令发布

执行./gradlew install
如果你成功了,则可以在module的build/outputs下面看到你的aar文件
执行 ./gradlew bintrayUpload 将库发布到 bintray.com
执行 ./gradlew artifactoryPublish 可以发布版本到 oss.jfrog.org

五、将库加入Jcenter

最后一步,需要登录bintray.com,将我们刚刚发布的库申请加入到jcenter,这样别人才能直接引用到。

进入https://bintray.com/bintray/jcenter,点击Include My Package,然后在弹出的对话框中搜索并勾上你的项目。然后你可以写一下你的提交请求(貌似也可以不写?),点“Send”,接下来就看管理员审核了。

六、遇到的错误以及解决方案

1. HTTP/1.1 404 Not Found [message:Repo 'maven' was not found]

需要登录bintray并创建一个maven repo

  • 点击Add New Reposititory
  • 输入name: xxx,type选择maven,点击create
  • 将name更新至binary.gradle文件中的repo

2. 提示HTTP/1.1 401 Unauthorized [message:This resource requires authentication]
用户名或密码肯定填错了

3. java.net.SocketException: Operation timed out (Read failed)
需要先执行./gradlew install,然后再执行./gradlew bintrayUpload进行发布。

七、代码参考

具体的代码参考我的github项目:PasswordBox
觉得有用的话,请多多Star噢( ̄▽ ̄)~*

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 214,504评论 6 496
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 91,434评论 3 389
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 160,089评论 0 349
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 57,378评论 1 288
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 66,472评论 6 386
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 50,506评论 1 292
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,519评论 3 413
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 38,292评论 0 270
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,738评论 1 307
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 37,022评论 2 329
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 39,194评论 1 342
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 34,873评论 5 338
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 40,536评论 3 322
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 31,162评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,413评论 1 268
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 47,075评论 2 365
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 44,080评论 2 352

推荐阅读更多精彩内容