关于版本管理
您可以创建包含版本说明、贡献者@提及和二进制文件链接的新版本,以及编辑或删除现有版本。您还可以使用版本 API 创建、修改和删除版本。有关更多信息,请参阅 REST API 文档中的“版本 REST API 端点”。
您还可以从 GitHub Marketplace 中的特定版本发布操作。有关更多信息,请参阅“在 GitHub Marketplace 中发布操作”。
您可以选择是否将 Git Large File Storage (Git LFS) 对象包含在 GitHub 为每个版本创建的 ZIP 文件和 tarball 中。有关更多信息,请参阅“管理仓库存档中的 Git LFS 对象”。
创建版本
-
在 GitHub.com 上,导航到仓库的主页。
-
在文件列表的右侧,点击 **发布**。
-
在页面顶部,点击 **创建新发布**。
-
要选择发布的标签,请选择 **选择标签** 下拉菜单。
- 要使用现有标签,点击标签。
- 要创建新标签,输入发布的版本号,然后点击 **创建新标签**。
-
如果您创建了新标签,请选择 **目标** 下拉菜单,然后点击包含要发布项目的分支。
-
可选地,在描述字段上方,选择 **上一个标签** 下拉菜单,然后点击标识上一个发布的标签。
-
在“发布标题”字段中,输入发布的标题。
-
在“描述此发布”字段中,输入发布的描述。如果您在描述中@提及任何人,已发布的发布将包含一个 **贡献者** 部分,其中包含所有提及用户的头像列表。或者,您可以通过点击 **生成发布说明** 自动生成发布说明。
-
可选地,要将二进制文件(如编译后的程序)包含在您的发布中,请将文件拖放到二进制文件框中或手动选择文件。
-
可选地,要通知用户发布尚未准备好投入生产并且可能不稳定,请选择 **这是一个预发布**。
-
可选地,选择 **设置为最新发布**。如果您不选择此选项,最新发布标签将根据语义版本控制自动分配。
-
可选地,如果为存储库启用了 GitHub Discussions,请为发布创建讨论。
- 选择 **为此发布创建讨论**。
- 选择 **类别** 下拉菜单,然后点击发布讨论的类别。
-
如果您准备公开发布,请点击 **发布发布**。要稍后处理发布,请点击 **保存草稿**。然后,您可以在存储库的发布提要中查看已发布或草稿发布。有关更多信息,请参阅“查看您的存储库的发布和标签”。
要了解有关 GitHub CLI 的更多信息,请参阅“关于 GitHub CLI”。
-
要创建发布,请使用 `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 上,导航到仓库的主页。
-
在文件列表的右侧,点击 **发布**。
-
在您要编辑的发布旁边,点击 .
-
在表单中编辑发布的详细信息,然后点击 **更新发布**。如果您在描述中添加或删除任何对 GitHub 用户的 @提及,这些用户将被添加到发布的 **贡献者** 部分的头像列表中,或从该列表中删除。
-
要编辑发布,请使用 `gh release edit` 子命令。将 `TAG` 替换为代表您要编辑的发布的标签。例如,要编辑发布的标题,请使用以下代码,将 `NEW-TITLE` 替换为更新后的标题
gh release edit TAG -t "NEW-TITLE"
有关可能参数的更多信息,请参阅 GitHub CLI 手册。
删除发布
-
在 GitHub.com 上,导航到仓库的主页。
-
在文件列表的右侧,点击 **发布**。
-
在页面右侧,在您要删除的发布旁边,点击 .
-
点击 **删除此发布**。
-
要删除发布,请使用 `gh release delete` 子命令。将 `tag` 替换为要删除的发布的标签。使用 `-y` 标志跳过确认。
gh release delete TAG -y