Skip to main content
我们经常发布文档更新,此页面的翻译可能仍在进行中。 有关最新信息,请访问英语文档

管理仓库中的发行版

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

谁可以使用此功能

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

关于发行版管理

可以使用发行说明、@mentions 参与者和指向二进制文件的链接创建新版本,以及编辑或删除现有发行版。 还可以使用“发布 API”创建、修改和删除发行版。 有关详细信息,请参阅 REST API 文档中的“发行版”。

创建发行版

  1. 在 你的 GitHub Enterprise Server 实例 上,导航到存储库的主页。 1. 在文件列表右侧,单击“发布”。 右侧边栏中的“发布”部分

  2. 单击“草拟新发行版”。

    发行版草稿按钮

  3. 单击“选择标记”,键入发行版的版本号,然后按“输入” 。 或者,选择现有标记。

    输入标记

  4. 如果要创建新标记,请单击“创建新标记”。

    确认要创建新标记的屏幕截图

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

    用于选择分支的下拉列表的屏幕截图

  6. 键入发行版的标题和说明。 如果 @mention 描述中的任何用户,发布的发行版将包含“参与者”部分以及所有被提及用户的头像列表。 或者,可通过单击“自动生成发行说明”,以自动生成发行说明 。

    发行说明的屏幕截图

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

    有关通过发行版提供 DMG 的动画 GIF

  8. 若要通知用户发行版尚未准备投入生产,并且可能不稳定,请选择“这是预发行版”。

    用于将发行版标记为预发行版的复选框的屏幕截图

  9. 如果已准备好公开发行版,请单击“发布发行版”。 若要稍后处理发行版,请单击“保存草稿”。 “发布发行版”和“草拟发行版”按钮

若要详细了解 GitHub CLI,请参阅“关于 GitHub CLI”。

  1. 若要创建发行版,请使用 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

    如果 @mention 注释中任何 GitHub Enterprise Server 用户,则 GitHub.com 上发布的发行版将包含“参与者”部分以及所有被提及用户的头像列表。

编辑发行版

  1. 在 你的 GitHub Enterprise Server 实例 上,导航到存储库的主页。 1. 在文件列表右侧,单击“发布”。 右侧边栏中的“发布”部分
  2. 在页面右侧要编辑的发行版旁边,单击 编辑发行版
  3. 在窗体中编辑发行版的详细信息,然后单击“更新发行版”。 如果在描述中添加或删除 GitHub 用户的任何 @mentions,则该发行版的“参与者”部分的头像列表中将添加或删除这些用户。 更新发行版

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

删除发行版

  1. 在 你的 GitHub Enterprise Server 实例 上,导航到存储库的主页。 1. 在文件列表右侧,单击“发布”。 右侧边栏中的“发布”部分
  2. 在页面右侧要删除的发行版旁边,单击 删除发行版
  3. 单击“删除此发行版”。 确认删除发行版
  1. 若要删除发行版,请使用 gh release delete 子命令。 将 tag 替换为要删除的发行版标记。 使用 -y 标志跳过确认。

    gh release delete TAG -y