軟件版本管理規(guī)范V2

1、 標標 題題軟件版本管理規(guī)范編編 號號F-03-007頁頁 次次1/9制制訂訂部部門門研發(fā)部版版 次次A001制制訂訂日日期期 2008-12-021軟件版本管理規(guī)范制訂：劉志敏審核：_批準：_ 文 件 修 訂 記 錄 文件名稱工程設計變更管理程序編號F-02-002 版次修訂內(nèi)容修改頁次修訂日期修訂者備注A00新版本發(fā)行2007-10-7劉志敏A01流程優(yōu)化后進行相應修訂2008-12-02姚旋 標標 題題軟件版本管理規(guī)范編編 號號F-03-007頁頁 次次2/9制制訂訂部部門門研發(fā)部版版 次次A001制制訂訂日日期期 2008-12-022目目 錄錄1.目目的的 .32.適適用用范范圍圍

2、.33.權權責責 .33.1.版本管理員 .33.2.軟件系統(tǒng)架構師 .43.3.軟件工程師 .43.4.軟件主管 .53.5.軟件測試工程師 .64.作作業(yè)業(yè)流流程程 .64.1.流程及發(fā)布 .64.2.注意事項 .64.3.軟件歸檔控制 .74.4.軟件發(fā)布控制 .84.4.1.發(fā)布內(nèi)容 .84.4.2.發(fā)布評審（Review）.94.4.3.軟件產(chǎn)品正式版本發(fā)布流程 如下 .95.相相關關文文件件 .115.1.研發(fā)設計開發(fā)控制程序 .115.2.項目計劃.116.記記錄錄表表單單 .116.1.軟件概要設計評審檢查表 .116.2.軟件詳細設計評審檢查表 .116.3.軟件集成測試報告

3、評審檢查表 .116.4.軟件發(fā)布評審檢查表 .116.5.SVN 月度稽查檢查表 .117.附附件件.11 標標 題題軟件版本管理規(guī)范編編 號號F-03-007頁頁 次次3/9制制訂訂部部門門研發(fā)部版版 次次A001制制訂訂日日期期 2008-12-0231 1. . 目目的的1 1. .1 1. .標準化軟件工作流程1 1. .2 2. .軟件開發(fā)過程中代碼安全1 1. .3 3. .標準化配置管理，規(guī)范開發(fā)文檔輸入輸出1 1. .4 4. .軟件版本控制 提高軟件發(fā)布質量1 1. .5 5. .對配置管理進行跟進 ,調(diào)查,改善, 為糾正預防提供方向2 2. . 適適用用范范圍圍 所有軟件

4、版本管理員、 軟件系統(tǒng)架構師、 軟件工程師、 軟件測試工程師、 軟件技術總監(jiān) /副總監(jiān)、軟件主管3 3. . 權權責責3 3. .1 1. .版版本本管管理理員員1)負責版本服務器的日常維護2)版本服務器用戶的添加，刪除，修改訪問權限3)版本服務器數(shù)據(jù)庫的建立4)版本服務器新項目模塊庫建立5)依據(jù)系統(tǒng)架構師對新建項目的模塊劃分 ,設置組成員版本服務器工作權限6)編譯檢查發(fā)布正式版本,確保代碼是最新可用的7)項目完成對代碼進行編譯檢查 ,清理所有項目文檔并歸檔8)文檔資料的定時備份 .(完成歸檔的項目資料按月備份 )9)協(xié)助解決版本服務器用戶使用過程中所遇到的問題10) 對 SVN 服務器使用情

5、況進行稽查提交SVN 月度稽查報告檢查表 標標 題題軟件版本管理規(guī)范編編 號號F-03-007頁頁 次次4/9制制訂訂部部門門研發(fā)部版版 次次A001制制訂訂日日期期 2008-12-0243 3. .2 2. .軟軟件件系系統(tǒng)統(tǒng)架架構構師師1)對軟件項目進行模塊劃分2)協(xié)同版本管理員在版本服務器上進行目錄設置 ,保證代碼安全3)檢查組成員的上傳代碼 ,保證代碼的質量4)按項目計劃時間點 ,及時提交軟件項目文件5)對單元測試中發(fā)現(xiàn)的問題及時進行處理 .并在服務器做好備份工作6)發(fā)布集成測試軟件版本 和集成測試報告給測試組做集成測試驗證7)對后期測試發(fā)現(xiàn)的 bug 要及時跟進安排解決，對修改的代

