释放-it-calver-插件

发布它的日历版本插件!

此插件可以启用日历版本( caval) 并发布它 ! 这对在连续交付环境中的应用项目特别有用.

npm install --save-dev @csmith/release-it-calver-plugin

单位 释出 配置 :

"plugins": {
  "@csmith/release-it-calver-plugin": {
    "cycle": "month"
  }
}

配置

循环选项

year

版本中仅包含年份和小数字.

2026.0
2026.1
2027.0

month (默认)

版本包含年份,月份,以及一个小数字.

2026.3.0
2026.3.1
2026.4.0

week

版本包含年份,周数,还包含一个小数字.

2026.13.0
2026.13.1
2026.14.0

day

版本包含年,月,日,并有少量数字.

注:分4个部分的版本(例如:. 2026.3.24.0)不是有效的铸模,将被拒绝 npm version。如果发布到 npm,则使用不同的周期或设定 "npm": { "skipChecks": true } 在你的释放 - 它的配置.

2026.3.24.0
2026.3.24.1
2026.3.25.0

前缀

用于多模块需要不同版本标记的单重机 .

"@csmith/release-it-calver-plugin": {
    "cycle": "month",
    "prefix": "ui-"
}

制作版本像 ui-2026.3.0, (中文(简体) ), ui-2026.3.1等 (中文(简体) ).

分隔符

默认情况下,所有日期段由 . npm 的相容性。 设定为 "-" 以使用破折号分隔输出(卡-内在格式)。 只有在不需要 npm 兼容性时才使用 .

"@csmith/release-it-calver-plugin": {
    "cycle": "month",
    "separator": "-"
}

制作版本像 2026-3.0, (中文(简体) ), 2026-3.1等 (中文(简体) ).

Dash-separated 版本无效 semver, 因此您还需要配置放行 - it来跳过 npm 版本检查 :

"npm": {
    "skipChecks": true
}

从预卡尔24x版本升级

此插件现在使用 口径24.x这是卡尔弗图书馆的完整重写。 插件自动处理过渡,但有些事情需要注意.

自动发生的事情

• 老套装还行. 这个 format, (中文(简体) ), increment,以及 fallbackIncrement 选项已贬值,但仍被支持。 插件将它们映射到新处 cycle 设置并记录折旧警告。 你可以按照自己的速度升级自己的配置.
• 旧的标签被迁移. 以旧格式(如:. 24.11.0 或者说 2024.11.0)在计算下个版本时被自动转换. 不需要人工回挂.
• 初发版本通. 如果您的寄存器没有先前的卡尔弗标记( 或者只有 0.0.0 标记,插件现在正确生成初始版本而不是返回 0.0.0。 。 。 .

什么变化

• 4位数年. 现在的版本总是使用4位数年. 如果您的前一个标记使用了2位数年( 例如) . 24.11.0),下个版本将使用4位数年(例如. 2026.3.0) (中文(简体) ).
• 简化相接. 这个 format 财务报告和审定财务报表 increment 选项替换为单个 cycle 选项。 地图见下表.

配置绘图

实例升级

在此之前:

"@csmith/release-it-calver-plugin": {
    "format": "yyyy.mm.minor",
    "increment": "calendar",
    "fallbackIncrement": "minor"
}

之后:

"@csmith/release-it-calver-plugin": {
    "cycle": "month"
}

有关日历版本的更多信息,请访问这里: 卡尔