Skip to content

发布文档

野声 edited this page Sep 2, 2024 · 3 revisions

发版分两种场景:

  1. 首次大版本发布
  2. Patch 版本发布

1. 首次大版本发布

什么是首次大版本发布,可以理解成需要新建分支的版本发布,如发布 v3.3/v4 等。

1. 发布

点开 OpenSumi Actions 页面 Actions, 基于 main 选择发布版本号,及新建分支

image

2. 创建 Release

https://github.com/opensumi/core/tags

发版本完成后点击发布的 Tag 创建 Release,点击 Generate release notes 生成 release 信息

image

3. 创建 PR

命名方式:chore(release): release v{具体版本号},如 chore(release): release v2.20.0

PR 内容需更新项目的 CHANGELOG.md 文件,更新内容如下:

  1. 新版本内容
  2. Breaking Changes 内容

4. 代码回源

合并代码的方式需要通过创建 Merge 节点的方式合并(Squash 等方式会对后续 Patch 版本发布带来问题,同时这种合并方式也为错误合并的代码回滚提供了便利性),由于 OpenSumi 仓库默认关闭了该种合并方式,可以在本地操作,以 v2.20 分支为例子:

git checkout main
git pull origin main
git fetch origin v2.20
git merge origin/v2.20
git push origin main

2. Patch 版本发布

1. 发布

点开 OpenSumi Actions 页面 Actions, 基于 Patch 分支选择发布版本号,不需要填写新分支

上面的 Use workflow from 选 patch 分支。

image

其他流程参照上述 2,3,4 流程。

发布后 check list

opensumi 中的一些在线资源是靠各 cdn 的,如 npmmirror, 支付宝 cdn,发布后请确保该版本已经被这些 cdn 同步到。

重点检查以下包:

  • @opensumi/ide-monaco
  • @opensumi/ide-components