6、碼及時上傳服務器并 添加修改說明8)正式版本發(fā)布， 按標準更新版本號，確保所有正式發(fā)布版本唯一9)項目完成對所有代碼和文檔做檢查，提交版本管理員； 對模塊的代碼組織進行模塊化評審,歸檔，并提交相應說明文檔3 3. .3 3. .軟軟件件工工程程師師1)負責對軟件功能模塊的編碼工作2)工作前對本地工作目錄的代碼進行檢查是否為最新版本 ,確認后方可進行 工作,否則必須先進行本地工作目錄的更新3)工作完成后及時將本地機工作目錄下的代碼進行 checkin,避免代碼丟失造成的損失4)每次涉及到版本機的 checkin 都必須附上版本說明 (說明修改的內(nèi)容 ,新增功能,解決的 bug 等)5)服從系統(tǒng)架

7、構師 配置管理工作安排，文件代碼要及時歸檔6)維護工作涉及代碼的修改必須上傳版本服務器，并且附修改說明（明確為什么修改，修改哪些地方，修改日期，修改人等信息）3 3. .4 4. .軟軟件件主主管管1)負責把關產(chǎn)品的軟件設計，確保設計滿足要求 , 參與新產(chǎn)品需求說明書 評審 標標 題題軟件版本管理規(guī)范編編 號號F-03-007頁頁 次次5/9制制訂訂部部門門研發(fā)部版版 次次A001制制訂訂日日期期 2008-12-0252)參與軟件概要設計、詳細設計、編碼工作、單元測試、集成測試，對各環(huán)節(jié)進行檢查評審，確保工作質量3)審批本組成員輸出資料，確保輸出資料準確無誤4)把關軟件概要設計 、 詳細設計

8、檢查評審，確保設計滿足需求5)把關軟件單元測試報告 、 集成測試報告檢查評審，確保發(fā)布到測試組的軟件質量6)規(guī)劃參與項目的本組成員，估計項目進度要求的各里程碑7)協(xié)助、指導本組項目成員參考研發(fā)服務器上項目計劃模板制作軟件開發(fā)計劃進度表8)審核軟件開發(fā)計劃進度表 ，確保時間利用最大化9)督導本組成員將項目計劃任務落實到月、周工作計劃中10)負責測試用例庫建設，并監(jiān)督測試流程，把關測試質量3 3. .5 5. .軟軟件件測測試試工工程程師師1)協(xié)助系統(tǒng)架構師和 軟件工程師完成軟件單元測試 ,集成測2)軟件系統(tǒng)測試,對于測試中發(fā)現(xiàn)的 bug 與對應軟件工程師溝通并 上 TD 服務器3)軟件測試通過后

9、 組織系統(tǒng)架構師和相關人員召開發(fā)布評審會4 4. . 作作業(yè)業(yè)流流程程4 4. .1 1. .流流程程及及發(fā)發(fā)布布詳見軟件組工作流程4 4. .2 2. .注注意意事事項項a)下班前更新時 ,不要把沒有編譯成功的程序文件遷入版本服務器b)添加修改版本服務器上的文件，必須添加注釋說明c)本機除了開發(fā)工程目錄外，還需建一個中間工程目錄， 目錄下面可以根據(jù)自己需要 標標 題題軟件版本管理規(guī)范編編 號號F-03-007頁頁 次次6/9制制訂訂部部門門研發(fā)部版版 次次A001制制訂訂日日期期 2008-12-026新增子目錄， 每次工作前，先更 新中間工程目錄，使它與版本服務器上的工程文件完全一致d)備

10、份文件代碼遷入版本服務器前，必須對文件進行編譯檢查e)標簽和分支的命名 必須遵照標準進行 (產(chǎn)品完整型號 +版本+分支名稱)f)備份文件歸檔時 ,將代碼中編譯冗余文件清除 (如:.a;.o 等等)g)產(chǎn)品到發(fā)布版本給測試的階段，要修改版本服務器代碼必須有系統(tǒng)工程師或相關人員審核確保代碼的準確h)項目全部源代碼僅有管理員和架構師掌握 ,確保代碼安全i)所有代碼必須從版本服務器上下載 ,禁止以其它任何形式傳遞獲取代碼j)正式軟件必須由版本管理員發(fā)布 ,加強對軟件版本的控制4 4. .3 3. .軟軟件件歸歸檔檔控控制制1)開發(fā)完成后進行軟件版本歸檔，內(nèi)容主要有： 軟件名稱（中、英文），版本號，編譯

11、后的可執(zhí)行文件， 源代碼和文檔（需求分析文檔，概要設計，詳細設計，測試用例和 bug 報告等）2)系統(tǒng)架構師確定要發(fā)布的版本號， 然后由版本管理員檢查 是否滿足版本提交條件，最后由版本管理員確認后，將該版本存檔3)軟件版本升級變更時，由系統(tǒng)工程師根據(jù)軟件工程師提交的源代碼和文檔在版本服務器進行更新檢查并知會版本管理員 ，然后由版本管理員檢查 是否滿足版本提交條件，最后由版本管理員確認后，再 將該版本存檔4)當發(fā)生用戶需求變更時， 系統(tǒng)架構師提交程序需求變更設計說明，并另行標明在源程序和文檔中何處進行了更改，最終由 軟件主管審核通過后，將該版本存檔5)確定每個版本責任人，同一軟件可以有不同時期的

