软件版本号解读(语义化SemVer、日历化CalVer及标识符)

简介: 软件版本号解读(语义化SemVer、日历化CalVer及标识符)

1. 版本控制规范

1.1. 语义化版本(SemVer)

版本格式:主版本号.次版本号.修订号,版本号递增规则:

  1. 主版本号(MAJOR version):添加了不兼容的 API 修改,
  2. 次版本号(MINOR version):添加了向下兼容的功能性新增,
  3. 修订号(PATCH version):添加向下兼容的问题修正。

1.1.1. 补充说明

  1. 版本号均从 0 开始,一般使用 0.1.0 作为初始化开发版本。
  2. 主版本号为零(0.y.z)的软件处于开发初始阶段,一切都可能随时被改变(即公共 API 不稳定)。
  3. 1.0.0 的版本号用于界定公共 API 的形成。这一版本之后所有的版本号更新都基于公共 API 及其修改内容。
  4. 主版本号更新时,次版本号,修订号需要归零;次版本号更新时,修订号需要归零。
  5. 先行版本号(可选)被标注在修订版之后,先加上一个连接号再加上一连串以句点分隔的标识符来修饰。范例:1.0.0-alpha、1.0.0-0.3.7、1.0.0-x.z。
  6. 版本编译信息(可选)被标注在修订版或先行版本号之后,先加上一个加号再加上一连串以句点分隔的标识符来修饰。范例:1.0.0-alpha+001、1.0.0+20130313144700、1.0.0-beta+exp.shaf85。

1.1.2. 实际应用

Node.js, npm, Go Module, Kubernetes 等

1.1.3. 参考

  1. 语义化版本 2.0.0 | Semantic Versioning: https://semver.org/lang/zh-CN/
  2. GitHub - semver/semver: Semantic Versioning Specification: https://github.com/semver/semver

1.2. 日历化版本(CalVer)

基于项目发布日期的版本控制约定,CalVer 并未像"SemVer"使用单一方案,而是引入了开发人员的 标准术语:

  • YYYY - 年份全称 - 2006、2016、2106
  • YY - 年份缩写 - 6、16、106
  • 0Y - 以零填充的年份 - 06、16、106
  • MM - 月份缩写 - 1、2 ... 11、12
  • 0M - 以零填充的月份 - 01、02 ... 11、12
  • WW - 星期(自年初开始)- 1、2、33、52
  • 0W - 以零填充的星期 - 01、02、33、52
  • DD - 日 - 1、2 ... 30、31
  • 0D - 以零填充的日 - 01、02 ... 30、31

1.2.1. 补充说明

  • 传统的递增版本号是从 0 开始,而日期段是从 1 开始的,且年份缩写和以零填充的年份是相对于 2000 年。
  • 星期的使用通常与月/日互斥。

1.2.2. 实际应用

Ubuntu, Twisted, Boltons

1.2.3. 参考

  1. 日历化版本 / Calendar Versioning — CalVer: https://calver.org/overview_zhcn.html

2. 标识符

2.1. Maven

  • SNAPSHOT:快照版本,如 2.4.0-SNAPSHOT(开发环节)
  • RELEASE:正式版本(可以放心使用)

2.2. Spring

  • SNAPSHOT:快照版本,如2020.0.0-SNAPSHOT
  • M数字(milestone):里程碑版本,如2020.0.0-M1、2020.0.0-M2
  • RC数字(Release Candidate):最终产品的候选版本,如果未出现问题则可发布成为正式版本。多数开源软件会推出两个 RC 版本,最后的 RC2 则成为正式版本。如2020.0.0-RC1、2020.0.0-RC2
  • 无后缀:正式版本,如 2.4.0

2.2.1. 参考

  1. What is the difference between Spring's GA, RC and M2 releases? - Stack Overflow: https://stackoverflow.com/questions/2107484/what-is-the-difference-between-springs-ga-rc-and-m2-releases
  2. https://stackoverflow.com/a/2107490

2.3. Windows

  • SP(Service Pack): 一套经过测试的、累积的修补程序、安全更新、关键更新以及其他更新。
  • KB(Knowledge Base):Microsoft 的在线知识库。每个 KB 文章都有一个唯一的编号,用于跟踪特定的问题或更新。

2.3.1. 参考

  1. 标准术语说明 - Windows Client | Microsoft Learn: https://learn.microsoft.com/zh-cn/troubleshoot/windows-client/installing-updates-features-roles/standard-terminology-software-updates

