Skip to main content

管理仓库中的发行版

您可以创建要捆绑的发行版,并将项目的迭代交付给用户。

Repository collaborators and people with write access to a repository can create, edit, and delete a release.

关于发行版管理

您可以使用发行说明、@提及贡献者和指向二进制文件的链接来创建新版本,也可以编辑或删除现有版本。

您也可以在 GitHub Marketplace 中从特定的发行版发布操作。 更多信息请参阅“在 GitHub Marketplace 中发布操作”。

您可以选择是否将 Git Large File Storage (Git LFS) 对象包含在 GitHub Enterprise Cloud 为每个发行版创建的 ZIP 文件和 tarball 中。 更多信息请参阅“管理仓库存档中的 Git LFS 对象”。

创建发行版

  1. 在 GitHub.com 上,导航到仓库的主页面。

  2. 在文件列表右侧,单击 Releases(发行版)右侧边栏中的 Releases(发行版)部分

  3. 单击 Draft a new release(草拟新发行版)

    Releases draft button

  4. 单击 Choose a tag(选择标记),键入 版本号,然后按 Enter。 或者,选择现有标记。

    输入标记

  5. 如果要创建新标记,请单击 Create new tag(创建新标记)

    确认您要创建新标记

  6. 如果已创建新标记,请使用下拉菜单选择包含要发布的项目的分支。

    选择分支

  7. 键入发行版的标题和说明。 如果您在描述中@提及任何 GitHub Enterprise Cloud 用户,则已发布的版本将包含贡献者部分,其中包含所有提及用户的头像列表。 或者,您可以通过单击 Auto-generate release notes(自动生成发行说明)来自动生成发行说明。

    发行版说明

  8. (可选)要在发行版中包含二进制文件(例如已编译的程序),请在二进制文件框中拖放或手动选择文件。 通过发行版提供 DMG

  9. 要通知用户发行版本尚不可用于生产,可能不稳定,请选择 This is a pre-release(这是预发布)将版本标记为预发行版的复选框

  10. (可选)如果在存储库中启用了 GitHub Discussions,选择 Create a discussion for this release(为此版本创建讨论),然后选择 Category(类别)下拉菜单,然后点击类别进行版本讨论。 用于创建发行版讨论和下拉菜单以选择类别的复选框

  11. 如果您准备推广您的发行版,请单击 Publish release(发布版本)。 要在以后处理该发行版,请单击 Save draft(保存草稿)发布版本和草拟发行版按钮 然后,您可以在存储库的版本源中查看已发行版或草稿版本。 更多信息请参阅“查看仓库的版本和标签”。

    @提及贡献者的已发布版本

要了解有关 GitHub CLI 的更多信息,请参阅“关于 GitHub CLI”。

  1. 要创建发行版,请使用e gh release create 子命令。 将 tag 替换为所需的版本标签。

    gh release create tag
  2. 按照交互式提示进行操作。 或者,您可以指定参数以跳过这些提示。 有关可能的参数的详细信息,请参阅 GitHub CLI 手册。 例如,此命令将创建具有指定标题和注释的预发行版。

    gh release create v1.3.2 --title "v1.3.2 (beta)" --notes "this is a beta release" --prerelease

如果您在注释中@提及任何 GitHub Enterprise Cloud 用户,则在 GitHub.com 上发布的版本将包括贡献者 部分,其中包含所有提及用户的头像列表。

编辑发行版

  1. 在 GitHub.com 上,导航到仓库的主页面。

  2. 在文件列表右侧,单击 Releases(发行版)右侧边栏中的 Releases(发行版)部分

  3. 在页面右侧要编辑的发行版旁边,单击 编辑发行版

  4. 在表单中编辑版本的详细信息,然后单击 Update release(更新版本)。 如果您在描述中添加或删除 GitHub 用户的任何@提及,则会在版本的贡献者部分的头像列表中添加或删除这些用户。 更新发行版

当前无法使用 GitHub CLI 编辑版本。

删除发行版

  1. 在 GitHub.com 上,导航到仓库的主页面。

  2. 在文件列表右侧,单击 Releases(发行版)右侧边栏中的 Releases(发行版)部分

  3. 在页面右侧要删除的发行版旁边,单击 删除发行版

  4. 单击 Delete this release(删除此发行版)确认删除发行版

  1. 要删除版本,请使用 gh release delete 子命令。 将 tag 替换为要删除的版本标记。 使用 -y 标志跳过确认。

    gh release delete tag -y