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