# 如何使用版本发布

# 什么是版本发布

版本发布 (Release) 是工蜂提供的一项基于git tag的功能,我们可以通过版本发布来提供软件包,二进制文件,以及一些发布说明供其他用户使用。

# 创建版本发布

有两种方法创建版本发布,一种是通过创建版本库 tag 来创建版本发布,一种是直接创建版本发布。 版本库 tag 和版本发布区别在于:

  1. 勾选了“将 tag 作为发布包”的版本库 tag 才是版本发布
  2. 未来会对版本库 tag 和版本发布的展示作区分

下面将分别介绍两种方法

# 创建版本库 tag

在项目首页点击"tag",进入“版本库 tag”首页。

点击“创建 tag”(New Tag),进入 tag 创建页面,输入标题 (Name for new tag)、创建来源 (Create from)、Tag Message、描述 (Description),可以上传附件 (Attachments),也可以把项目内的标签 (Label) 关联与本次发布关联起来,勾选“将 tag 作为发布包”(as a release)(重要)release_tag_create

点击“保存变更”(save),这样一个版本库 tag 就创建好了。 release_tag_view

# 创建版本发布

在项目首页的侧边栏点击“提交”(Commits),找到“版本发布”(Releases)tab,进入版本发布首页。 release_list

点击“创建发布”(New Release),进入发布创建页面,输入标题、创建来源、Tag Message、描述,上传附件,关联标签。 注意:单个附件的大小不得超过 100MB,最多可上传 5 个附件 release_create

点击"保存变更",完成创建。 release_view

# 查看版本发布

可以在版本发布首页看到本项目版本发布列表。 release_show

可以通过关键词,也可以按照“作者”(Author),“标签”(Label) 来筛选想要的版本发布。 release_filter

点击版本发布的标题可以看到该版本发布的详情,通过详情页面能够下载版本发布中的附件,以及源代码 (archieve)。

# 修改版本发布

在版本发布首页或者版本发布详情页面点击编辑按钮可以进入对应的版本发布的修改页面。 在这里可以对发布描述、附件、关联的标签进行修改。 release_edit

注意: 如果取消勾选“将 tag 作为发布包”,则该版本发布将变为版本 tag,不会出现在版本发布列表中。 点击保存变更,完成对该版本发布的修改。

# 删除版本发布

在版本发布首页或者版本发布详情页面点击删除按钮可以删除对应的版本发布。 release_del

点击“确认”(ok),删除

# 版本发布 api

工蜂提供了对应的 api 来管理版本发布,相关链接:

lastUpdate: 6/28/2022, 11:10:40 PM