Skip to content

release

发布工作区的 npm 包并生成 changelogs。

使用

shell
rt release
rt release --skip-npm-publish
rt release --npm-tag beta
rt release --skip-changelog --skip-git-tag
rt release --check-remote-version --remote upstream

命令行参数

所有选项均可通过命令行参数传递,命令行参数的优先级高于配置文件。

参数描述
-t, --npm-tag <tag>npm 发布的 dist-tag,如 betanext
-r, --remote <remote>git push 使用的 remote 名称
--skip-npm-publish跳过 npm 发布
--skip-changelog跳过 changelog 生成
--skip-git-tag跳过 git tag
-c, --check-remote-version发布前检查 npm 远程版本,若版本已存在则跳过发布

配置

ts
import { defineConfig } from 'rattail/vite-plus'

export default defineConfig({
  rattail: {
    release: {
      // skipNpmPublish: true,
      // skipChangelog: true,
    },
  },
})

编程式使用

ts
import { release } from 'rattail/cli'

await release({
  // skipNpmPublish: true,
  // skipChangelog: true,
})

选项

选项类型默认值描述
npmTagstring-npm 发布的 dist-tag,如 betanext,不设置则默认为 latest
skipNpmPublishboolean-跳过 npm 发布
skipChangelogboolean-跳过 changelog 生成
skipGitTagboolean-跳过 git tag
checkRemoteVersionboolean-发布前检查 npm 远程版本,若版本已存在则跳过发布
task(newVersion, oldVersion) => Promise<void>-在版本号更新之后、npm 发布之前运行的自定义任务,如执行构建
remotestringorigingit push 使用的 remote 名称,多数情况下无需修改