码迷,mamicode.com
首页 > 其他好文 > 详细

【踩坑速记】全面解析开源库打包发布到Bintray/Jcenter全过程(新),让开源更简单~

时间:2016-12-08 18:10:11      阅读:250      评论:0      收藏:0      [点我收藏+]

标签:ons   lun   失败   and   errors   alt   image   用户名   end   

一、写在前面

  自使用android studio开始,就被它独特的依赖方式:compile ‘com.android.support:appcompat-v7:25.0.1‘所深深吸引,自从有了它,麻麻再也不用担心依赖第三方jar包繁琐无趣啦。而,如果自己写一个开源库是一种怎样的体验,此乃利(装)国(逼)利(神)民(器)呀!

  而一路装逼不易,你会发现如果你要发布你的开源库到官方的Bintray/Jcenter并非易事,所以先去网上一探究竟,简单的,难的,五花八门,全(误)面(人)具(子)备(弟)!

  不得不感叹,学技术本身不难,难于达到一个目的的有多种方式,而各种方式参差不齐,给新手带来很大困惑。但是没办法,谁叫你是初学者呢,你所能做的,只能一步一步的折腾自己。

  网上的帖子真多呀,五花八门,注册账号有问题,编写过程有问题,版本不一致有问题,install有问题....每个人的步骤都不一致,所以难于得到一个真正正确的东西,导致你错了,却不知道错在何处,这是最难受的,好吧,程序员加班就是因为这些细节末梢的事情导致的,所以,我们要细致!!!

  其实,给个全面解析,楼主是诚惶诚恐,深怕一个小细节没有注意又去误人子弟,不过楼主也是折腾了很多时间才得以处理的,所以真心希望能给大家带来一点帮助,不足的地方,还请各位拍砖~

  废话不多说,直接进入正题,这里拿我一个随便的开源库来做处理,git地址:https://github.com/nanchen2251/CalendarView,这是一个炫酷的日历选择控件(支持左右滑动,农历,节假日显示等)

  演示效果:

  技术分享

二、注册账号

  1)首先你的有开门的钥匙,先去https://bintray.com注册一个账号吧(你也可以使用第三方登录Github,Google,但楼主发现,如果你的github一直都不能成功,原来是邮箱地址不能用qq邮箱);

  技术分享

  2)注册

  技术分享

  3)提交注册信息

  技术分享

  4)创建组织和仓库

  技术分享

  5)填写基本信息

  技术分享

三、配置项目相关

  1)在project的build.grald添加

 classpath ‘com.jfrog.bintray.gradle:gradle-bintray-plugin:1.4‘
classpath ‘com.github.dcendents:android-maven-gradle-plugin:1.4.1‘

  技术分享

  2)module里面添加

  

//配置插件
apply plugin: ‘com.github.dcendents.android-maven‘
apply plugin: ‘com.jfrog.bintray‘

  技术分享

  3)Module的build.gradle里面添加如下代码,注意注释

version = "1.0.7"    //这个是版本号,必须填写
def siteUrl = ‘https://github.com/nanchen2251/CalendarView‘ // 项目的主页
def gitUrl = ‘https://github.com/nanchen2251/CalendarView‘ // Git仓库的url

group = "com.nanchen.calendarview" // 这里是groupId ,必须填写  一般填你唯一的包名

install {
    repositories.mavenInstaller {
        // This generates POM.xml with proper parameters
        pom {
            project {
                packaging ‘aar‘
                // 项目描述,复制我的话,这里需要修改。
                name ‘a view with the lunar calendar‘   //项目描述
                url siteUrl
                // 软件开源协议,现在一般都是Apache License2.0吧,复制我的,这里不需要修改。
                licenses {
                    license {
                        name ‘The Apache Software License, Version 2.0‘
                        url ‘http://www.apache.org/licenses/LICENSE-2.0.txt‘
                    }
                }
                //填写开发者基本信息,复制我的,这里需要修改。
                developers {
                    developer {
                        id ‘nanchen‘            //你公司的id
                        name ‘nanchen2251‘      //你的用户名
                        email ‘liushilin520@foxmail.com‘ // 你的邮箱
                    }
                }

                // SCM,复制我的,这里不需要修改。
                scm {
                    connection gitUrl
                    developerConnection gitUrl
                    url siteUrl
                }
            }
        }
    }
}
// 生成jar包的task,不需要修改。
task sourcesJar(type: Jar) {
    from android.sourceSets.main.java.srcDirs
    classifier = ‘sources‘
}
// 生成javaDoc的jar,不需要修改
task javadoc(type: Javadoc) {
    options.encoding = "UTF-8"
    source = android.sourceSets.main.java.srcDirs
    classpath += project.files(android.getBootClasspath().join(File.pathSeparator))
}
task javadocJar(type: Jar, dependsOn: javadoc) {
    classifier = ‘javadoc‘
    from javadoc.destinationDir
}

