AS发布依赖库到Jcenter
参考1 Android Studio 发布项目到 JCenter 以及常见错误
参考2 如何通过Android Studio发布library到jCenter和Maven Central
项目发布到JCenter好处多多,最明显的就是只需在gradle里添加一行依赖就可以轻松引入。随着Android Studio的普及,越来越多的项目已经传到了JCenter。参考链接1是不用插件的方式,完全自己配置,比较麻烦,参考链接2是用了
bintray-release
插件的方式,简单稳定,因此我就采用了参考链接2的方式,本文纯属总结,内容来着上面链接的整合。
相关知识介绍
-
三种常用的资源仓库:Jcenter , Maven Central 和 特殊的资源仓库
Jcenter
jcenter是一个托管在bintray.com的资源库。你可以在这里找到需要的资源。allprojects { repositories { jcenter() } }
JMaven Central
Maven Central是一个托管在sonatype.org的资源库。你可以在这里找到需要的资源。allprojects { repositories { mavenCentral() } }
请注意,虽然jcenter和Maven Central都是标准android library资源仓库,但他们的托管地址完全不同,它们的内容是由不同提供者提供的,而且之间并没有任何关联。所以也就可能,在jcenter中能够找到的library,在Maven Central中并不能找到,maven central是jcenter的子集,上传到jcenter上的库,可以一键发布到maven central上,十分简单,jcenter界面更友好,jcenter通过CDN发送library,下载更快。</br>
特殊的资源仓库
除了这两个标准的资源库外,我们也可以定义特殊的资源库,引入一些开发者托管在自己服务器上的library。比如:上传一个依赖库到bintray的个人账户上,不想同步到Jcenter(同步到jcenter就不能再删除了),需要在项目的build.gradle
文件下面,定义资源库的url.allprojects { repositories { google() jcenter() //ui-kit的远程地址 maven { url "https://dl.bintray.com/kelly-bit/maven/" } //这是你需要加入的 } }
然后你可以通过和标准资源库相似的方法获取该资源库里面的任何library,在app的
build.gradle
文件下面,加上依赖。allprojects { //ui-kit implementation "com.example.textlibrary:ui-kit:1.0.2" }
认识一下Maven仓库的链接
以gson为例,我们指定了jcenter,然后在dependencies中加入compile 'com.google.code.gson:gson:2.3.1'
就可以了。其中com.google.code.gson:gson:2.3.1
称为library的库链接,也成为库地址。由三部分组成:GROUP_ID:ARTIFACT_ID:VERSION
- GROUP_ID:通常以开发者包名紧跟着library的group名称来命名。如上面的就是com.google.code+gson来命名。
- ARTIFACT_ID:你的library的真实名称。
artifact ['ɑrtə,fækt] n. 人工制品;手工艺品 - VERSION:就是你library的版本号。
三者之间以半角冒号分隔。
-
上传的过程
-
上传的内容
开始上传
-
注册Bintray账号
要想传到JCenter,必须经过他爸爸Bintray才可以,到https://bintray.com/注册,要用Google邮箱才行哦.(个人试用就不要注册组织哦,组织是30天试用的功能,要花钱的。)删除账号
如果误注册成企业版占用了用户名邮箱,想注销怎么办?
其实也简单,1.先取消Premium Organizations(高级组织)的标识,再删除组织 2. 鼠标放在右上角头像出,在弹出浮层上点击Edit Profile,拉到最下面有个Delete Account,点击验证后就可以注销账号。 在项目
build.gradle
的dependencies
下添加
classpath 'com.novoda:bintray-release:0.9.1'
注意是项目的不是module的bulid文件。用希望的版本号替换0.9.1,建议使用最新版本,最新版本号可以在 https://github.com/novoda/bintray-release 查看。如图
buildscript {
ext.kotlin_version = '1.3.50'
ext.kotlin_version = '1.3.31'
ext.anko_version = '0.10.1'
repositories {
google()
jcenter()
}
dependencies {
XXX
classpath 'com.novoda:bintray-release:0.9.1'
}
}
- 配置要上传的moudle
下面操作均在要上传的moudle的build.gradle文件进行。
//添加引用
apply plugin: 'com.novoda.bintray-release'
publish {
userOrg = 'kelly-bit' //bintray注册的用户名(不是邮箱)
groupId = 'com.example.textlibrary'
artifactId = 'ui-kit' //项目名称
publishVersion = '1.0.2' //版本号
desc = '测试上传jcenter项目' //项目描述。可空。
website = 'https://github.com/novoda/bintray-release' //项目地址,一般填github地址。
repoName = 'maven'//Repository的名字,和在bintray上面添加的Repository的名字保持一致,不配置此項,默認叫maven
bintrayUser = 'kelly-bit'
bintrayKey = 'bd8f1ac1094cff6f882eaa6ee7d08f17a89aa3fb'
dryRun = false
}
1.repoName Repository的名字,和在bintray上面添加的Repository的名字保持一致,不配置此項,默認叫maven 2.website 项目地址,一般填github地址,不可空
API Key
在bintray.com网站上登陆后,鼠标移动到右上角头像,点Edit Profile,在左侧找到API Key点击去就可以看到了。如图。
假如按照以上设置,那么最终项目的引用格式就是:
implementation "com.example.textlibrary:ui-kit:1.0.2"
可以对照着修改。
4.新建仓库
在bintray.com网站上,新建一个仓库,和上传的moudle的build.gradle文件保持一致,默认叫maven
5.上传
一切准备就绪,可以开始上传了。很简单,直接在Android Studio Terminal面板执行:gradlew clean build bintrayUpload
就ok。经过漫长等待,如果显示BUILD SUCCESSFUL ,那么恭喜,上传完成了。
或者如下图双击也行。
6.提交到JCenter
到此为止项目仅仅是传到了Bintray,并没有同步到JCenter。
先点进去刚传的项目,可以看到右下方Linked to模块有个Add to JCenter按钮,点击后打开一个网页,在此输入这个项目的描述(最好英文),不用多长,一句话就可以。然后点击Send可以提交审核。通过后会有站内消息提示,一般几小时就可以通过,很容易的。
7.升級版本
修改內容,升級版本号,再重新执行第5条的命令就可以了,依赖的項目也相应的改一下版本号重新build就可以了。
8.maven仓库的url