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

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

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

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

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

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

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

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

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

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

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

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

12、責(zé)任人6)版本提交歸檔后，軟件的任何修改需先 向管理人員申請(qǐng)，由版本管理員提交該版本，開(kāi)發(fā)人員不能自行使用開(kāi)發(fā)時(shí)使用的源程序7)軟件提交同時(shí)需附上編譯說(shuō)明文檔 ,內(nèi)容包括:編譯環(huán)境,編譯工具,編譯步驟等 標(biāo)標(biāo) 題題軟件版本管理規(guī)范編編 號(hào)號(hào)F-03-007頁(yè)頁(yè) 次次7/9制制訂訂部部門(mén)門(mén)研發(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ā)布中，會(huì)因發(fā)布的類(lèi)型不同而產(chǎn)生不同的發(fā)布包。可能會(huì)有以下幾種類(lèi)型:產(chǎn)品升級(jí)發(fā)布: 指在早期版本的基礎(chǔ)上提高產(chǎn)品的特征集，當(dāng)

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

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

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