详细文章请看:[Gradle系列]Gradle发布module库到jcenter, 并构建自己的企业Maven私服

平常在工作中我们常常会引用到第三方开源库,比如butterknife, Gilde, RxJava等等。其中最简单方便快捷的方式就是在gradle中用compile引用,例如

compile 'io.reactivex:rxjava:1.1.3'

有没有想过自己也写一个开源库提供一个引用给别人用?本文介绍如何自己创建一个库给别人用。

首先你要得有库

创建库很简单,网上有大把的事例教程,为了节约篇幅本文只做简单介绍。

在AndroidStudio中先创建一个普通工程,再创建好的工程上右键选择->New->Module

Android Studio提交库至Bintray jCenter从入门到放弃-LMLPHP

在弹出窗中选择’Android Library’,这样创建的就是传说中的aar包了,一个类似传统jar的包。

然后取一个霸气的名字,这样就搞定了!(但是如果你想让你的主工程用到这个lib还需要在build.gradle中配置一番,网上文章很多不做介绍)

接下来是Bintray和jCenter

啥是Bintray?啥是jCenter?

首先说jCenter,是一个代码库,相当于一个公共的存储控件,简单的来讲就是你把你写好的aar文件及一些文档描述文件之类的东西打包上传到jCenter服务器上,其他人就可以通过jCenter服务器下载到你上传的包了。

那Bintray又是啥?Bintray是jCenter的提供商,他支持上传lib到多个平台,jCenter只是众多平台中的一个,形象的说jCenter是位于某地的仓库,Bintray是送货的卡车,你写的库就是货了。

因此我们要想把自己写的lib分享给其他人,就必须通过Bintray上传到jCenter。首先我们要去Bintray上注册一个账号,或者用Github帐号直接登录。

登录后,在https://bintray.com/profile/edit页面的左边菜单的最下面有API Key复制下来。

Android Studio提交库至Bintray jCenter从入门到放弃-LMLPHP

在工程的Root gradle中加入

dependencies {
....
classpath 'com.jfrog.bintray.gradle:gradle-bintray-plugin:1.4'
classpath 'com.github.dcendents:android-maven-gradle-plugin:1.3'
}

可参考

在library的gradle中加入:

apply plugin: 'com.github.dcendents.android-maven'
apply plugin: 'com.jfrog.bintray'
version = "0.1.1" // 修改为你的版本号

def siteUrl = 'https://github.com/h3clikejava/ExtendImageView' // 修改为你的项目的主页
def gitUrl = 'https://github.com/h3clikejava/ExtendImageView.git' // 修改为你的Git仓库的url

group = "h3c.extendimageview" // Maven Group ID for the artifact,一般填你唯一的包名

install {

repositories.mavenInstaller {

// This generates POM.xml with proper parameters

pom {

project {

packaging 'aar'

// Add your description here

name 'auto extand ImageView for Android.' //项目描述

url siteUrl

// Set your license

licenses {

license {

name 'The Apache Software License, Version 2.0'

url 'http://www.apache.org/licenses/LICENSE-2.0.txt'

}

}

developers {

developer {

id 'H3c' //填写的一些基本信息

name 'H3c'

email '[email protected]'

}

}

scm {

connection gitUrl

developerConnection gitUrl

url siteUrl

}

}

}

}

}

task sourcesJar(type: Jar) {

from android.sourceSets.main.java.srcDirs

classifier = 'sources'

}

task javadoc(type: Javadoc) {

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

}

artifacts {

archives javadocJar

archives sourcesJar

}

Properties properties = new Properties()

properties.load(project.rootProject.file('local.properties').newDataInputStream())

bintray {

user = properties.getProperty("bintray.user")

key = properties.getProperty("bintray.apikey")

configurations = ['archives']

pkg {

repo = "maven"

name = "extend-imageview" //发布到JCenter上的项目名字

websiteUrl = siteUrl

vcsUrl = gitUrl

licenses = ["Apache-2.0"]

publish = true

}

}

代码有点乱,懒癌犯了,其实蛮简单的,复制上面这一段,修改成自己的参数就好了。具体可以参考这里

