GitHub官方文档中指出:
Releases 是 GitHub 为你的用户打包和提供软件的方式。你可以把它看作是使用下载提供软件的一种替代方法。
通过 Releases,你可以提供二进制文件的链接,以及描述你更改情况的发布说明。
在其核心中,Releases 基于 Git 标签。标签标记了项目历史上的特定时刻,因此它们是指示版本发布的好方法。Releases 按照标签日期进行排序,方法如下:
有关查看现有标签的更多信息,请参见 使用标签。
我希望备份这个官方解释并从已经使用过该功能的人那里了解它的工作原理。
如 "关于发布"所述:
发布是GitHub提供给用户软件的打包方式。你可以将其视为提供软件的下载的替代品。
发布是一个容器,它包含一个或多个资产,与一个git标记相关联(因为自git push --follow-tags
只推送已注释的标记)
它自2013年7月起取代了旧的“GitHub下载”系统,该系统开始被滥用(人们在其中存储任何和所有东西),并于2012年12月删除。
通过强制进行间接操作(标记 => 发布 => 资产),GitHub 使该功能更易于管理。
dirkjot添加评论:在评论中指出:
容易忽略的两个重要点:
- 发布最初是“空的”,因为它与标记相关联,而不是从该标记生成的
- 资产是上传的,因此不一定与源代码相关。
注:空的发布将自动包含已打过标记的提交源代码的 tgz 和 zip 版本
GitHub发布的使用方法:
使用发布功能的项目的示例是Windows版Git发布。
就Windows版Git而言,考虑到您可能首先想安装git,而且可能没有正确的工具集来编译其源代码,这非常方便。
正如GitHub V3 Release API所说明的那样,发布不是标记。
当您创建发布时,需要标记名称,但这将创建一个空的发布(与该标记相关联)。
从发布中,您可以上传一个或多个资产。
预期以其原始二进制形式提供资产数据。
POST https://<upload_url>/repos/:owner/:repo/releases/:id/assets?name=foo.zip
注意:自GitLab 8.2(2015年11月)以来,GitLab也支持“发布”。
自2021年4月起,您现在拥有:
发布支持评论和反应与讨论链接
您现在可以将讨论链接到新的发布版本!
在起草新版本时,请勾选“为此版本创建讨论”框,选择一个类别并发布。
您的社区将能够对发行说明做出反应和评论,从而为项目提供更多庆祝活动和反馈机会。
GitHub Mobile上本地提供发布讨论。有关更多信息,请参见GitHub讨论,GitHub发布版和GitHub Mobile文档。
请注意,在2021年第3季度,您可以拥有本地changelog生成器。
自2022年6月起,您可以为先前发布版本设置/更改/修改发行说明:
生成发行说明时现在可以手动选择以前的发布版本
现在可以在GitHub发布UI中手动选择以前发布的版本来生成发布说明。
有关生成发布说明的更多信息,请参见自动生成的发布说明文档。 有关GitHub发布版的更多信息,请参见GitHub发布版文档。