语义化版本控制规范(SemVer)
生活随笔
收集整理的這篇文章主要介紹了
语义化版本控制规范(SemVer)
小編覺得挺不錯的,現在分享給大家,幫大家做個參考.
參考鏈接?https://semver.org/lang/zh-CN/
語義化版本 2.0.0
(透過版本號的改變來傳達信息.)
摘要
版本格式: 主版本號.次版本號.修訂號
版本號遞增規則如下:
1.主版本號: 做了不兼容的API修改.
2.次版本號: 做了向下兼容的功能性新增.
3.修訂號: 做了向下兼容的問題修正.
?
?
規范摘要:以下以x.y.z表示版本號格式
- 上一級版本號遞增時,下面的版本號必須歸零.
- 舉個簡單的例子就可以展示語義化的版本控制如何讓依賴地獄成為過去。假設有個名為“救火車”的函式庫,它需要另一個名為“梯子”并已經有使用語義化版本控制的包。當救火車創建時,梯子的版本號為 3.1.0。因為救火車使用了一些版本 3.1.0 所新增的功能, 你可以放心地指定依賴于梯子的版本號大等于 3.1.0 但小于 4.0.0。這樣,當梯子版本 3.1.1 和 3.2.0 發布時,你可以將直接它們納入你的包管理系統,因為它們能與原有依賴的軟件兼容。
- 0.y.z中 0 為主版本號,如 0.1.0 是初始化開發版本.并在后續的每次發行時遞增次版本號.
- 主版本為0時,表示仍在快速開發階段,每天都在改變API.
- 如果不小心把不兼容的改版當成了次版本號發行了該怎么辦?
- 一旦發現自己破壞了語義化版本控制的規范,就要修正這個問題.
- 發行一個新的次版本號恢復向下兼容.
- 不能修改已發行的版本.
- 將有問題的版本號記錄下來,告訴使用者問題所在,讓他們知道這是一個有問題的版本.
- 如何處理即將棄用的功能?
- 更新文件說明讓使用者知道這個改變.
- 在適當時機將棄用的功能透過新的次版本號發布.
- 在新的主版本完全移除棄用功能前,至少有一個次版本包含這個即將棄用的說明信息,這樣使用者才能平順地過渡到新版API中.
轉載于:https://www.cnblogs.com/sweetXiaoma/p/10349647.html
創作挑戰賽新人創作獎勵來咯,堅持創作打卡瓜分現金大獎總結
以上是生活随笔為你收集整理的语义化版本控制规范(SemVer)的全部內容,希望文章能夠幫你解決所遇到的問題。
- 上一篇: Pytorch基础(三)—— DataS
- 下一篇: JavaScript 3D实时散点图