Android Studio 发布项目到 JCenter 以及常见错误

项目发布到JCenter好处多多,最明显的就是只需在gradle里添加一行依赖就可以轻松引入。随着Android Studio的普及,越来越多的项目已经传到了JCenter。
不过这用起来十分简单轻松的东西,上传之路真是道阻且长,各种坑多得数不清。折腾了3小时终于成功传上去了,记录一下过程和常见问题,希望大家少踩点坑吧。

关于插件

网上很多教程都采用gradle-bintray-plugin,根据研究,这个插件配置及其复杂,各种意想不到的错误层出不穷。于是采用另一个bintray-release,据说是鸿洋大神推荐的,实测也简单稳定许多。

1、注册Bintray账号

要想传到JCenter,必须经过他爸爸Bintray才可以。于是第一个坑出现了=、= 很多教程会说到https://bintray.com/注册。如果你这样做了,那么恭喜,你得重新弄了。因为Bintray政策已经改变,在首页注册的账号是企业账号,功能强大,当然也是要付费的。最简单的辨别方法就是在网页上方靠右有个剩余有效期。
免费版请到 https://bintray.com/signup/oss 注册。

删除账号
如果误注册成企业版占用了用户名邮箱,想注销怎么办?
其实也简单,鼠标放在右上角头像出,在弹出浮层上点击Edit Profile,拉到最下面有个Delete Account,点击验证> 后就可以注销账号。

2、引入插件

在项目build.gradle的dependencies下添加classpath:
classpath 'com.novoda:bintray-release:0.7.0'
注意是项目的不是module的bulid文件。用希望的版本号替换0.7.0,建议使用最新版本,最新版本号可以在 https://github.com/novoda/bintray-release 查看(如图)。

查看插件最新版本

3、配置要上传的moudle

下面操作均在要上传的moudle的build.gradle文件进行。

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

1
2
3
4
5
6
7
8
publish {
userOrg = '' //bintray注册的用户名(不是邮箱)
groupId = 'com.example'
artifactId = 'demo-project' //项目名称
publishVersion = '1.0.0' //版本号
desc = '' //项目描述。可空。
website = '' //项目地址,一般填github地址。可空。
}

假如按照以上设置,那么最终项目的引用格式就是:
compile 'com.example:demo-project:1.0.0'
可以对照着修改。

4、上传

一切准备就绪,可以开始上传了。很简单,直接在Android Studio Terminal面板执行:
gradlew clean build bintrayUpload -PbintrayUser=用户名 -PbintrayKey=API Key -PdryRun=false
就ok。

API Key
在bintray.com网站上登陆后,鼠标移动到右上角头像,点Edit Profile,在左侧找到API Key点击去就可以看到了。如图。
获取API Key

经过漫长等待,如果显示BUILD SUCCESSFUL ,那么恭喜,上传完成了。事实上这几乎是不可能的,它多少会出点错。这个放在最后讲。
此时进入Bintray会发现多了个Maven库,点进去里面就有我们刚刚上传的项目。

5、提交到JCenter

到此为止项目仅仅是传到了Bintray,并没有同步到JCenter。
先点进去刚传的项目,可以看到右下方Linked to模块有个Add to JCenter按钮,点击后打开一个网页,在此输入这个项目的描述(最好英文),不用多长,一句话就可以。然后点击Send可以提交审核。
通过后会有站内消息提示,一般几小时就可以通过,很容易的。

通过后的站内提示

通过后,所有人就可以直接依赖你的库啦。在库的页面可以看到引用格式。

查看引用格式

分享踩坑经历

第一次编译上传不出错是不可能的,所以各位一定要耐心点排错哦~

Could not find com.android.tools.build:gradle:3.0.0.

大意是在JCenter仓库中找不到上面说的这个项目。因为从某一版开始,谷歌把项目搬到自己仓库了。。

解决方案:在project的builde.gradle的如图位置加上google()

Lint found errors in the project; aborting build.

Lint似乎是检查代码健壮性的东西,默认情况下非常严格,难免会有几个Warning。按照提示添加代码忽略即可。

解决方案:在所有Module的build.gradle中的android块内部添加:

1
2
3
lintOptions {
abortOnError false
}

Execution failed for task ‘:xxxxxxAndroidJavadocs’.

>Javadoc generation failed. Generated Javadoc options file (useful for troubleshooting):

一般是编码问题造成的。源码大概是UTF-8,而里面恰好有中文。但是windows系统是gbk的,插件默认按照系统编码处理,于是出错了。也可能因为是javadoc检查不过关造成的错误。

解决方案:在项目的build.gradle中的allprojects块内部添加,如图:

1
2
3
4
5
6
7
8
tasks.withType(Javadoc) {
options.addStringOption('Xdoclint:none', '-quiet') //忽略javadoc错误
options{
encoding "UTF-8"
charSet 'UTF-8'
links "https://docs.oracle.com/javase/7/docs/api"
}
}

解决编码错误

参考

https://blog.csdn.net/zhcswlp0625/article/details/54895584
http://www.jcodecraeer.com/a/anzhuokaifa/Android_Studio/2015/0515/2873.html
https://blog.csdn.net/xingshen58/article/details/51644599

喜欢就赏个点心钱吧(* "・∀・)ノ――◎
0%