语义化版本命名通行规则
該規(guī)則對版本的迭代順序命名做了很好的規(guī)范,其版本號的格式為X.Y.Z(又稱Major.Minor.Patch),遞增的規(guī)則為:
| X | 非負整數(shù) | 表示主版本號(Major),當API 的兼容性變化時,X 需遞增。 |
| Y | 非負整數(shù) | 表示次版本號(Minor),當增加功能時(不影響API 的兼容性),Y 需遞增。 |
| Z | 非負整數(shù) | 表示修訂號(Patch),當做Bug 修復時(不影響API 的兼容性),Z 需遞增。 |
詳細的使用規(guī)則如下:
X, Y, Z 必須為非負整數(shù),且不得包含前導零,必須按數(shù)值遞增,如1.9.0 -> 1.10.0 -> 1.11.0
0.Y.Z 的版本號表明軟件處于初始開發(fā)階段,意味著API 可能不穩(wěn)定;1.0.0 表明版本已有穩(wěn)定的API。
當API 的兼容性變化時,X 必須遞增,Y 和Z 同時設置為0;當新增功能(不影響API 的兼容性)或者API 被標記為Deprecated 時,Y 必須遞增,同時Z 設置為0;當進行bug fix 時,Z 必須遞增。
先行版本號(Pre-release)意味該版本不穩(wěn)定,可能存在兼容性問題,其格式為:X.Y.Z.[a-c][正整數(shù)],如1.0.0.a1,1.0.0.b99,1.0.0.c1000。
開發(fā)版本號常用于CI-CD,格式為X.Y.Z.dev[正整數(shù)],如1.0.1.dev4。
版本號的排序規(guī)則為依次比較主版本號、次版本號和修訂號的數(shù)值,如1.0.0 < 1.0.1 < 1.1.1 < 2.0.0;對于先行版本號和開發(fā)版本號,有:1.0.0.a100 < 1.0.0,2.1.0.dev3 < 2.1.0;當存在字母時,以ASCII 的排序來比較,如1.0.0.a1 < 1.0.0.b1。
注意:版本一經發(fā)布,不得修改其內容,任何修改必須在新版本發(fā)布!
?
總結
以上是生活随笔為你收集整理的语义化版本命名通行规则的全部內容,希望文章能夠幫你解決所遇到的問題。
- 上一篇: Spring框架版本命名规则
- 下一篇: 商业软件中常见的修饰词