20171222更新
目前有更加方便的方法发布到 JCenter,详见bintray-release
前言
随着Android Studio不断完善,越来越多的Android项目开始迁移到AS平台。AS的其中一个强大之处在于使用Gradle依赖,比如我们想要依赖Universal-Image-Loader,只需要在build.gradle中添加如下代码即可
compile 'com.nostra13.universalimageloader:universal-image-loader:1.9.5'
Gradle就会自动帮我们添加依赖。今天我们就来实战把library发布到jCenter仓库。
实战
在bintray上创建package(可能需要翻墙)
- 在bintray上注册一个账号
- 在
Owned Repositories
标签下点击Add New Repository
,名字自己起,Type
选择Maven
- 打开刚刚创建的仓库,点击
Add New Package
,输入相关信息并点击Create Package
配置library
这里我们默认大家已经拥有了一个Android library,没有的话赶快去创建吧。
添加bintray插件依赖
打开我们Android library所在的project,编辑根目录下的build.gradle文件,在buildscript标签下的dependencies标签中添加bintray插件依赖
classpath 'com.jfrog.bintray.gradle:gradle-bintray-plugin:1.7.1'
classpath 'com.github.dcendents:android-maven-gradle-plugin:1.4.1'
配置bintray账号
为了安全考虑,我们将bintray账号信息放在local.properties文件中
bintray.user=YOUR_BINTRAY_USERNAME
bintray.apikey=YOUR_BINTRAY_API_KEY
user是我们bintray账户的用户名,apikey在bintray网站上Edit Profile
页面可以找到。
配置library信息
编辑library下的build.gradle文件,在apply plugin: 'com.android.library'
下面添加以下代码(这里以LrcView为例)
ext {
bintrayRepo = 'maven'
bintrayName = 'lrcview'
publishedGroupId = 'me.wcy'
artifact = 'lrcview'
libraryName = 'lrcview'
libraryVersion = rootProject.ext.versionName
libraryDescription = 'A lyric view on Android'
siteUrl = 'https://github.com/wangchenyan/LrcView'
gitUrl = 'https://github.com/wangchenyan/LrcView.git'
developerId = 'wangchenyan'
developerName = 'wcy'
developerEmail = '919247701@qq.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 name。其余的项也修改成和你library信息相匹配的值。
注意:我们上传到bintray的library会以本地library的Module name命名,因此为了减少不必要的麻烦,我们应该使本地library的Module name和bintray上的package name保持一致。
添加构建和上传脚本
再次编辑library下的build.gradle文件,在文件的最后追加两行如下的代码来应用两个脚本,用于构建library文件和上传文件到bintray(为了方便,我直接使用了github上连接到相关文件的链接):
apply from: 'https://raw.githubusercontent.com/nuuneoi/JCenter/master/installv1.gradle'
apply from: 'https://raw.githubusercontent.com/nuuneoi/JCenter/master/bintrayv1.gradle'
把library上传到你的bintray空间
点击Android Studio的终端选项卡。
第一步是检查代码的正确性,以及编译library文件(aar,pom等等),输入下面的命令
gradlew install
如果没有什么问题,会显示BUILD SUCCESSFUL
现在我们已经成功一半了。下一步是上传编译的文件到bintray(可能需要翻墙),使用如下的命令
gradlew bintrayUpload
如果上传成功,同样会显示BUILD SUCCESSFUL
至此,我们已经成功的将library上传到我们自己的Maven仓库了,当然,还是“自己”的,别人还不能用。
同步bintray用户仓库到jcenter
打开我们的package详情页,点击Add to JCenter
,然后什么也不做直接点击Send。
现在我们所能做的就是等待bintray团队审核我们的请求,大概2-3个小时。一旦同步的请求审核通过,你会收到一封确认此更改的邮件。
大功告成!从此之后,任何开发者都可以使用jcenter() repository 外加一行gradle脚本来使用我们的library了
compile 'me.wcy:lrcview:1.0.0'
参考
How to distribute your own Android library through jCenter and Maven Central from Android Studio