“一篇就够”系列: 发布开源库到JitPack,JCenter详

2021-01-10 本文已影响0人 sweetying

前言

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账号进行注册 & 登录

image-20210111110824382

步骤2: 在Bintray上创建仓库

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

步骤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地址就好
}

image-20210110140857448

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

注意

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

新建Module
image-20210110144659112
选择Android Library
image-20210110145022512
在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
1. 在你的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的时候，会运行所有的环节，但是不会上传
2. 如何获取Binary得到的API Key?
  1. 点击1的Edit Profile
  2. 点击2的API Key
  3. 输入3的密码即可获取API Key
    image-20210110152109989

至此,已经将项目上传到JCenter上面去了,我们可以查看库相关信息
image-20210110152638520
但是这个时候,我们的库还不能被外界给引用到

步骤6: 添加到JCenter

从Bintray上打开查看该库的信息,点击添加Add to JCenter按钮
image-20210110153737396
填写一些对library的描述，然后发送，等待审核,审核时间一般几分钟到几个小时,工作日会快点,审核通过后会邮件通知你，这个时候就可以愉快的通过依赖使用这个库了
image-20210110154334641

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

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

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

关于后续版本更新

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

在你的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

点击如下图指示
image-20210110161833850
创建一个Release或者Tag

注意
1. 首次进来是这样子的
  image-20210110162350536
2. 创建过版本之后,进来是这样子的
  image-20210110162314370
3. 创建版本
  image-20210110163349014

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

打开JitPack,并登陆(使用的是你的Github账号登陆即可)
将你的项目Github地址放入搜索栏,点击look up,这个时候就会进行编译,等待编译完成即可,下面的Version是我之前生成的一些版本
image-20210110165357849
编译完成后JitPack会自动给你生成相关的配置信息,按照如下配置,配置你的项目即可
image-20210110165537556
最后就可以愉快的进行使用了!!!

关于后续版本更新

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

总结

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

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

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

“一篇就够”系列: 发布开源库到JitPack,JCenter详

前言

方式一: 发布Android库到JCenter

步骤1: 注册Bintray账号

步骤2: 在Bintray上创建仓库

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

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

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

步骤6: 添加到JCenter

关于后续版本更新

方式二: 发布Android库到JitPack

步骤1：创建好项目并编写Android库

步骤2：配置上传插件并上传至Github

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

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

关于后续版本更新

总结

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

猜你喜欢

热点阅读

“一篇就够”系列: 发布开源库到JitPack,JCenter详

前言

方式一: 发布Android库到JCenter

步骤1: 注册Bintray账号

步骤2: 在Bintray上创建仓库

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

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

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

步骤6: 添加到JCenter

关于后续版本更新

方式二: 发布Android库到JitPack

步骤1：创建好项目并编写Android库

步骤2：配置上传插件并上传至Github

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

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

关于后续版本更新

总结

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

猜你喜欢

热点阅读

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