最近把github上的代码都转移到了码云上,而且github上的仓库可以很方便的迁移到码云,所以老代码的迁移问题不用考虑。

之前使用 JCenter 发布了一个 GitHub 开源项目,JCenter整个流程很繁琐,相对于JCenter,JitPack发布非常的简单,所以最近几个项目都是发布到了 JitPack上。

由于技术原因,码云项目之前是不支持发布到JitPack的,具体是啥时候支持的笔者也知道,就是前几天打开JitPack,首页上就有提示:"We now support Gitee.com 码云"提示,笔者试着根据以前在Github上发布的流程,试了一遍,非常方便就发布了自己的项目。

为什么要发布项目

以前在Eclipse时代要复用代码,需要把项目生成jar包放到开发项目的libs目录下或者把项目文件直接拷贝到Eclipse项目中然后引用项目,这样做不仅会导致jar包和项目难以管理,而且一旦涉及到依赖包升级的情况,就需要重新拷贝一次项目,使开发更加费时而且容易出错,所以就有JitPack和JCenter这类的网站出来,项目发布到他们平台后,我们只需要这样就能引用到项目:

引用的项目升级,我们只需要修改后面的版本号即可。是不是非常的方便?

什么是JitPack

Easy to use package repository for Git

Publish your JVM and Android libraries

JitPack 是一个类似于 JCenter 和 MavenCentral 的仓库,流程简单,可以非常快捷的发布Github和Gitee开源项目,方便使用 Gradle 进行依赖管理。

下面介绍下怎么发布Gitee上的项目:

1. 必要的准备

1.在码云上生成私人令牌

为什么要生成私人令牌呢?因为JitPack需要获取码云的授权才能获取码云上的项目。

进入码云主页,点击右上角登录信息在菜单下选择设置选项:

在左侧的菜单中选择私人令牌选项:

点击右上角生成新令牌按钮:

设置私人令牌并创建,这里的私人令牌是一个字符串,请好好保管,关闭界面后令牌不会再显示,请妥善保管,请妥善保管,请妥善保管,重要的事前说三遍:

生成完成后的私人令牌:

2. 在JitPack上设置私人令牌

先用你的Github账号登录JitPack:

登录后选择Settings菜单选项:

设置私人令牌:

私人令牌设置成功后便可使用码云的开源项目了!

2. Gitee上创建项目

在 Gitee上创建项目:

创建完成后会打开项目,因为当前项目是空白的,所以会显示以下的页面:

Gitee空白项目

3. Android项目配置

在Android项目上创建一个module。

选择Android Library

填写Android Library相关信息

完成后项目里面就会多了一个module,我这里用之前创建好的一个module举例

module中需要设置这几个地方:

1.需要设置工程的build.gradle文件,注意这里不是module的gradle文件也不是app的gradle文件,添加以下代码:

dependencies {

//1.自动化maven打包插件

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

}

2.在module的build.gradle文件中添加以下代码:

这里的group填写你的Gitee创库根目录

apply plugin: 'com.android.library'

apply plugin: 'com.github.dcendents.android-maven'

group='com.gitee.xuqingcode'

3.设置gradle插件版本和gradle版本对应关系

在官网上找了gradle插件和gradle版本对应的关系,有内容随时更新:

插件版本

所需的 Gradle 版本

1.0.0 - 1.1.3

2.2.1 - 2.3

1.2.0 - 1.3.1

2.2.1 - 2.9

1.5.0

2.2.1 - 2.13

2.0.0 - 2.1.2

2.10 - 2.13

2.1.3 - 2.2.3

2.14.1+

2.3.0+

3.3+

3.0.0+

4.1+

3.1.0+

4.4+

3.2.0 - 3.2.1

4.6+

3.3.0 - 3.3.2

4.10.1+

3.4.0+

5.1.1+

如果不对应,上传到JitPack有可能编译时会出现如下错误:

4. 上传项目代码到Gitee

把本地的Android Library 项目使用 Git 上传到 Gitee,具体的 Git 操作可以按照项目页面中的提示进行,不再赘述。

Git 命令可以参考笔者之前写的一篇文章:Git命令大全

5. 创建项目的 发行(Release)版本

需要创建项目的发行版本才能上传到 JitPack。

创建的方式有两种:

1. 使用 Git 添加标签 tag,并且提交到 Gitee

git tag -a -m

git push --tags

操作完后即可在 Gitee 的项目中看到新创建的发行版本:

查看发行版本

发行的版本信息

2. 在Gitee项目中创建发行版本

在 Gitee 的项目中点击 "发行版" 标签栏:

点击发行版标签栏

在页面的右上角点击 "创建发行版" 按钮,进入到创建 发行版本的页面:

点击创建发行版本

填写必要的信息,即可创建一个新的 发行版本:

6. 发布项目到JitPack

进入 JitPack,使用 GitHub 账号登录

把项目的地址填写到首页的输入框中,点击 "Look Up" 按钮即可自动进行发布:

当项目代码上传到Gitee创建发行版后,点击JitPack的“Look Up”按钮会需要等待一段时间后才会有版本的显示,因为JitPack需要从Gitee上获取发行版代码zip文件,然后解压编译,所以请耐心等待数十秒。

Look up

发布成功后显示如下图:

发布成功

点击 Log 下的图标可以查看 build 的日志。

点击 "Get it" 可以查看 Gradle 的依赖配置说明,如下图:

Gradle依赖说明

完成上述步骤后即完成了开源 Library 的发布,对比 JCenter 的发布流程简化了不少,使用起来非常的方便。

著作权归作者所有。商业转载请联系作者获得授权,非商业转载请注明出处。

Logo

开放原子开发者工作坊旨在鼓励更多人参与开源活动,与志同道合的开发者们相互交流开发经验、分享开发心得、获取前沿技术趋势。工作坊有多种形式的开发者活动,如meetup、训练营等,主打技术交流,干货满满,真诚地邀请各位开发者共同参与!

更多推荐