如何使用AndroidStudio将开源项目library发布到jcenter

我相信技术爱好者都喜欢开源,也都喜欢分享,随着技术的慢慢提高,很多开发者想将自己的开源类库分享出来,对于Android开发者来说,以前使用Eclipse开发时,直接引用类库或者打成jar包分享出来就行,现在使用AndroidStudio开发,引用类库直接在build.gradle文件里面添加一行引用代码即可。我们带着问题进入分析。

为什么只需要添加一行引用代码即可

AndroidStudio是从Maven Repository服务器下载类库的。基本上有jcenter和Maven Central这两个服务器用于下载Android的类库。 一开始AndroidStudio是使用MavenCentral作为默认的远程仓库下载类库的。但是MavenCentral有一些问题没有解决。首先是对于开发者不友好,开发者想上传自己的类库到MavenCentral非常困难,所以后来AndroidStudio团队决定把默认远程仓库换成jcenter。

所以我们在gradle里经常能够看到如下的代码配置:

1
2
3
4
5
allprojects {
repositories {
jcenter()
}
}

这就是jcenter仓库的配置。

引用类库代码的含义

在gradle引用类库的时候,我们经常看到这样形式的代码:

1
compile 'com.loonggg.godcoder.view:circleprogressbar:1.0.0'

我们从中可以看出这行代码用:分成了三部分:xxxx:xxx:xx,其实意思就是:GROUP_ID:ARTIFACT_ID:VERSION。其实GROUP_ID对应的是com.loonggg.godcoder.view:circleprogressbar,相当于我们建立项目时的包名,ARTIFACT_ID对应的是circleprogressbar,相当于这个类库的名称,后边的VIESION对应的非常显而易见,就是1.0.0,相当于版本控制的代号。

如何上传到jcenter

申请bintray账号

在bintray.com上注册一个账号。

网址:https://bintray.com/

新建一个maven类型的仓库

  1. 新建一个仓库
  2. 选择类型,填写仓库名字,填写介绍信息

    仓库名字有用,一定得记住,类型要选择maven,别选择错了。

  3. 在新建的maven类型仓库下Add New Package

  4. 填写必要信息,然后点击Create Package

    package名和许可证,版本号必填,其他不重要,暂时可不填写

在AS中配置信息,上传类库

配置账号用户名和key

我们需要设置bintray的username和API Key来进行bintray的加密认证。这些信息将写在local.properties文件里。如下:

1
2
bintray.user=YOUR_BINTRAY_USERNAME
bintray.apikey=YOUR_BINTRAY_API_KEY

bintray.user里对应的就是你注册账号的用户名,apikey可以在个人信息编辑里找到。如下:

配置Library的module的build.gradle文件

在build.gradle文件中添加的代码如下:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
ext {
bintrayRepo = 'loonggg'
bintrayName = 'CircleProgressBar'
publishedGroupId = 'com.loonggg.godcoder.view'
libraryName = 'CircleProgressBar'
artifact = 'circleprogressbarlibrary'
libraryDescription = 'CircleProgressBar is the dynamic display of a circle progress control.come on'
siteUrl = 'https://github.com/loonggg/CircleProgressBar'
gitUrl = 'https://github.com/loonggg/CircleProgressBar.git'
libraryVersion = '1.0.1'
developerId = 'loonggg'
developerName = 'gengguanglong'
developerEmail = 'gengguanglong@gmail.com'
licenseName = 'The Apache Software License, Version 2.0'
licenseUrl = 'http://www.apache.org/licenses/LICENSE-2.0.txt'
allLicenses = ["Apache-2.0"]
}

  • bintrayRepo对应的就是建立的maven仓库时填写的名字
  • bintrayName对应的就是新建的package的名字
  • publishedGroupId对应的就是我们之前提到的GROUP_ID
  • artifact对应的就是之前我们提到的ARTIFACT_ID
  • libraryVersion顾名思义就是VERSION

在build.gradle文件的最末行添加下面两行代码

1
2
apply from: 'https://raw.githubusercontent.com/nuuneoi/JCenter/master/installv1.gradle'
apply from: 'https://raw.githubusercontent.com/nuuneoi/JCenter/master/bintrayv1.gradle'

配置project的build.gradle文件

如下:

1
2
3
4
5
6
dependencies {
classpath 'com.android.tools.build:gradle:2.0.0'
classpath 'com.jfrog.bintray.gradle:gradle-bintray-plugin:1.6'
classpath "org.jfrog.buildinfo:build-info-extractor-gradle:4.0.0"
classpath 'com.github.dcendents:android-maven-gradle-plugin:1.3'
}

命令行操作上传

在AndroidStudio提供的Terminal窗口执行如下命令:

1
gradlew bintrayUpload

如果上传成功的话,几分钟后会提示BUILD SUCCESSFUL。

猜猜,这个类库引用的代码是什么样子的?如下:

1
compile 'com.loonggg.godcoder.view:circleprogressbarlibrary:1.0.1'

将上传成功的类库add到JCenter

如果以为仅仅上传成功就能用了,就大错特错了,需要将类库添加到Jcenter中之后,审核过后才能用,方式如下:

输入你的包名,找到你上传的类库,接下来会跳到一个Request to include package CircleProgressBar in jcenter的页面,写一下相关的介绍或者不写也可以,直接点击Send按钮就可以了。接下来等着审核就行了,大约1小时之内就能审核通过。

收到成功的消息后,就可以直接用了,等着吧,到这里就讲完了。

loonggg wechat
欢迎您扫一扫上面的二维码,订阅我的微信公众号「 非著名程序员」!
坚持原创技术分享,您的支持将鼓励我继续创作!