一步一步教你将开源项目上传到jcenter(第一种方式)

简介: 一步一步教你将开源项目上传到jcenter(第一种方式)

最近闲着看了一下jcenter的使用,也想将自己使用频率比较高的东西抽成类库,然后通过compile来使用,提高开发效率,本来以为挺简单的,但是网上介绍的比较模糊,很多博客也比较老了,不适用,花了我一天的时间,还是走了很多弯路,这里记录下来,希望能帮助到小伙伴们,现在觉得还是挺简单的。


 发布到jcenter有两种方式,一种是gradle-bintray-plugin,一种bintray-release

 本篇文章将介绍第一种gradle-bintray-plugin,第二种方法参见我的下一篇文章: 一步一步教你将开源项目上传到jcenter(第二种方式))


下面我们来看看本章的操作步骤:


第一步:


 首先是注册,这就是我踩的最大的一个坑,导致我一天都没有上传成功。网上说的都是去jcenter的网站上注册就可以,其实不然,英文好的最好去看英文文档,一步一步来操作。


个人正确的注册地址:https://bintray.com/signup/oss

个人正确的注册地址:https://bintray.com/signup/oss

个人正确的注册地址:https://bintray.com/signup/oss

重要的事情说三遍,一定要到这个网址去注册。


 打开界面是这样的,一定要选择我打标记的这个,默认的话是第一个,这就是坑,所以一定要看清楚再注册。  


20170502194821747.png


注:这里用普通的邮箱(qq,163这些都不好使)是行不通的,最好使用google邮箱或者outlook邮箱。

注册完成后界面是这样的,看下图:

20170502202246998.png


但是,如果你注册后界面是下面这样的:

20170502202324155.png

看不到New Repository,就说明你注册错了,踩了我的第一个坑。删除账号信息后,重新注册吧。

注册完成后我们点击Add New Repository,新建一个仓库。

注:创建的maven仓名字和类型都要写成maven,如下图所示:

20170502202800668.png


然后我们开始获取user和key,至于为什么要,我们后面再说:

20170502203026407.png


20170502203040173.png


这样我们jcenter的工作就做好了,然后准备我们上传的开源项目,这个比较简单,我就随便说了。


第一步:

  先新建一个项目,然后在这个项目下新建一个Android LIbrary的Module,自己的开源库就在这个Module里面开发,如下图:


20170502203438598.png



第二步:


 在这个新建的Module里面,开发自己的开源项目,然后,在原来的项目里是可以直接引用Module里在代码的。但运行的时候会报错,需要在项目的build.gradle中添加如下代码:

compile project(':CommonUtilLibrary')


后面单引号里面,是自己创建的Module名字。然后,再重新运行整个项目,就可以把Module也编译进去了。


第三步:


 编写工程的build.gradle文件,记住,是工程的。先打开项目的build.gradle文件,一定是项目的build文件,然后在里面添加如下代码:

buildscript {
    repositories {
        jcenter()
    }
    dependencies {
        classpath 'com.android.tools.build:gradle:2.3.1'
        classpath 'com.jfrog.bintray.gradle:gradle-bintray-plugin:1.2'
        classpath 'com.github.dcendents:android-maven-gradle-plugin:1.5'
    }
}

记住,代码有的就保留下来,没有的加上去。


注意:这里Sync有时候会报 Error:(2, 0) No service of type Factory…这样的错误,主要是因为这一行:


classpath 'com.github.dcendents:android-maven-gradle-plugin:1.5'

如果报错了的话,就自己去官网上看最新的插件版本号,改了就可以了。

这里添加完后完整的build.gradle应该是这样的:  

20170502204332680.png

然后再打开将要上传的Module的build.gradle文件,添加如下代码:

apply plugin: 'com.github.dcendents.android-maven'
apply plugin: 'com.jfrog.bintray'
def siteUrl = 'https://github.com/caijin199410/CommonUtil.git'      // 项目的主页   这个是说明,可随便填
def gitUrl = 'https://github.com/caijin199410/CommonUtil.git'      // Git仓库的url  这个是说明,可随便填
group = "com.abrahamcaijin"    // 这里是groupId ,必须填写  一般填你唯一的包名,对应com.squareup.okhttp3:okhttp:3.4.1中的com.squareup.okhttp3部分
install {
    repositories.mavenInstaller {
        // This generates POM.xml with proper parameters
        pom {
            project {
                packaging 'aar'
                // Add your description here
                name 'CommonUtil'     //项目描述
                url siteUrl
                // Set your license
                licenses {
                    license {
                        name 'The CommonUtil Software License, Version 1.0.0'
                        url 'http://www.apache.org/licenses/LICENSE-2.0.txt'
                    }
                }
                developers {
                    developer {
                        id 'caijinabraham'        //填写开发者的一些基本信息
                        name 'caijinabraham'    //填写开发者的一些基本信息
                        email 'caijinabraham@outlook.com'   //填写开发者的一些基本信息
                    }
                }
                scm {
                    connection gitUrl
                    developerConnection gitUrl
                    url siteUrl
                }
            }
        }
    }
}
task sourcesJar(type: Jar) {
    from android.sourceSets.main.java.srcDirs
    classifier = 'sources'
}
task javadoc(type: Javadoc) {
    options {
        encoding "UTF-8"
        charSet 'UTF-8'
        author true
        version true
        links "http://docs.oracle.com/javase/7/docs/api"
    }
    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.file('local.properties').newDataInputStream())
