码云上传代码添加标签_[Android] 发布码云(Gitee)项目到JitPack(最全完整流程)
最近把github上的代码都转移到了码云上,而且github上的仓库可以很方便的迁移到码云,所以老代码的迁移问题不用考虑。之前使用 JCenter 发布了一个 GitHub 开源项目,JCenter整个流程很繁琐,相对于JCenter,JitPack发布非常的简单,所以最近几个项目都是发布到了 JitPack上。由于技术原因,码云项目之前是不支持发布到JitPack的,具体是啥时候支持的笔者也知道
最近把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 的发布流程简化了不少,使用起来非常的方便。
著作权归作者所有。商业转载请联系作者获得授权,非商业转载请注明出处。
开放原子开发者工作坊旨在鼓励更多人参与开源活动,与志同道合的开发者们相互交流开发经验、分享开发心得、获取前沿技术趋势。工作坊有多种形式的开发者活动,如meetup、训练营等,主打技术交流,干货满满,真诚地邀请各位开发者共同参与!
更多推荐
所有评论(0)