npm 包 github-release-from-changelog 使用教程

阅读时长 4 分钟读完

简介

github-release-from-changelog 是一个基于 Node.js 的命令行工具,它可以通过解析 CHANGELOG.md 文件自动生成 Github Release,并且支持同时发布到多个仓库。

该工具对于开发者而言非常实用,因为它能够帮助你自动化发布 Release,减少手动操作的时间和错误率。

安装

使用 npm 安装 github-release-from-changelog

用法

配置

首先,需要在你的项目根目录下创建 release.config.js 文件,内容如下:

其中:

  • token:Github Personal Token,需要有 repowrite:packages 权限。
  • changelogPathCHANGELOG.md 文件的相对路径。
  • owner:Github 仓库所属用户或组织。
  • repo:Github 仓库名称。
  • tagPrefix:Release 标签前缀,例如 v

发布 Release

在终端中输入以下命令来发布 Release:

运行命令后,会自动将解析 CHANGELOG.md 文件生成 Release,并且将其发布到 Github 仓库中。

如果你需要同时发布到多个仓库,可以在 release.config.js 文件中添加以下配置:

-- -------------------- ---- -------
-------------- - -
  -- -------
  ------ - -- ------
    -
      ------ ---------
      ----- -------
    --
    -
      ------ ---------
      ----- -------
    -
  -
-

然后,在终端中输入以下命令来发布到所有仓库:

预览 Release

如果你想要预览 Release 的内容,可以使用以下命令:

这会在本地启动一个服务器,并自动打开浏览器。你可以在浏览器中查看 Release 的内容,并且可以修改 Release 标题和描述。当你保存修改后,工具会自动将新的标签提交到 Github。

示例代码

假设你的项目名为 my-project,Github 用户名为 my-github-username,仓库名为 my-repo,Release 版本号为 v1.0.0。以下是示例代码:

-- -------------------- ---- -------
- ---------

--- ------- ------- -- ---- ------- ---- -- ---------- -- ---- -----

-- -------- - ----------

--- -----

- ------- -
- ------- -

--- -------

- ------ -

--- -----

- --- -

总结

github-release-from-changelog 是一个实用的工具,可以帮助开发者自动化发布 Github Release。使用该工具能够提高效率,减少错误率,而且还能支持同时发布到多个仓库。

来源:JavaScript中文网 ,转载请注明来源 https://www.javascriptcn.com/post/39756

纠错
反馈