//下面设置编码格式,重点注意,如果不设置可能会在gradlew install的时候出现GBK编码映射错误
javadoc {
    options {
        encoding "UTF-8"
        charSet ‘UTF-8‘
        author true
        version true
        links "http://docs.oracle.com/javase/7/docs/api"
        title ‘A CalendarView Support Lunar Calendar For Android‘   // 文档标题
    }
}

artifacts {
//    archives javadocJar
    archives sourcesJar
}

// 生成jar包
task releaseJar(type: Copy) {
    from( ‘build/intermediates/bundles/release‘)
    into( ‘../jar‘)
    include(‘classes.jar‘)
    rename(‘classes.jar‘, ‘okgo-‘ + version + ‘.jar‘)
}

// 这里是读取Bintray相关的信息,我们上传项目到github上的时候会把gradle文件传上去,
// 所以不要把帐号密码的信息直接写在这里,写在local.properties中,这里动态读取。
Properties properties = new Properties()
properties.load(project.rootProject.file(‘local.properties‘).newDataInputStream())
bintray {

    //读取 local.properties 文件里面的 bintray.user
    user = properties.getProperty("bintray.user")

    //读取 local.properties 文件里面的 bintray.apikey
    key = properties.getProperty("bintray.apikey")

    configurations = [‘archives‘]
    pkg {
        userOrg = "nanchen"        //发布到JCenter的组织,注意新版本的bintray是需要手动创建的
        repo = "maven"              //发布到JCenter上的仓库名称,注意新版本的bintray是需要手动创建的
        // 发布到Bintray上的项目名字
        name = "calendarview-library"
        websiteUrl = siteUrl
        vcsUrl = gitUrl
        licenses = ["Apache-2.0"]
        publish = true  // 是否是公开项目  
    }
}

  4)一些说明

  注意:上面的userOrg是组织(organization)的id(上面创建过的),很多帖子都没有这个或者写的是用户名,新版本要使用你创建的组织名称,否则失败;repo是仓库(repository)的名称(上面创建的),我当初就是看的帖子这里说的不清楚怎么也不能成功。

  如果忘记了,则可以这样查看,组织对应id,仓库对应repo,项目对应上面的name。

技术分享

 

   5)如果不出意外,这时候你已经可以在android studio的命令行操作Terminal工作空间输入gradlew install;

技术分享

  6)如果你成功了,则可以在module的build/outputs下面看到你的aar文件

技术分享

  7) 这时候你可以通过命令行输入gradlew bintrayUpload上传到bintray仓库。

  技术分享

   8)一切准备就绪,你这时候已经可以在bintray中看到你的库了,最后点击Add to Jcenter申请审核吧(一般2-3小时可以审核)

技术分享

   9)发送请求

技术分享

    填下你的groupId,直接send,就会发起一个打包版本的请求, 
    过几个小时,通过jcenter那边的审核就会在bintray上收到jcenter那边的同意消息提醒。 
    恭喜你,你的类库上传到jcenter成功了!大家都可以用你的类库了。

  

  10)开源库的后续更新

    我们上传完成后,如果发现类库中出现类库中的一个bug,这就涉及到更新问题,那么怎么更新呢?

    你只需要在,修改代码后,该本地build.gradle的版本号,按上面的操作,执行gradlew install,gradlew bintrayUpload,到bintray上点击Stage snapshots on oss.jfrog.org”同样发送一个请求,不用几分钟,就可以用了,升级,不像首次提交那样,非常快。马上就你可以更新github上的引用版本号,瞬间心情爽爽哒。

 

五、一些踩过的坑

  1)Lint found errors in the project

  Lint 检查默认是开启的,Lint 会检查项目中的语法错误,如果没有通过则无法继续。只需要在 Module 的 build.gradle 添加如下代码:

android {
    lintOptions {
        abortOnError false
    }
}

  2)编码问题

  也许你会遇到这样:

技术分享

  在 windows 下 javadoc 默认的是系统编码,Windows 就是 GBK 编码。所以一旦 java 文件中出现中文注释就会报错,提示无法映射的GBK编码。

task javadoc(type: Javadoc) {
    options.encoding = "utf-8"
}

  如果还不行,则采用我上面的方式 

//下面设置编码格式,重点注意,如果不设置可能会在gradlew install的时候出现GBK编码映射错误
javadoc {
    options {
        encoding "UTF-8"
        charSet ‘UTF-8‘
        author true
        version true
        links "http://docs.oracle.com/javase/7/docs/api"
        title ‘A CalendarView Support Lunar Calendar For Android‘   // 文档标题
    }
}

 

【踩坑速记】全面解析开源库打包发布到Bintray/Jcenter全过程(新),让开源更简单~

标签:ons   lun   失败   and   errors   alt   image   用户名   end   

原文地址:http://www.cnblogs.com/liushilin/p/6145749.html

(0)
(0)
   
举报
评论 一句话评论(0
登录后才能评论!
© 2014 mamicode.com 版权所有  联系我们:gaon5@hotmail.com
迷上了代码!