关闭

Android 快速发布开源项目到jcenter

标签: androidjcenterbintray
44660人阅读 评论(110) 收藏 举报
分类:

转载请标明出处(请勿转载删除底部微博、微信等信息):
http://blog.csdn.net/lmj623565791/article/details/51148825
本文出自:【张鸿洋的博客】

大家在很多时候都希望让自己的开源项目可以更方便的让用户去使用,那么对于Android平台,一个很好的方式就是上传到jcenter,然后使用时通过添加compile引用即可。

对于上传到jcenter,也不算技术类的文章,而且已经有很多较好的文章可以参考,写之前我也大致百度了一下。

目前很多文章都是以gradle-bintray-plugin这个插件做上传,多数文章的介绍都是针对普通的开源项目的(即不包含编译时注解相关)。那么对于用到编译时注解,因为涉及到多个module,上传可能会比较麻烦。

本文准备采用bintray-release这个插件,个人感觉比gradle-bintray-plugin要方便很多。

对于使用gradle-bintray-plugin的,我百度了下,可以参考这篇http://www.cnblogs.com/qianxudetianxia/p/4322331.html

So,本文的主要内容是:

  1. 使用bintray-release发布一般项目到jcenter
  2. 使用bintray-release发布编译时注解项目到jcenter

一、普通项目上传到jcenter

ok,首先你应该有一个待上传的项目。

那么我们这里模拟一个简单的项目。

可以看到我们的basetools是个Android library,主要用来存放一些工具,我们现在要将其上传到jcenter。

那么,对于你,应该已经有了这样一个Android library,处于待上传的状态。

(1)注册bintray.com账号

为什么要注册这个账号呢,因为jcenter()属于bintray旗下的一个仓库。

我们的上传流程其实就是,从你的Androd Studio,到你的bintray 仓库,最后同步到jcenter仓库。

  1. 进入https://bintray.com/,注册账号。
  2. 注册完成后,需要邮箱激活;也可以选择第三方登录。

注册完成后,登录,这两步属于非职业玩家都能搞定的。

登录后:

登陆后,你可以点击Your Profile->Edit然后就能看到上图的界面。

点击API Key,就可以看到你一段key字符串,把这个copy下放一边,一会上传要用。

(2)引入bintray-release

项目的build.gralde

在你的项目的build.gradle添加bintray-release的classpath,注意是项目的build.gradle,不是module的,针对文章开始的图即UploadJcenterTest/build.gradle

buildscript {
    repositories {
        jcenter()
    }
    dependencies {
        classpath 'com.android.tools.build:gradle:1.2.3'
        classpath 'com.novoda:bintray-release:0.3.4'
    }
}

待上传moudle的build.gralde

来到你想要上传的module,针对文章开始的图即UploadJcenterTest/basetools/build.gradle

apply plugin: 'com.android.library'
apply plugin: 'com.novoda.bintray-release'//添加

android {
  //保持不变
}

dependencies {
    //保持不变
}

//添加
publish {
    userOrg = 'hyman'//bintray.com用户名
    groupId = 'com.hyman'//jcenter上的路径
    artifactId = 'basetools'//项目名称
    publishVersion = '1.0.0'//版本号
    desc = 'Oh hi, this is a nice description for a project, right?'//描述,不重要
    website = 'https://github.com/hyman/basetools'//网站,不重要;尽量模拟github上的地址,例如我这样的;当然你有地址最好了
}

按照上面编写即可,细节有标识注释了,假设按照上述的编写,最终引入的方式为:

compile 'com.hyman:basetools:1.0.0

完成上面的配置后,就准备上传了。

上传

上传很简单,执行下面的代码即可

 ./gradlew clean build bintrayUpload 
 -PbintrayUser=hyman 
 -PbintrayKey=xxxxxxxxxxxxxxxxxxxxxx 
 -PdryRun=false

user就是用户名,key就是我们刚才的让你保存的key,dryRun是一个配置参数,当为true的时候,会运行所有的环节,但是不会上传。

ok,下面整理好上面的这段代码,运行即可。关于运行,你可以选择在Android Studio的Terminal面板进行,如下图。

点击底部的Terminal即可,注意下你当前的路径是当前项目下,然后enter运行。

然后就是等待,当运行完成,看到BUILD SUCCESSFUL就没问题了,如果有什么问题呢,根据log排查下。

到此就上传完成了~~~

你可以访问https://bintray.com/你的用户名/maven,即可看到:

看到我们上传的项目了,你可以点击进去看该库的一些信息,但是注意此时还不能够直接被引用。

点击进去该库,按照下图,点击Add To jcenter

然后随便写一下对你该库的描述,然后点击发送就可以了。

ok,到此就结束了,不过目前还是不能直接引用的,你需要等待bintray的工作人员审核,审核通过会给你发送站内Message,并且Add to Jcenter那个按钮就小时了,此外你还可以根据你上传的groupId,访问该网站https://jcenter.bintray.com/你的groupId例如https://jcenter.bintray.com/com/hyman/