bintray {
//    userOrg=properties.getProperty("bintray.user")
    user = properties.getProperty("bintray.user")    //读取 local.properties 文件里面的 bintray.user
    key = properties.getProperty("bintray.apikey")   //读取 local.properties 文件里面的 bintray.apikey
    configurations = ['archives']
    pkg {
        repo = "maven"
        name = "CommonUtil"    //发布到JCenter上的项目名字,必须填写,对应com.squareup.okhttp3:okhttp:3.4.1中的okhttp
        publishVersion = ‘1.0.0’//发布到JCenter上的项目版本号
        websiteUrl = siteUrl
        vcsUrl = gitUrl
        licenses = ["Apache-2.0"]
        publish = true
    }
}



添加完成后,完整的build.gradle应该是这样的:


20170503102302682.png

20170503102314167.png

20170503102322889.png



 最后需要在本地的local.properties里面添加以下内容:

bintray.user=YOUR_BINTRAY_USERNAME  
bintray.apikey=YOUR_BINTRAY_API_KEY

如图所示:

20170502205338030.png

第四步:

  打开android studio的命令行:

20170502205523062.png

输入如下命令:

输入命令:

gradlew install
gradlew bintrayUpload


当这两个命令都成功显示BUILD SUCCESSFUL就可以了,或者不执行上面这两个命令,直接合成执行下面这个命令就可以了:


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

记住要把user和key换成自己的,同样要显示BUILD SUCCESSFUL才可以。


最后要将项目发布到jcenter:


 上传开源库到jcenter的办法很多,可以百度,这里看看我的就可以了,打开jcenter的主页,进入自己新建的maven仓库里面,你就可以看到自己推上来的开源项目了,如下图所示:  

20170502210303747.png


20170502210311200.png

然后需要等待审核通过,一般5-6小时。在审核通过前可以通过配置自己私有仓地址使用。

20170502210522031.png


然后在项目的根目录下build.gradle配置地址:

20170502210735144.png


然后在要是使用的Module的build.gradle里面添加依赖,项目中加入依赖即可:

compile 'com.abrahamcaijin:ComonUtil:1.0.0'


注意:如果这里提示依赖不成功,可以再后边加上@arr,审核通过以后可以去掉后面的@arr,暂时发现os系统上传后不需要加入便可成功,windows系统上传需要加入@arr


compile 'com.abrahamcaijin:ComonUtil:1.0.0@aar'


然后现在是1.0.0版本,我以后想增加、迭代怎么办?

 这个非常简单,当你的Library代码更改后,只需要更改一下上面的配置里面的publishVersion,运行


gradlew clean build bintrayUpload -PdryRun=false

就可以更新版本号了。这样,整个过程就结束了。

 好了,现在你就可以在你项目中依赖你的开源库了,就是这么简单!有不懂的联系我。



欢迎start,欢迎评论,欢迎指正




相关文章
|
4月前
|
开发工具 git 开发者
2024最简七步完成 将本地项目提交到github仓库方法
该文章提供了一个简洁的七步教程,指导用户如何将本地项目提交到GitHub仓库。
2024最简七步完成 将本地项目提交到github仓库方法
|
7月前
|
XML Java Maven
【Maven技术专题】「知识盲区」教你如何使用深入分析Maven配置私服仓库的使用指南
【Maven技术专题】「知识盲区」教你如何使用深入分析Maven配置私服仓库的使用指南
132 0
|
JSON 搜索推荐 Java
做了个springboot接口参数解密的工具,我给它命名为万能钥匙(已上传maven中央仓库,附详细使用说明)
更新的功能具体使用示例已经更新到博文中,请在目录中找到对应位置查看
|
4月前
|
存储 前端开发 数据可视化
一文教会你 如何在Github中创建仓库?如何将多个项目放到一个仓库中管理?如何将本地项目上传到GitHub中?
这篇文章详细介绍了如何在GitHub上创建新仓库,以及如何将多个项目整合到一个仓库中进行管理。文章还提供了克隆仓库到本地、使用不同文件夹存放不同项目代码、以及将这些项目提交到远程服务器的步骤和方法。
一文教会你 如何在Github中创建仓库?如何将多个项目放到一个仓库中管理?如何将本地项目上传到GitHub中?
怎样在GitHub上建立仓库、以及怎样实现分支代码的合并。保姆级别的教程
这篇文章是一份详细的GitHub使用教程,介绍了如何在GitHub上创建仓库、创建分支、编辑和发布更改内容、发起拉取请求以及合并分支的操作步骤。
怎样在GitHub上建立仓库、以及怎样实现分支代码的合并。保姆级别的教程
|
7月前
|
程序员 开发工具 git
【实测】gitlab/github 如何过滤项目内的文件
【实测】gitlab/github 如何过滤项目内的文件
|
Cloud Native Java Go
解决Maven依赖下载问题:从阿里云公共仓库入手
解决Maven依赖下载问题:从阿里云公共仓库入手
1242 0
|
Java Maven
使用maven仓库?每次都是自定义,设置稳定maven本地库地址
使用maven仓库?每次都是自定义,设置稳定maven本地库地址
406 0
使用maven仓库?每次都是自定义,设置稳定maven本地库地址
|
Java Maven
一步一步教你将开源项目上传到jcenter(第二种方式)
一步一步教你将开源项目上传到jcenter(第二种方式)
|
IDE 开发工具 git
使用gitee做为仓库管理项目,适合新手,详细有图
使用gitee做为仓库管理项目,适合新手,详细有图
199 0
使用gitee做为仓库管理项目,适合新手,详细有图

热门文章

最新文章