前提
之前写了一份Android 发布在线库到jitpack详解的文章,有人会问为啥又要写一份关于上传开源库到jcenter的文章呢?我想说多做一手准备永远不会过时,不要把鸡蛋放到一个篮子里。
正文
闲话不多说直接进入今天的主题,如何发布在线库到jcenter呢?和jitpack不同的是,如果你需要发布在线库到jcenter首先需要登录和创建你的仓库名称。如果有人说jitpack也是需要登录,我只想说那是因为你要发布私有库,是需要money的,当然也是很简单的,这个不在今天的讨论范围之内。
首先
-
第一步:当然是需要注册了,个人注册地址 jcenter提供了几种注册方式:GitHub注册、Twitter注册、Google注册和直接在jcenter注册,我这里使用的是用直接在jcenter注册的。当然,你还可以使用其他方式注册。注册的时候网络不佳,需要耐心等待。
-
第二步:创建你的个人仓库
如上图所示,填写完成后点击create即可创建成功,如果网络不佳,需要你多次创建
其次
接下来就是对你自己的库进行设置了,这块是__重点__需要在你的库的build文件中配置,下面看如何去做。
-
第一步:在你工程(Project下)的build.gradle文件下添加jcenter的依赖
//这里的customsdk是我的在线库的名称,你需要换成你自己的 tasks.getByPath(":customsdk:javadoc").enabled=false //下面这两句 classpath 'com.github.dcendents:android-maven-gradle-plugin:2.1' classpath 'com.jfrog.bintray.gradle:gradle-bintray-plugin:1.8.4'
注意: 1、这里的插件版本是和我本地的gradle相匹配的,你也可以修改你插件的版本; 2、这里的customsdk是我的在线库的名称,你需要换成你自己的。
Maven:github.com/dcendents/a…
Jfrog Bintray:github.com/bintray/gra…
-
第二步:修改你项目(moudle下)的build版本
//项目主页 def siteUrl = 'https://github.com/xxx/CustomAndroidJcenter' //项目的git地址 def gitUrl = 'https://github.com/xxx/CustomAndroidJcenter.git' //发布到JCenter上的项目名字 def libName = "CustomSDKAndroid" //发布到组织名称名字,必须填写 group = "com.yk.CustomSDKAndroid" // 版本号,下次更新是只需要更改版本号即可 version = "1.0.3" //上面配置后上传至JCenter后的编译路径是这样的: implementation 'com.yk.CustomSDKAndroid:library:1.0.3' //生成源文件 task sourcesJar(type: Jar) { from android.sourceSets.main.java.srcDirs classifier = 'sources' } //生成Javadoc文档 task javadoc(type: Javadoc) { source = android.sourceSets.main.java.srcDirs classpath += project.files(android.getBootClasspath().join(File.pathSeparator)) } //文档打包成jar task javadocJar(type: Jar, dependsOn: javadoc) { classifier = 'javadoc' from javadoc.destinationDir } //拷贝javadoc文件 task copyDoc(type: Copy) { from "${buildDir}/docs/" into "docs" } //上传到JCenter所需要的源码文件 artifacts { archives javadocJar archives sourcesJar } // 配置maven库,生成POM.xml文件 install { repositories.mavenInstaller { // This generates POM.xml with proper parameters pom { project { packaging 'aar' //项目描述,随意填 name 'custom Sdk' url siteUrl licenses { license { //开源协议 name 'The Apache Software License, Version 2.0' url 'http://www.apache.org/licenses/LICENSE-2.0.txt' } } developers { developer { //开发者的个人信息 id 'xxxx' name '木易' email 'xxx@gmail.com' } } scm { connection gitUrl developerConnection gitUrl url siteUrl } } } } } //上传到JCenter Properties properties = new Properties() properties.load(project.rootProject.file('local.properties').newDataInputStream()) bintray { user = properties.getProperty("bintray.user") //读取 local.properties 文件里面的 bintray.user key = properties.getProperty("bintray.apikey") //读取 local.properties 文件里面的 bintray.apikey configurations = ['archives'] pkg { //这里的repo值必须要和你创建Maven仓库的时候的名字一样 repo = "CustomSDK" //发布到JCenter上的项目名字 name = libName //项目描述 desc = 'custom Sdk' websiteUrl = siteUrl vcsUrl = gitUrl licenses = ["Apache-2.0"] publish = true } } javadoc { options{ //如果你的项目里面有中文注释的话,必须将格式设置为UTF-8,不然会出现乱码 encoding "UTF-8" charSet 'UTF-8' author true version true links "http://docs.oracle.com/javase/7/docs/api" } }
-
第三步:在你的local.properties文件下填入在jcenter上的相关配置
//用户名(jcenter上的) bintray.user=xxxx //key(jcenter上的) bintray.apikey=**********************************
上面的步骤完成,到此配置就完成了。
- 第四步:到这一步就可以开始编译本地版本了。
打开Android Studio底部工具栏的Terminal窗口,输入命令:
windows上
gradlew install, 显示“BUILD SUCCESSFUL”即表示成功。
Mac上
./gradlew install。 显示“BUILD SUCCESSFUL”即表示成功
如果Mac上显示没有权限,在输入上面的命令之前输入下面的命令:chmod +x gradlew即可
到这里已经成功一半了,只差上传到Bintray了。然后我们接着在Terminal窗口输入命令:
Windows上
gradlew bintrayUpload 显示“BUILD SUCCESSFUL”即表示成功。
Mac上
./gradlew bintrayUpload 显示“BUILD SUCCESSFUL”即表示成功。
最后
到此,Android studio上的配置就完成了,接下来看jcenter上的相关配置。
- 第一步:打开你的jcenter,就可以看到类似下图所示的在线库了,到这里还没有完哦
- 第二步:提交项目到Jcenter
点开刚刚提交项目的主页,点击右下角的添加到jcenter按钮
- 第三步:等待审核(大概一个小时左右)
- 第四步:审核回复
- 第五步:你自己的依赖
当然,里面也有maven等其他依赖方式,你可以自行选择。
总结
到此为止,我们的发布在线库到jcenter的文章就写完了。分了几步,jcenter注册----->as中build的设置--->jcenter发布---->等待审核---->审核完成等。
如果有不明白的地方可以加群探讨(493180098)