美文网首页Android开发经验谈程序员
Android Studio 发布项目到 JCenter 以及常

Android Studio 发布项目到 JCenter 以及常

作者: 0晨鹤0 | 来源:发表于2017-11-02 00:21 被阅读0次

    项目发布到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'
    添加

    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块内部添加:

        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块内部添加,如图:

        tasks.withType(Javadoc) {
            options.addStringOption('Xdoclint:none', '-quiet') //忽略javadoc错误
            options{
                encoding "UTF-8"
                charSet 'UTF-8'
                links "http://docs.oracle.com/javase/7/docs/api"
            }
        }
    
    解决编码错误

    参考

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

    相关文章

      网友评论

        本文标题:Android Studio 发布项目到 JCenter 以及常

        本文链接:https://www.haomeiwen.com/subject/svunpxtx.html