2.4. 其他常见标识符

  • alpha:内部测试版本
  • beta:公开测试版本
  • gamma:相对成熟的测试版,接近即将发行的正式版
  • stable:稳定版(正式版本)
  • RTM:生产商发放(Release to Manufacturing)软件产品准备交付,提供给工厂压片的版本,来自于以前还需要使用实体载具(光盘,硬盘等)来进行安装的时代。
  • GA:一般可用(General availability)所有必要的商业活动(安全性,合法测试,销售评估等)已经完成,该软件产品已经可以发售的阶段。
  • RTW:网络分发(Release to Web,Web发布)利用互联网分发软件
  • OEM:计算机厂商随计算机销售的版本,不能零售。
  • RTL:零售版(Retail),正式上架的零售版。
  • Demo:演示版,试用版,包含正式版的部分功能。
  • Enhance:增强版,会加入一些实用的新功能。

Software_dev2.jpg
Heyinsun, CC BY 3.0 https://creativecommons.org/licenses/by/3.0, via Wikimedia Commons

3. 参考汇总

  1. spring 版本号命名 https://mp.weixin.qq.com/s/ZoUG9h1TndW2QpnPyGeIQA
  2. 语义化版本 2.0.0 | Semantic Versioning: https://semver.org/lang/zh-CN/
    1. GitHub - semver/semver: Semantic Versioning Specification: https://github.com/semver/semver
  3. 日历化版本 / Calendar Versioning — CalVer: https://calver.org/overview_zhcn.html
  4. What is the difference between Spring's GA, RC and M2 releases? - Stack Overflow: https://stackoverflow.com/questions/2107484/what-is-the-difference-between-springs-ga-rc-and-m2-releases
    1. https://stackoverflow.com/a/2107490
  5. 标准术语说明 - Windows Client | Microsoft Learn: https://learn.microsoft.com/zh-cn/troubleshoot/windows-client/installing-updates-features-roles/standard-terminology-software-updates
  6. Version Meta Experimental {VSChemaUnderDef}: https://versionmeta.org/
  7. 软件版本周期 - 维基百科,自由的百科全书: https://zh.wikipedia.org/zh-cn/%E8%BB%9F%E4%BB%B6%E7%89%88%E6%9C%AC%E9%80%B1%E6%9C%9F
  8. 软件各种版本的含义!例如 RC,M,GA 等等 _ 软件测试 rc 包 -CSDN 博客: https://blog.csdn.net/sun54429552/article/details/47690391

相关文章
|
6月前
|
API 数据安全/隐私保护 开发者
软件版本的命名规则
软件版本的命名规则
250 0
|
6月前
|
前端开发 安全 Unix
Python编程手册系列 - 日历、日期、时间相关内建模块详解
Python编程手册系列 - 日历、日期、时间相关内建模块详解
99 0
|
测试技术 数据安全/隐私保护 开发者
软件版本命名规范
软件版本命名规范
234 0
|
JavaScript API
什么是语义化版本?
最近在对项目的版本号做优化,因此重新学习了一下语义化版本的知识。
109 0
|
Web App开发 缓存 小程序
教你如何写一个符合自己需求的小程序日历组件
教你如何写一个符合自己需求的小程序日历组件
Revit二次开发—内建类别BuiltInCategory枚举(中英文对照)
Revit二次开发—内建类别BuiltInCategory枚举(中英文对照)
antd日期组件配置了中文后还是显示英文的解决过程
antd日期组件配置了中文后还是显示英文的解决过程
879 0
antd日期组件配置了中文后还是显示英文的解决过程
|
JSON 测试技术 数据格式
[单账户]标签规范工具(标签策略)使用手册
企业随着上云的深入,对于资源管理的诉求越来越强烈。资源被企业各个子公司、部门等使用的时候,存在资源自产自用,一产复用,共产共用的情况。企业发展最初阶段,满足快速发展的诉求,资源自己生产自己使用。当企业发展到一定阶段,存在资源生产多处复用的情况,以满足业务细分发展。再到资源管理统一生产规划、根据场景复用资源的情况。标签化管理资源共产共用的基础,根据用途、场景、归属进行资源分类。如何把资源标签使用规范就是资源分类的前提。
1067 0
|
JavaScript 前端开发 API
前端工程化必备,语义化版本号扫盲,支持任意版本号位数的比较方法
因为最近在做 Node 相关的项目,涉及到版本号的处理,根据版本号大小做升级 js 处理的,而因为多加了一位数,导致线上的 js 不能升级。 所以只能重写一个支持任意位数的版本号对比方法。 顺便先来一个语义化版本号的扫盲吧。
318 0
|
API 开发工具 git
语义化版本 SemVer
语义化版本 SemVer
187 0