Skip to main content

管理仓库中的发行版

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

谁可以使用此功能?

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

Tool navigation

关于发行版管理

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

还可以从 GitHub Marketplace 中的特定发行版发布操作。 有关详细信息,请参阅“在 GitHub Marketplace 中发布操作”。

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

创建发行版

Note

若要详细了解 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 公共预览版 release" --prerelease
    

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

编辑发行版

  1. 要编辑一个版本,请使用 gh release edit 子命令。 将 TAG 替换为表示要编辑的版本的标记。 例如,要编辑一个版本的标题,请使用如下代码,并将 NEW-TITLE 替换为更新后的标题:

    gh release edit TAG -t "NEW-TITLE"
    

    有关可能的参数的详细信息,请参阅 GitHub CLI 手册

删除发行版

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

    gh release delete TAG -y