版本號命名指南

首先看看某些常見軟件的版本號:html

  • Linux Kernel: 0.0.1,1.0.0,2.6.32,3.0.18…,若用 X.Y.Z 表示,則偶數 Y 表示穩定版本,奇數 Y 表示開發版本。
  • Windows:windows 98,windows 2000,windows xp,windows 7…,最大的特色是雜亂無章,毫無規律。
  • SSH Client:0.9.8。
  • OpenStack:2014.1.3,2015.1.1.dev8。

從上能夠看出,不一樣的軟件版本號風格各異,隨着系統的規模越大,依賴的軟件越多,若是這些軟件沒有遵循一套規範的命名風格,容易形成 Dependency Hell。因此當咱們發佈版本時,版本號的命名須要遵循某種規則,其中 Semantic Versioning 2.0.0 定義了一套簡單的規則及條件來約束版本號的配置和增加。本文根據 Semantic Versionning 2.0.0 和 Semantic Versioning 3.0.0 選擇性的整理出版本號命名規則指南。windows


版本號命名規則指南

版本號的格式爲 X.Y.Z(又稱 Major.Minor.Patch),遞增的規則爲:測試

  • X 表示主版本號,當 API 的兼容性變化時,X 需遞增。
  • Y 表示次版本號,當增長功能時(不影響 API 的兼容性),Y 需遞增。
  • Z 表示修訂號,當作 Bug 修復時(不影響 API 的兼容性),Z 需遞增。

詳細的規則以下:htm

  1. X, Y, Z 必須爲非負整數,且不得包含前導零,必須按數值遞增,如 1.9.0 -> 1.10.0 -> 1.11.0
  2. 0.Y.Z 的版本號代表軟件處於初始開發階段,意味着 API 可能不穩定;1.0.0 代表版本已有穩定的 API。
  3. 當 API 的兼容性變化時,X 必須遞增,Y 和 Z 同時設置爲 0;當新增功能(不影響 API 的兼容性)或者 API 被標記爲 Deprecated 時,Y 必須遞增,同時 Z 設置爲 0;當進行 bug fix 時,Z 必須遞增。
  4. 先行版本號(Pre-release)意味該版本不穩定,可能存在兼容性問題,其格式爲:X.Y.Z.[a-c][正整數],如 1.0.0.a1,1.0.0.b99,1.0.0.c1000。
  5. 開發版本號經常使用於 CI-CD,格式爲 X.Y.Z.dev[正整數],如 1.0.1.dev4。
  6. 版本號的排序規則爲依次比較主版本號、次版本號和修訂號的數值,如 1.0.0 < 1.0.1 < 1.1.1 < 2.0.0;對於先行版本號和開發版本號,有:1.0.0.a100 < 1.0.0,2.1.0.dev3 < 2.1.0;當存在字母時,以 ASCII 的排序來比較,如 1.0.0.a1 < 1.0.0.b1。
  7. 注意:版本一經發布,不得修改其內容,任何修改必須在新版本發佈!

一些修飾的詞

  • alpha:內部版本
  • beta:測試版
  • demo:演示版
  • enhance:加強版
  • free:自由版
  • full version:完整版,即正式版
  • lts:長期維護版本
  • release:發行版
  • rc:即將做爲正式版發佈
  • standard:標準版
  • ultimate:旗艦版
  • upgrade:升級版

 

原博地址:http://wsfdl.com/devops/2016/09/27/%E7%89%88%E6%9C%AC%E5%8F%B7.html排序

我就是複製備份,不要告我。ip

啦啦啦開發

相關文章
相關標籤/搜索