jitpack如何依赖自己的私有仓库

前言

JCenter解释: JCenter是一个Java/Android工程的包管理Maven仓库,由bintray.com维护,是目前世界上最大的Java仓库

JitPack官方解释: 易于为JVM和Android库使用包存储库，JitPack根据需要构建GitHub项目，并发布随时可用的包

在我们的日常开发当中,经常会引入一些第三方的库来实现一些功能,如下

方式1: 发布到JCenter的库进行如下依赖:

//在app的build.gradle或者module的build.gradle下添加如下代码dependencies { implementation 'org.greenrobot:eventbus:3.2.0'}

方式2: 发布到JitPack的库进行如下依赖

//在project的build.gradle中添加如下代码allprojects { repositories { //... maven { url 'https://jitpack.io' } }} //在app的build.gradle或者module的build.gradle下添加如下代码dependencies { implementation 'com.github.sweetying520:AndroidUtils:1.0.1'}

经过上面的操作,我们就可以使用这些第三方库的功能了

注意:

JitPack和JCenter都是第三方的代码仓库,在我们使用AndroidStudio新建一个项目的时候默认引入了JCenter,因此我们发布到Jcenter的库就可以直接在app的build.gradle或者module的build.gradle添加依赖即可,而JitPack没有引入,因此在添加app的build.gradle或者module的build.gradle的依赖的时候,需在project中的build.gradle中引入JitPack的仓库,添加其他第三方库下的依赖也是如此

问题: 我们如何将自己写的Android库被别人优雅的引用呢？

答案: 将我们编写好的Android库发布到JCenter或者JitPack仓库或者自己的本地仓库,在按照如上方式引用

方式一: 发布Android库到JCenter 步骤1: 注册Bintray账号 注册地址

注意:

不要在官网注册，因为官网注册的是企业版，我们需要的是个人版（建议）直接关联 Github账号进行注册 & 登录

步骤2: 在Bintray上创建仓库

点击红框中的Add New Repository创建一个仓库

步骤3: 按步骤填写相关配置

注意

填写仓库名的时候,这里我们填写maven就好，这个地方遇到坑就是,当我们填写上传到Bintray的配置信息的时候,如果没有指定repoName,那么默认的repoName就为maven,如果指定了就填写你创建的仓库名即可