12、責任人6)版本提交歸檔后，軟件的任何修改需先 向管理人員申請，由版本管理員提交該版本，開發(fā)人員不能自行使用開發(fā)時使用的源程序7)軟件提交同時需附上編譯說明文檔 ,內(nèi)容包括:編譯環(huán)境,編譯工具,編譯步驟等 標標 題題軟件版本管理規(guī)范編編 號號F-03-007頁頁 次次7/9制制訂訂部部門門研發(fā)部版版 次次A001制制訂訂日日期期 2008-12-0274 4. .4 4. .軟軟件件發(fā)發(fā)布布控控制制4 4. .4 4. .1 1. . 發(fā)發(fā)布布內(nèi)內(nèi)容容4.4.1.1.在軟件發(fā)布中，會因發(fā)布的類型不同而產(chǎn)生不同的發(fā)布包?？赡軙幸韵聨追N類型:產(chǎn)品升級發(fā)布: 指在早期版本的基礎上提高產(chǎn)品的特征集，當

13、然也包括更新內(nèi)容產(chǎn)品更新發(fā)布 通常是修復老產(chǎn)品的缺陷 如收集一定時間內(nèi)的產(chǎn)品缺陷，匯總產(chǎn)生如 3.0.1 進行更新發(fā)布補丁發(fā)布：補丁（緊急修復）是用來修復產(chǎn)品 缺陷或掩飾缺點的。補丁和更新之間的區(qū)別是緊急程度和實施的工作量4.4.1.2.發(fā)布包的主要構成如下 ，如果是補丁或產(chǎn)品更新發(fā)布，發(fā)布包簡化為程序、說明性文檔和源碼程序源碼發(fā)布說明文檔，包括各種 readme（測試組提供）用戶（操作）手冊 （測試組提供）全套項目文檔配置說明文檔其它4 4. .4 4. .2 2. .發(fā)發(fā)布布評評審審（R Re ev vi ie ew w）對于軟件正式發(fā)布 ，測試工程師要組織各相關人員召開評審會由系統(tǒng)工程師

14、支持審核和檢查，以保證發(fā)布的產(chǎn)品滿足用戶的需求及公司的各類規(guī)范軟件發(fā)布評審項目文檔的檢查源代碼和安裝程序的檢查4 4. .4 4. .3 3. .軟軟件件產(chǎn)產(chǎn)品品正正式式版版本本發(fā)發(fā)布布流流程程 如如下下4.4.3.1.發(fā)布準備 發(fā)布之前，所有程序由測試工程師進行確認測試；檢查 標標 題題軟件版本管理規(guī)范編編 號號F-03-007頁頁 次次8/9制制訂訂部部門門研發(fā)部版版 次次A001制制訂訂日日期期 2008-12-028BUG 系統(tǒng)內(nèi)登記的所 有 bug 都已經(jīng)被解決，或者遺留的 bug 不影響系統(tǒng)的使用，如果有嚴 重 bug 未解決則不能發(fā)布；程序打包前做測試4.4.3.2.測試工程師組

15、織軟件發(fā)布評審，由軟件系統(tǒng)工程師主持評審4.4.3.3.源碼、文檔入庫 編譯構建腳本和所有源代碼；文檔包括 需求說明、設計說明、計劃，測試文檔，操作手冊、使用demo 等4.4.3.4.系統(tǒng)工程師進行程序打包 標記源碼、文檔版本 tag4.4.3.5.編寫發(fā)布說明 readme.txt Read me 的內(nèi)容應該包括產(chǎn)品版本說明；本次發(fā)布包含的文件包、文檔說明；本次發(fā)布包含或者新增的功能特性說明；遺留問題及影響說明；版權聲明以及其他需要說明的事項4.4.3.6.正式發(fā)布通知 通知開發(fā)、測試、市場、銷售各相關部門并附上發(fā)布說明和介紹4.4.3.7.后續(xù)工作 軟件發(fā)布后，在使用過程中可能還會發(fā)現(xiàn)一些bug，由公司 BUG 管理系統(tǒng)跟蹤。在不影響正常使用的情況下，這些bug 將在下一版本發(fā)布時解決；如果 bug 嚴重影響使用，必須按照流程重新發(fā)布4.4.3.8.臨時發(fā)布 軟件產(chǎn)品未正式發(fā)布前，可能需要一個臨時版本供軟件工程師或者用戶應急使用，這時候需要臨時發(fā)布一個版本。這個版本只包括基本的程序包和必要的使用說明。臨時發(fā)布需要通知相關開發(fā)、測試工程師；系統(tǒng)工程師需要為源碼、文檔打 tag 標記5 5. . 相相關關文文件件5 5. .1 1. .