程序代碼版本管理規(guī)范解析

1、Document NojRev.Modify Date:Page: 1 - of-a-軟件版本管理規(guī)范SoftwareDocument NojRev.Modify Date:Page:-i - of -8-Document Ns:Rev.Modify Date:Page:-2 -減-乩Revisi on Listnocumcnl Ma-Rev.Mo DilarPvgt-DulcRrvMnOwnerDocument NojRev.Modify Date:Page:-3 - of *8*目錄一、目的-4 -二、適用范圍-4 -、版本定義規(guī)范-4 -四、版本代碼設計規(guī)范-4 -五、版本進階規(guī)范-5

2、-六、軟件備份要求規(guī)范-5 -七、軟件版本發(fā)布規(guī)范-5 -八、軟件發(fā)布流程規(guī)范-7 -九、量產中軟件管理規(guī)范.-8 -Docuinent Ns:Rev.Modify Date:Page:-4 -減-E一、目的1.1本規(guī)范規(guī)定了公司軟件發(fā)布及版本管理規(guī)范，為工程師發(fā)布軟件提供版本管 理標準和流程。1.2提高本公司軟件版本的可識別性，為工程，生產，售后服務提供便利性。二、適用范圍本規(guī)范適用于研發(fā)部軟件人員發(fā)布軟件、程序時制定版本參考。本規(guī)范中所涉及軟件為泛指一切以計算機代碼形式存在的軟件，包括以下（但不限于幾類：1、Windows軟件、程序2、Linux軟件、程序3、經過裁剪后Linux內核4、單

3、片機,DSP,ARM固件代碼及燒錄FW5、FPGA代碼及燒錄FW6本公司自己開發(fā)的驅動程序7、第三方提供的驅動程序8、第三方提供的燒錄FW三、版本定義規(guī)范3.1本規(guī)范規(guī)定:除第三方提供的軟件以外，本公司開發(fā)的軟件正式版本號采用如 下格式，3.1.1三位版本編碼格式,即x.xx,由三位數(shù)字和一位小數(shù)點組成第一版正式版即1.00;在1.00正式版之前研發(fā)內部測試和驗證版本以0.XX.XX表示。3.2選用哪種版本號格式由軟件自身情況決定；同一軟件版本號格式不得隨意更 改,一旦選用三位或五位版本編碼格式，在沒有必要和充分的理由的前提下不能對版 本號格式進行變更。3.3第三方公司提供的軟件繼續(xù)沿用第三方

4、公司的版本號編碼格式。四、版本代碼設計規(guī)范為便于檢查和查看軟件版本，固件、軟件版本通過工具可以被查看，因此在軟件代碼設計階段，Document Nc:Rev.Modify Date：Page:-5 -對版本查看應實現(xiàn)如下要求4.1固件:量產后燒錄的F/W版本可通過以下兩種方式之一進行查看(1可以通過LCD顯示。(2可用通過串口或其他通信接口通過電腦上位機軟件(命令方式獲取4.2上位機程序或軟件版本可以通過以下方式之一進行查看(1顯示在標題欄、狀態(tài)欄，或界面中；(2通過 關于”或“ About菜單查看；(3通過命令行查看。例：xxxx 或xxxx -/er;五、版本進階規(guī)范5.1正式版版本迭代更

5、新。軟件為修正bug,完善功能，增加功能的情況下，需要對軟件版本進行更新和升級，本規(guī)范規(guī)定如下：5.1.1三位版本編碼格式正式版本迭代升級可進行兩部分變更，小數(shù)位之前或小數(shù)位之后。例:1.00版本可以升級為1.01也可以升級為2.00;較大的軟件變動建議升級小數(shù)位之前數(shù)字，較小的軟件修正和變動建議升級小 數(shù)位之后的數(shù)字。5.2測試版和試用版版本迭代更新。產品量產后若需要修改部分功能或針對客戶進行定制的F/W和Program在測試驗證階段均采用5位數(shù)字和2個小數(shù)點構成，且只能修改最后兩位數(shù)字版本號，如:1.01.00- 1.01.01,1.01.02只有當測試版本經過測試和驗證，或客戶認可后，才

6、能 發(fā)表正式版,進階前3位數(shù)字。例：1.01.02的測試版解決了某些bug或增加功能， 并經過測試驗證解決了實際的問題，則將1.01.02測試版重新編譯，變更測試版本變更 為正式版格式。如1.01.02-1.02.00b六、軟件備份要求規(guī)范軟件代碼變更后均要將變更更新至服務器Git版本庫進行管理，未備份至Git版本庫的軟件版本不允許發(fā)布。具體備份步驟參考研發(fā)部Git版本庫服務器使用指南七、軟件版本發(fā)布規(guī)范7.1正式版FW,軟件需要經過工程測試部門驗證后在進行發(fā)布。測試版軟件發(fā) 布由工程師根據(jù)實際情況而定。Document No.: Rev. Working Instruction Modify

7、 Date: Page: - 6 - of -8- 7.2 正式版 軟件發(fā)布時要除軟件本身外，需要附更新說明release notes Release notes采用追加方式記錄，即保留之前的更新日志。且采用倒序方式，最新版本更新日志在最前端。測試版更新一樣要記錄入更新日志文件。Release notes格式如下：當前版本：1.01 日期：xx-xx-xx Author :更新原因及內容：（1Xxxxx （2Xxxxx （分隔線）前一版本：1.00.08（T測試版日期：xx-xx-xx Author :更新原因及內容：（1Xxxxx （2Xxxxx ,-6-Document No.: Rev.

8、 Working Instruction Modify Date: Page: - 7 - of -8-八、軟件 發(fā)布流程規(guī)范軟件工程師代碼編寫、修改設計工程師調試No調試通過？ Yes Yes測試版本發(fā)布Git代碼庫測試工程師測 試驗證驗證通過？ No反饋給軟件工 程師更新Yes客戶驗證（Option） No驗證通過？ Yes軟件工程師發(fā)布 正式版 發(fā) 布ECN通知工程、生產，計劃做相應變更-7-Document No.: Rev. Working Instruction Modify Date: Page: - 8 - of -8-九、量產 中軟件管理規(guī)范9.1已發(fā)布的軟件程序，安裝包，Bin，Hex等文件需要在FTP中 進行備份。備份管理工作由工程部負責。9.2生產部生產帶有軟件下載的PCBA 或成品時，F(xiàn)/W（bin,hex文件下載后須在相應芯片上貼 上機種、版本”標簽。9.3 當軟件版本有更新時，軟件工程師和研發(fā)主管根據(jù)更新內容評估，對在