使用Android Studio发布Android library到jCenter实战

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

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
平台声明:文章内容(如有图片或视频亦包括在内)由作者上传并发布,文章内容仅代表作者本人观点,简书系信息发布平台,仅提供信息存储服务。

推荐阅读更多精彩内容