这里还需要将你的bintray用户名和apikey写到工程的local.properties文件中

// 示例值, 仅供参考

bintray.user=h3 // your bintray user name

bintray.apikey=c5434272d522d35d1a0123459981225564155753 // your bintray api key

OK,以上配置完就准备上传到Bintray。

通过gradew执行即可

Android Studio提交库至Bintray jCenter从入门到放弃-LMLPHP

通常大家都会失败的,原因很多。这里非常坑爹的不做介绍!因为本文后续会教你放弃这个冗长又及其容易失败的方法。

如果你编译成功且正常上传到Bintray,那么恭喜你,你真是太牛了,接下来对于你来说就很容易了

在Versions看到你的版本就说明成功了,接下来点击Add to JCenter

Android Studio提交库至Bintray jCenter从入门到放弃-LMLPHP

输入一些描述就等待审核。审核完成后即可在第三方库中引用了。

更简单的方式novoda

看完以上的内容,相信你已经知道如何写一个lib库,并通过bintray上传到jCenter了。但是有没有觉得真的好复杂…build.gradle中要配置好多东西,几乎没法自己闭着眼睛写出来,只能从网上搜索了粘贴。

接下来介绍一个更简单的方式是用novoda库,它还是使用了bintray和jCenter,但是会大大简便build.gradle的配置方法。

首先在Root gradle中加入这句话

apply plugin: 'com.novoda.bintray-release' // must be applied after your artifact generating plugin (eg. java / com.android.library)

注意,他必须写在com.android.library 的下面

其次在你的lib gradle中写上这个

publish {
  userOrg = 'novoda'
   groupId = 'com.novoda'
  artifactId = 'bintray-release'
  publishVersion = '0.3.4'
}

在android{} 中需要加入

 lintOptions {
 abortOnError false
}

Android Studio提交库至Bintray jCenter从入门到放弃-LMLPHP

这个时候在AS的终端中运行

$ ./gradlew clean build bintrayUpload -PbintrayUser=BINTRAY_USERNAME -PbintrayKey=BINTRAY_KEY -PdryRun=false

把BINTRAY_USERNAME 替换成你的bintary的名字BINTRAY_KEY 替换成你的 Bintray的key 即可

如果成功就恭喜你,如果失败….那原因就很多了,本文坑爹的不做介绍!用飘柔就是这么自信,喜欢Bintray jCenter的同学们自己折腾去吧!

文尾福利,没错我就是飘柔

jCenter应该是目前应用最广的第三方gradle仓库了,但是其申请创建编译上传等流程实在是太麻烦了,感觉是上个世纪八十年代的产物,还需要上传,自己编译,审核之类的,超级容易失败有木有???

本文决定拿出珍藏多年的82年飘柔给大家,博主先干为敬!

JitPack也是一个代码仓库,等同于jCenter,只是暂时用的人没有jCenter多,但是越来越多的开源项目开始使用JitPack了。

真的非常非常的简单,有多简单我们来看看。

比如博主写了一个自用的Android基础库,便于快速构建工程,地址是:

AFastProject(不给我打赏的童鞋记得帮我点星…),由于引用了第三方的库,所以用本文上面两种方式发布aar都出现了问题,各种各样,要么就是无法编译,要么就是丢包,反正折腾了好久。最后用JitPack一句话解决了。。。。

首先打开网址http://jitpack.io

Android Studio提交库至Bintray jCenter从入门到放弃-LMLPHP

在输入框中输入你的Github工程地址,点击Look up

他会自动遍历出你的最近提交和发布的版本

Android Studio提交库至Bintray jCenter从入门到放弃-LMLPHP

点击你要引用的选择Get it

Android Studio提交库至Bintray jCenter从入门到放弃-LMLPHP

在文尾就会告诉你如何引用。

是的,你没看错,客户端什么都不用改。其他工程可以直接引用!

呵呵……用飘柔就是这样么自信

原文链接:http://www.jianshu.com/p/31410d71eaba

05-11 14:45