Piece 版本管理

发布 Piece 时如何选择版本号

Piece 是 npm 包,遵循语义化版本控制

此页面供 *Piece 作者*决定发布什么版本号。关于工作流如何采用新的 Piece 版本,请参见 [Piece 同步与版本管理](/docs/activepieces/install/architecture/piece-syncing)。

语义化版本控制

版本号为 MAJOR.MINOR.PATCH

  • MAJOR——当进行破坏性变更时递增。
  • MINOR——当添加功能且不破坏现有工作流时递增。
  • PATCH——用于不改变行为的错误修复。

变更分类

使用此检查清单来决定递增哪个部分。

破坏性变更(MAJOR)

  • 删除现有的动作或触发器。
  • 向现有动作或触发器添加必填属性。
  • 删除现有属性(无论是必填还是可选)。
  • 从动作输出中移除属性。
  • 改变现有动作或触发器的行为。

非破坏性变更(MINOR 或 PATCH)

  • 添加新的动作或触发器。
  • 添加可选属性。
  • 向动作输出添加属性。
  • 修复 bug 而不更改公共接口(PATCH)。

经验法则:任何删除都是破坏性的,任何必填的添加也是破坏性的,其他都不是。