利用Bintray五分钟上传Android library到JCenter

1,062
原文链接: www.jianshu.com

背景

这段时间自己写了一个组件想上传到Jcenter来给大家使用,也是第一次上传所以就走了一些弯路,现在整理一下供有需要的朋友学习。

资料准备

  1. 首先我们需要一个Bintary的账号,我自己就是在这一步就掉到坑里面了,我们个人用户,千万!千万!千万!不要去官网首页注册,那个注册的是组织账号(组织账号后面没有我们需要用到的上传Jcenter),我们通过下面的地址来注册。
    个人账号注册地址:bintray.com/signup/oss
    如果有GitHub或者Google账号我们可以直接登录,但是注册的邮箱必须是国外的邮箱。
  2. 注册完我们登录邮箱确认一下就可以了,登录之后我们需要先创建一个Repository。


    Add New Repository
    Add New Repository

    创建之后,需要我们填写一些资料,这个我们按照自己的需求来就可以了。


    RepositoryInfo
    RepositoryInfo
  3. 创建一个项目对应的Package
    Add New Package
    Add New Package
    创建完成之后还是填写相关信息:
    PackageInfo
    PackageInfo
    只要填写带*号的东西就可以了,Name不要随便写,尽可能与你要上传的lib相关,后面要用到。
    好了到这里为止我们的Bintray就准备的差不多了接下来就开始上传。

上传Android Library

通过查询资料之后,发现了一个gradle的插件,可以通过配置直接上传到对应的Bintary,下面贴出GitHub源码地址,有兴趣的朋友可以深入研究:bintray-release,我们这里就不展开了直接说怎么使用。
1.根目录下的build.gradle中加入上传开源库的依赖:

classpath 'com.novoda:bintray-release:+'

2.library的moudel中加入引用

apply plugin: 'com.novoda.bintray-release'

3.从其他博客看到如果过你的开源库中有中文的注释,可以加入下面的代码

allprojects {
    repositories {
        jcenter()
    }
    //加上这些
    tasks.withType(Javadoc) {
        options{ encoding "UTF-8"
            charSet 'UTF-8'
            links "http://docs.oracle.com/javase/7/docs/api"
        }
    }
}

4.忽略Lint检测的错误信息

android {
 lintOptions {
        abortOnError false
    }
}

5.上传开源库的参数配置

publish {
    userOrg = 'xxxxx'      //bintray注册的用户名
    groupId = 'com.xxx.xxx'         //compile引用时的第1部分groupId,一般为包名
    artifactId = 'xxxxx'     //compile引用时的第2部分项目名,这个需要与我们之前创建的package的Name一样,要不会上传失败
    publishVersion = '1.0.0'    //compile引用时的第3部分版本号
    desc = 'This is a library '  //描述  随便写
    website = ''   //项目的网页,可以写源码的GitHub地址
}

6.命令行编译 windows系统:

gradlew clean build bintrayUpload -PbintrayUser=BINTRAY_USERNAME -PbintrayKey=BINTRAY_KEY -PdryRun=false

os x系统

./gradlew clean build bintrayUpload -PbintrayUser=BINTRAY_USERNAME -PbintrayKey=BINTRAY_KEY -PdryRun=false

其中BINTRAY_USERNAME换成bintray注册的用户名,BINTRAY_KEY换成自己的APIKEY。

UserInfo
UserInfo

用户名就是上面的那个,APIKey我们只要点击API Key就可以看到了 运行完之后我们就可以在Bintray上看到了。

发布到JCenter平台

JCenter.png
JCenter.png

如图所示,我们只需要点击Add to JCenter就可以了,一般几个小时就可以审核通过了。

开源库依赖

1.使用还在审核的开源库


image.png
image.png

在根目录的build.gradle里面增加自己的地址:


image.png
image.png
引用方法:
compile  'com.xxx.xxx:1.0.0'

2.已经审核通过的开源库 直接引用:

compile  'com.xxx.xxx:1.0.0'

总结

好了,大概就这么简单,这篇文章也是从网上各个博客那边查看整合起来的,感谢各位的付出。