如果可以引用,则能看到如下:

最后总结下整个过程,其实非常简单:

  1. 申请账号
  2. 引入bintray-release,在需要上传的module里面填写相关publish的信息
  3. 调用上传的命令
  4. Add to Jcenter提交审核

基本都是步骤化的东西,真正需要我们填写的也就publish里面几个信息。

ok,接下来看上传编译时注解的项目。

二、编译时注解项目上传到jcenter

如果你暂时不需要这个需求,其实没必要往下看,因为并不属于技术类文章,了解这里有写,可以收藏下,遇到需求再回来看就好了。

其实也很简单,按照步骤做就好。

我们这里找一个项目作为演示。

为什么说编译时注解的项目特殊呢?

因为它一般会涉及到多个moudle,比如上图,涉及到compilterpermission-annotationpermission-lib

我们在上传时,这3个module都要进行上传,这里暂不涉及为啥会这么分module相关知识。

其实利用bintray-release上传的过程也很简单。

项目的build.gradle

首先针对项目的build.gradle,即图中MPermissions/build.gradle

buildscript {
    repositories {
        jcenter()
    }
    dependencies {
        classpath 'com.android.tools.build:gradle:1.2.3'
        classpath 'com.neenbedankt.gradle.plugins:android-apt:1.4'
        classpath 'com.novoda:bintray-release:0.3.4'//添加
    }
}

allprojects {
    repositories {
        jcenter()
    }
}

//添加
ext {
    userOrg = 'hongyangandroid'
    groupId = 'com.zhy'
    uploadName = 'MPermission'
    publishVersion = '1.0.1'
    desc = 'a easy API to use runtime permission for Android M '
    website = 'https://github.com/hongyangAndroid/MPermissions'
    licences = ['Apache-2.0']
}

只要关注添加的部分,底部的ext主要是为了上传多个module统一管理的。

module的build.gradle

剩下就是compilterpermission-annotationpermission-lib这三个module,这三个模块的处理其实是一致的:

  1. apply插件
  2. 填写publish信息
apply plugin: 'com.android.library'
apply plugin: 'bintray-release'//添加

android {
}

dependencies {

}

//添加
publish {
    artifactId = 'mpermission-api'
    userOrg = rootProject.userOrg
    groupId = rootProject.groupId
    uploadName = rootProject.uploadName
    publishVersion = rootProject.publishVersion
    desc = rootProject.description
    website = rootProject.website
    licences = rootProject.licences
}

3个模块的配置是一样的,唯一不同的就是publish中的artifactId,不同的module应该有它不同的名字。

对所有需要上传的module配置完成后,和上面一样,运行上传的命令即可。

 ./gradlew clean build bintrayUpload 
 -PbintrayUser=hyman 
 -PbintrayKey=xxxxxxxxxxxxxxxxxxxxxx 
 -PdryRun=false

你可以选择在Android Studio的Terminal面板进行,如下图。

ok,然后就和上面普通项目的步骤一致了,去Add to Jcenter,之后等待。

如果审核成功,你会发现3个module都会被同步到jcenter上,比如访问http://jcenter.bintray.com/com/zhy/

在使用时,对于compiler需要引入apt的插件,大致类似如下用法:

apply plugin: ‘com.neenbedankt.android-apt’

dependencies {
apt ‘com.zhy:mpermission-compiler:1.0.0’
compile ‘com.zhy:mpermission-api:1.0.0’
}
ok,当然本文的重点在于上传,其他方面细节就不赘述了。

三、注意事项

(1)版本更新

我们上传完成后,肯定会涉及到更新问题,那么怎么更新呢?

publish {
    userOrg = 'hyman'//bintray.com用户名
    groupId = 'com.hyman'//jcenter上的路径
    artifactId = 'basetools'//项目名称
    publishVersion = '2.0.0'//修改版本号
    desc = 'Oh hi, this is a nice description for a project, right?'//描述,不重要
    website = 'https://github.com/hyman/basetools'
}

什么都不用动,唯独修改下版本号就可以了,修改完成,执行上传那段代码。

(2)你是windows系统

 gradlew clean build bintrayUpload 
 -PbintrayUser=hyman 
 -PbintrayKey=xxxxxxxxxxxxxxxxxxxxxx 
 -PdryRun=false

前面的./就不要输入了,这属于比较基础的问题了。

(3)乱码问题

注释中有中文,可能会出现:编码GBK的不可映射字符

项目的build.gradle中添加:

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

还有上传过程中的一些问题,确定你的用户名正确,偶尔需要科学上网。

那么如何利用bintray-release上传开源项目到jcenter就介绍完毕了,希望能够节省你的时间~


欢迎关注我的微博:
http://weibo.com/u/3165018720


