首页 > 编程知识 正文

说明书版本号命名规则,程序版本号编写规范

时间:2023-05-05 02:03:26 阅读:38755 作者:890

版本号命名约定1 .前言2 .项目立项时3 .开发阶段时4 .开发完成后发布API或进入两个库时5 .后续维护升级时6 .前期版本号和开发版本号7 .

3359 blog.csdn.net/u 012107143/article/details/78731272

3358 wsf dl.com/devo PS/2016/09/27 /版本号. html

https://semver.org/lang/zh-CN/

1 .前言版本号的命名和更新问题是开发者的责任感和前瞻性问题。

首先,让我们看看常见软件的版本号。

Linux kernel :如果用1.0.0、1.0.0、2.6.32、3.0.18…、X.Y.Z表示,偶数y表示稳定版本,奇数y表示开发版本。 Windows:windows 98、windows 2000、windows xp、windows 7…,最大的特点是杂乱不规则。 ssh客户端:0.9. 8。 openstack:2014.1.3、2015.1.1.dev8。 综上所述,不同版本的软件具有不同的样式,随着系统规模的增大,依赖的软件越来越多,如果这些软件没有遵循一系列规范的命名样式,就会成为从属工具因此,在发布时,版本号的命名必须遵循某些规则。 其中,Semantic Versioning 2.0.0定义了限制版本号配置和增长的简单规则和条件。 本文基于Semantic Versionning 2.0.0和Semantic Versioning 3.0.0选择性地整理了版本号命名约定指南。

2 .项目立项时的版本格式:0.0.0

3 .在开发阶段,系统还不稳定,可以随时增减或修改API。

版本格式:0.次要版本号.版本号、版本号增加规则如下:

主版本号: 0表示正在开发的阶段。 次要编号:添加新功能时添加; 版本号:有变更时会增加。

4 .开发完成后,发布API或同时进入两个库时,系统现在基本稳定,可以向外公开使用,意味着API不再被随意修改。

版本格式:1.0.0

5 .后续维护升级时,如果没有特殊需求,API将保持不变。 特别是在对API进行不兼容升级或销毁时,请特别小心。 如果需要销毁API,建议您在一个或多个版本中添加销毁标记或注释,将其替换为文档中的另一个可替换API,然后在下一个主版本号升级时实际销毁。

版本格式:主要版本号.次要版本号.修订号,版本号增加规则如下:

主版本号:全面重建时增加; 重要功能和方向改变时增加; 与以前的接口不兼容时增加; 次要编号:添加新业务功能时添加; 版本号:添加新接口时添加; 如果接口未更改,则在添加接口的非必需属性时添加; 在扩展接口功能时添加。 新建接口:如果要添加仅扩展现有业务线的接口,请添加修订号。 如果是为了添加新的业务线,请添加子版本号。

6 .早期版本号和开发版本号的早期版本号和版本编译信息可以作为扩展添加到“主版本号.次版本号.修订号”之后。

“早期版本号”(Pre-release )表示此版本不稳定,并且可能存在兼容性问题。 其格式为X.Y.Z.[a-c][正整数],例如为1.0.0.0.a1、1.0.0.b99、1.0.0.c1000。 开发编号:常用于CI-CD (持续集成和持续交付)。 格式是X.Y.Z-dev[正整数],例如1.0.1-dev4。 版本号排序规则是依次比较主版本号、次版本号、修订号的数值,例如1.0.0.01.0.1.1.12.0; 有关早期版本号和开发版本号,请参阅1.0.0.a1001.0.0、2.1.0-dev32.1.0; 如果有字母,请按ASCII排序进行比较,例如1.0.0.a1 1.0.0.b1。

7 .若干修饰语"阿尔法"、"贝塔"、"贝塔"、"示威"、"增强"、"增强"、"自由"、"完整",即正式版" lts "、"长期保养版"、"莉莉业务功能接口

版权声明:该文观点仅代表作者本人。处理文章:请发送邮件至 三1五14八八95#扣扣.com 举报,一经查实,本站将立刻删除。