Release(发行版)
是具有 Changelogs
(变更日志)和二进制文件的一级对象,可以代表超出 Git 架构本身的一个特定时间点之前的所有项目历史。
通过 release
,不仅可以通过源代码查看项目历史,还能通过已经编译好的二进制文件来进一步描述此时的项目状态。
"超出 Git 架构本身" 的意义与作用在于:
- git 本身只能记录项目修改,本质上不适合将编译好的项目二进制文件记录下来。
- 通过
release
,开发者可以把发布版本时项目所编译好的二进制文件保存了下来,方便用户下载,也方便查找特定版本的二进制文件。
结合上文 超出 Git 架构本身
所描述的特点,可以理解总结如下:
- 发行版本身不是由 Git 提供的原生能力,而是基于 Git 提供托管能力的平台(如 Gitee )提供的基于 Git 的版本管理能力。
- 用户在访问项目时,可以通过
release
快速下载对应版本二进制文件,而不需要自己下载源代码到本地编译,大大降低用户使用软件的学习成本。- 在发行版中,一般会包含
对应发行版版本的源代码
、对应发行版版本的源代码压缩包
(由平台提供 Archive 下载地址而不需要使用 Git 命令克隆检出) 和开发者创建发行版时上传的二进制文件
(即附件)。开发者创建发行版时上传的二进制文件
(即附件)由开发者在发布release
时决定是否上传。一般情况下,开发者可以通过发行版附件功能提供制作好的安装包/可执行程序
、补丁
以及对应版本的使用文档或开发文档
等等。
你可以在 Gitee 上创建发行版用于打包软件、发行说明和附件,以供他人下载。
通过创建发行版,你可以将项目的迭代交付给用户。
仓库协作者以及对仓库具有写入权限的人员都可以创建、编辑和删除发行版。
发行版的管理与使用
1、在 Gitee 上,导航到仓库主页面。
2、在文件列表的右侧,单击 创建
(适用于首次创建) 或 发行版标题
或 全部
。
3、单击右上角 +创建发行版
按钮。
4、输入发行版的版本号,此处建议使用语义版本号来命名标签。
5、展开右边的下拉列表,选择 包含要发布的项目的分支
。
6、输入该发行版的标题和描述说明,同时你可以在描述中插入链接和图片。
7、如果你的发行版需要添加附件,请在文件框中 拖放
或 手动选择
文件。
单个附件不能超过 100M(GVP 项目200M)
每个仓库总附件不可超过 1G(推荐项目不可超过 5G;GVP 项目不可超过 20G)
附件总容量统计包括仓库附件和发行版附件。
8、如果需要告诉用户发行版本尚不稳定,请勾选 这是一个预览版本
。
9、检查信息无误后,单击 创建发行版
即可发布该发行版。如果你发布后需要修改发行版,请参考“编辑发行版”
1、在 Gitee 上,导航到仓库主页面。
2、在文件列表的右侧,单击 发行版标题
或 全部
。
3、在需要编辑的发行版的右侧,单击 编辑icon
。
4、编辑你需要修改的内容后,点击 更新
即可。
1、在 Gitee 上,导航到仓库主页面。
2、在文件列表的右侧,单击 发行版标题
或 全部
。
3、在需要删除的发行版的右侧,单击 删除icon
。
4、单击删除发行版弹窗的 确认
按钮即可删除发行版。