关注微信公众号:hongyangAndroid
(欢迎关注,第一时间推送博文信息)

28
5
查看评论

扫盲Android Studio 仓库jCenter并发布自己的开源库

AS从哪里获取到开源库首先我们在使用第三方开源库时,直接在项目的 gradle 文件中添加这样一行代码: compile 'com.jakewharton:butterknife:7.0.1' 添加完之后,你会发现依懒库中确实出现了这个库文件,那么 AS 具体是去哪里下载这个库的...
  • u013231041
  • u013231041
  • 2017-04-14 17:11
  • 2766

Github项目解析(二)-->将Android项目发布至JCenter代码库

Android Studio是从build.gradle里面定义的Maven 仓库服务器上下载library的。Apache Maven是Apache开发的一个工具,提供了用于贡献library的文件服务器。总的来说,只有两个标准的Android library文件服务器:jcenter 和 Ma...
  • qq_23547831
  • qq_23547831
  • 2015-11-24 19:47
  • 3430

Android stuido JCenter 下载慢问题解决

转自:https://my.oschina.net/lifj/blog/754861 下面是build.gradle的内容:主要增加了jcenter(){url 'http://jcenter/bintray.com/'}  // Top-level build fil...
  • sgilec
  • sgilec
  • 2017-04-05 11:27
  • 926

将自己写的库发布到Jcenter

本文主要介绍如何最简单的将自己的 `Library` 发布到 `jcenter`。 2017.6.16 更新为使用远程上传脚本打包上传,简化操作流程 使用 `gradle` 开发过程中,我们可以使用 `compile` 命令,依赖 `Library`,这种做法的好处时,我们不需要再去关注一堆 `...
  • chendong_
  • chendong_
  • 2016-03-12 20:06
  • 2350

AndroidStuio快速发布开源项目到Jcenter/Bintray

AndroidStuio快速发布开源项目到Jcenter/Bintray 版权声明:转载请注明本文转自严振杰的博客: http://blog.csdn.net/yanzhenjie1003 前言  最近做了两个开源项目,一个是Android网络框架NoHttp,和Volley、OkHttp一样做...
  • yanzhenjie1003
  • yanzhenjie1003
  • 2016-06-14 16:07
  • 16828

Android将Library上传到jcenter超简单完整图文步骤以及遇到的各种坑

Android将Library上传到jcenter超简单完整步骤以及遇到的各种坑 在【玩转SQLite系列】(七)打造轻量级ORM工具类SQLiteDbUtil操作数据库 中我们可以看到这个工具类的超简洁用法:只需要在gradle中引入: compile 'cn.bluemobi....
  • u010785585
  • u010785585
  • 2016-12-01 00:28
  • 5682

使用Gradle发布Android开源项目到JCenter

喜欢做些开源项目的朋友,相信有不少人都希望能把自己的项目发布到公共的中央仓库,如maven中央仓库,以供别人方便地集成使用。而使用了Android Studio的同学,应该也对gradle和jcenter印象深刻,不少开源库都是发布到这里的。这一篇就主要来介绍一下,如何使用Gradle发布到jcen...
  • maosidiaoxian
  • maosidiaoxian
  • 2015-01-26 09:41
  • 42840

上传jcenter的“第一次”所遇到的坑

把自己的项目开源给外界或者自己的团队,使用jcenter是一个不错的选择。在bintary.com上新建项目时,如果选择私有的话,是要收费的。开源项目管理网站的惯用作法。 现在就来记录我第一次上Jcenter时所遇到的坑,过程稍有挫折,但是结果是肯定的,美好的,就像每个人的“第一次”一样的,你懂的。...
  • xingshen58
  • xingshen58
  • 2016-06-12 13:16
  • 3439

Jcenter

如何让别人一行代码就能使用自己的library序:一直很好奇为什么我使用github上的许多开源项目时,只要在gradle上写上一行compile 'com.android.volley:volley:1.0.0'就OK了。正好这段时间想把自己写的几个自定义view放上去于是花了一天...
  • my_Captain
  • my_Captain
  • 2016-05-18 23:49
  • 656

Android Studio之maven Central,JCenter

Android studio 是从哪里得到库的?Android Studio是从build.gradle里面定义的Maven 仓库服务器上下载library的。Apache Maven是Apache开发的一个工具,提供了用于贡献library的文件服务器。总的来说,只有两个标准的Android li...
  • lu_xin_
  • lu_xin_
  • 2016-04-12 16:49
  • 8985
    个人资料
    • 访问:18250069次
    • 积分:51677
    • 等级:
    • 排名:第65名
    • 原创:207篇
    • 转载:0篇
    • 译文:6篇
    • 评论:15734条
    我的微信公众号
    联系方式


    QQ群:
    • 55032675
    • 423372824
    • 497438697
    • 请勿重复加群,Thx
    博客专栏
    统计