Releasing

Rspack 的版本发布通过 GitHub Actions 自动完成。

你可以在 @rspack/core@rspack/cli 的 npm 版本页面查看所有已发布的版本。

Latest 发布

Latest 是最新的稳定版本,遵循 Semantic Versioning 语义化版本号规范(x.y.z)。

全量发布工作流 会在每周二由 Rspack 维护者手动触发,并带有完整的 release notes。

在发布过程中,会构建以下目标平台的二进制产物:

  • x86_64-unknown-linux-gnu
  • aarch64-unknown-linux-gnu
  • x86_64-unknown-linux-musl
  • aarch64-unknown-linux-musl
  • i686-pc-windows-msvc
  • x86_64-pc-windows-msvc
  • aarch64-pc-windows-msvc
  • x86_64-apple-darwin
  • aarch64-apple-darwin

发布步骤

  1. 创建一个新分支,例如 release/v1.0.0
  2. 在分支上使用 pnpm x version 命令更新版本号。
# 发布 patch 版本
pnpm x version patch

# 发布 minor 版本
pnpm x version minor

# 发布 major 版本
pnpm x version major

# 发布 alpha 版本
pnpm x version patch --pre alpha

# 发布 beta 版本
pnpm x version patch --pre beta

# 发布 rc 版本
pnpm x version patch --pre rc
  1. 提交代码并推送到远程分支。
git add .
git commit -m "chore: release v1.0.0"
git push origin release/vx.y.z
  1. 创建一个 PR,标题为 chore: release v1.0.0
  2. 执行 Ecosystem CI 工作流,确保所有生态项目都能正常工作。
  3. 在 release 分支上执行全量发布工作流。
  4. 发布完成后,合并 PR 到 main 分支。
  5. 生成 GitHub release note,补充 highlights 信息。

Canary 发布

Canary 是 Rspack 的预发布版本,用于测试和验证新功能。

发布 canary 版本不需要手动创建分支或更新版本号,只需要由 Rspack 维护者执行 Canary 发布工作流 即可。