关于发行版管理
您可以使用发行说明、@提及贡献者和指向二进制文件的链接来创建新版本,也可以编辑或删除现有版本。
您也可以在 GitHub Marketplace 中从特定的发行版发布操作。 更多信息请参阅“在 GitHub Marketplace 中发布操作”。
您可以选择是否将 Git Large File Storage (Git LFS) 对象包含在 GitHub 为每个发行版创建的 ZIP 文件和 tarball 中。 更多信息请参阅“管理仓库存档中的 Git LFS 对象”。
创建发行版
-
在 GitHub.com 上,导航到仓库的主页面。
-
在文件列表右侧,单击 Releases(发行版)。
-
单击 Draft a new release(草拟新发行版)。
-
单击 Choose a tag(选择标记),键入 版本号,然后按 Enter。 或者,选择现有标记。
-
如果要创建新标记,请单击 Create new tag(创建新标记)。
-
如果已创建新标记,请使用下拉菜单选择包含要发布的项目的分支。
-
Optionally, to the top right of the description text box, select the Previous tag drop-down menu and click the tag that identifies the previous release.
-
键入发行版的标题和说明。 如果您在描述中@提及任何 GitHub 用户,则已发布的版本将包含贡献者部分,其中包含所有提及用户的头像列表。 或者,您也可以通过单击Generate release notes(生成发行说明) 来自动生成发行说明。
-
(可选)要在发行版中包含二进制文件(例如已编译的程序),请在二进制文件框中拖放或手动选择文件。
-
要通知用户发行版本尚不可用于生产,可能不稳定,请选择 This is a pre-release(这是预发布)。
-
(可选)如果在存储库中启用了 GitHub Discussions,选择 Create a discussion for this release(为此版本创建讨论),然后选择 Category(类别)下拉菜单,然后点击类别进行版本讨论。
-
如果您准备推广您的发行版,请单击 Publish release(发布版本)。 要在以后处理该发行版,请单击 Save draft(保存草稿)。
然后,您可以在存储库的版本源中查看已发行版或草稿版本。 更多信息请参阅“查看仓库的版本和标签”。
要了解有关 GitHub CLI 的更多信息,请参阅“关于 GitHub CLI”。
-
要创建发行版,请使用e
gh release create
子命令。 将tag
替换为所需的版本标签。gh release create tag
-
按照交互式提示进行操作。 或者,您可以指定参数以跳过这些提示。 有关可能的参数的详细信息,请参阅 GitHub CLI 手册。 例如,此命令将创建具有指定标题和注释的预发行版。
gh release create v1.3.2 --title "v1.3.2 (beta)" --notes "this is a beta release" --prerelease
如果您在注释中@提及任何 GitHub 用户,则在 GitHub.com 上发布的版本将包括贡献者 部分,其中包含所有提及用户的头像列表。
编辑发行版
-
在 GitHub.com 上,导航到仓库的主页面。
-
在文件列表右侧,单击 Releases(发行版)。
-
在页面右侧要编辑的发行版旁边,单击 。
-
在表单中编辑版本的详细信息,然后单击 Update release(更新版本)。 如果您在描述中添加或删除 GitHub 用户的任何@提及,则会在版本的贡献者部分的头像列表中添加或删除这些用户。
当前无法使用 GitHub CLI 编辑版本。
删除发行版
-
在 GitHub.com 上,导航到仓库的主页面。
-
在文件列表右侧,单击 Releases(发行版)。
-
在页面右侧要删除的发行版旁边,单击 。
-
单击 Delete this release(删除此发行版)。
-
要删除版本,请使用
gh release delete
子命令。 将tag
替换为要删除的版本标记。 使用-y
标志跳过确认。gh release delete tag -y