publish { userOrg = 'sweetying520' //Bintray用户名 repoName = 'maven' //Bintray上创建的仓库名,如果你创建的是maven,则可以干掉这一行,否则需要指定仓库名 groupId = 'com.github.sweetying520' //依赖名implementation 'x:y:z'中的x artifactId = 'AndroidUtils' //依赖名implementation 'x:y:z'中的y publishVersion = '1.0.0' //依赖名implementation 'x:y:z'中的z desc = 'AndroidUtils is a library of tools to help developers improve their productivity' //对这个库的描述 website = 'https://github.com/sweetying520/AndroidUtils' //VCS地址,填写该项目的Github地址就好}

步骤4: 在代码项目中创建Module，并将项目上传到Github

注意

Module我已经创建好了,这里只是演示过程

新建Module

选择Android Library

在Module中编写一些测试代码,方便上传成功后验证

将自己的这个项目上传到Github,如何上传到Github不懂的自己上网查一下

步骤5: 配置上传插件并上传到JCenter

注意

网上大部分教程推荐我们使用bintray-release插件上传,但是这个插件不支持Gradle版本为6.+的,因此这里我推荐大家使用另外一个插件传送门,它是基于bintray-release插件做了一些改造,然后支持Gradle版本为6.+上传

在你module的build.gradle下配置如下代码即可 //================================bintray 上传插件配置 start=========================================apply plugin: 'com.github.panpf.bintray-publish'//防止中文注释出现错误allprojects { tasks.withType(Javadoc) { options.addStringOption('Xdoclint:none', '-quiet') options.addStringOption('encoding', 'UTF-8') }}buildscript { repositories { jcenter() } dependencies { //上传插件 classpath 'com.github.panpf.bintray-publish:bintray-publish:1.0.0' }}//下面这些配置换成你自己的即可publish { userOrg = 'sweetying520' //Bintray用户名 repoName = 'maven' //Bintray上创建的仓库名,如果你创建的是maven,则可以干掉这一行,否则需要指定仓库名 groupId = 'com.github.sweetying520' //依赖名implementation 'x:y:z'中的x artifactId = 'AndroidUtils' //依赖名implementation 'x:y:z'中的y publishVersion = '1.0.0' //依赖名implementation 'x:y:z'中的z desc = 'AndroidUtils is a library of tools to help developers improve their productivity' //对这个库的描述 website = 'https://github.com/sweetying520/AndroidUtils' //VCS地址,填写该项目的Github地址就好}//================================bintray 上传插件配置 end=========================================

上传项目到JCenter

在你的AndroidStudio的Terminal中执行如下命令命令:

//如果是Windows系统:gradlew clean build bintrayUpload -PbintrayUser="Bintray用户名" -PbintrayKey="Binary得到的API Key" -PdryRun=false如果是Mac系统:./gradlew clean build bintrayUpload -PbintrayUser="Bintray用户名" -PbintrayKey="Binary得到的API Key" -PdryRun=false

上面PbintrayUser代表注册的用户名，PbintrayKey就是需要在Binary得到的API Key，PdryRun是一个配置参数，为true的时候，会运行所有的环节，但是不会上传

如何获取Binary得到的API Key?

点击1的Edit Profile

点击2的API Key

输入3的密码即可获取API Key

至此,已经将项目上传到JCenter上面去了,我们可以查看库相关信息

但是这个时候,我们的库还不能被外界给引用到

步骤6: 添加到JCenter

从Bintray上打开查看该库的信息,点击添加Add to JCenter按钮

填写一些对library的描述，然后发送，等待审核,审核时间一般几分钟到几个小时,工作日会快点,审核通过后会邮件通知你，这个时候就可以愉快的通过依赖使用这个库了

在你的App或者Module的build.gradle中添加如下代码就可以使用了

dependencies { implementation 'com.github.sweetying520:AndroidUtils:1.0.0'}

验证效果,我的Demo中是用Toast显示一句"二代666"

关于后续版本更新

修改module中build.gradle的配置版本号

在你的AndroidStudio的Terminal中执行如下命令:

//如果是Windows系统:gradlew clean build bintrayUpload -PbintrayUser="Bintray用户名" -PbintrayKey="Binary得到的API Key" -PdryRun=false如果是Mac系统:./gradlew clean build bintrayUpload -PbintrayUser="Bintray用户名" -PbintrayKey="Binary得到的API Key" -PdryRun=false

执行完之后,等待一段时间,你就可以去Bintray上看到你更新的版本了

方式二: 发布Android库到JitPack

还是以上面这个编写的库为例

步骤1：创建好项目并编写Android库 步骤2：配置上传插件并上传至Github

注意

插件版本可以使用最新的,以官网为主 传送门

在你module的build.gradle中进行如下配置:

//==============================JitPack 上传插件配置 start=====================apply plugin: 'com.github.dcendents.android-maven'//组名 com.github是固定的,后面的sweetying520是我Github的用户名,替换成你自己的就可以了group='com.github.sweetying520'buildscript { repositories { jcenter() } dependencies { //这里我写的时候是这个版本 classpath 'com.github.dcendents:android-maven-gradle-plugin:2.1' }}//==============================JitPack 上传插件配置 end=======================

将项目上传到Github,不懂如何上传的自己上网查一下

步骤3：打开项目的github主页，创建一个Release或Tag

点击如下图指示

创建一个Release或者Tag

注意

首次进来是这样子的

创建过版本之后,进来是这样子的

创建版本

步骤4: 将项目的仓库提交到JitPack

打开JitPack,并登陆(使用的是你的Github账号登陆即可)

将你的项目Github地址放入搜索栏,点击look up,这个时候就会进行编译,等待编译完成即可,下面的Version是我之前生成的一些版本

编译完成后JitPack会自动给你生成相关的配置信息,按照如下配置,配置你的项目即可

最后就可以愉快的进行使用了!!!

关于后续版本更新 将修改好的东西上传到Github打开项目的github主页，创建一个Release或Tag(这个步骤就是重复步骤3)将项目的仓库提交到JitPack(这个步骤就是重复步骤4) 总结

到这里,两种引用方式就都介绍完了,对比下这两种上传库的方式:

上传到JitPack: 简单,省时,项目依赖的时候,需引入JitPack仓库

上传到JCenter: 流程相对JitPack复杂一点,项目依赖的时候,直接引用即可,但是上传的过程中可能会遇到一些坑,文中都已经做了说明,因此按照我的步骤走,应该就没啥问题

欢迎点赞,留言和转发,你的认可是我创作的动力！！！