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

軟件版本管理目錄1. 引言 11.1. 目的 11.2. 范圍 11.3. 11.4. 21.5. 21.6. 22. 42.1. 42.1.1. 42.2. 52.3. 62.3.1. 62.3.2. 62.3.3. SQL 72.3.4. 72.4. 72.5. 83. 93.1. 93.2. 103.2.1. 103.2.2. 3.3. 4. 121.引言版本控制就是對(duì)軟件開(kāi)發(fā)過(guò)程中所創(chuàng)建的配置對(duì)象不同版本進(jìn)行管理保任何時(shí)間都可以取到正確的版本以及版本的組合。版本控制的主要功能是記錄開(kāi)發(fā)過(guò)程中的每一次修改讓開(kāi)發(fā)的工作可以時(shí)檢查過(guò)往歷史記錄和獲得正確版本，是系統(tǒng)的成長(zhǎng)記錄。1.1.目的本文檔的編制是為了規(guī)范產(chǎn)品部、研發(fā)部、測(cè)試部對(duì)軟件產(chǎn)品版本的管理。1.2.范圍容，包括： 版本標(biāo)識(shí)方法 軟件系統(tǒng)數(shù)據(jù)的存放 文檔的修改控制 文檔的備份制度1.3.術(shù)語(yǔ)定義軟件配置管理（SoftwareConfigurationManagemen）縮SVM軟件版本管理（ent）縮寫(xiě)SVN一個(gè)開(kāi)源的版本控制系統(tǒng)Subversion.文檔一種數(shù)據(jù)媒體和其上所記錄的數(shù)據(jù)。配置管理標(biāo)識(shí)和確定系統(tǒng)中配置項(xiàng)的過(guò)程在系統(tǒng)整個(gè)生存周期內(nèi)控制這些項(xiàng)的投和更動(dòng)，記錄并報(bào)告配置的狀態(tài)和更動(dòng)要求，驗(yàn)證配置項(xiàng)的完整性和正確性。軟件配置軟件的具體形態(tài)在某時(shí)刻的瞬時(shí)影像配置項(xiàng)戶手冊(cè)，源碼?；€軟件生存周期中各開(kāi)發(fā)階段末尾的標(biāo)記它的作用是把各階段工作的劃分更加明確化，使本來(lái)連續(xù)的工作在這些點(diǎn)上斷開(kāi)，使之便于檢驗(yàn)和肯定階段成果1.4.參考資料《軟件版本管理規(guī)范》浪潮集團(tuán)山東通用軟件有限公司《泰豪軟件開(kāi)發(fā)軟件版本管理制度》《tortoiseSVN的使用手冊(cè)》1.5.版本控制記錄部門(mén)擬稿審核批準(zhǔn)1.6.版本更新記錄版修改人日期A-增加M-版修改人日期2.版本管理2.1.版本標(biāo)示方法為了使工作規(guī)范化、統(tǒng)一化，研發(fā)本部各部門(mén)實(shí)行的版本標(biāo)識(shí)管理方法。2.1.1.正式版本軟件版本號(hào)由四部分組成，_希臘字母，例子中主版本號(hào)的上升用來(lái)說(shuō)明產(chǎn)品現(xiàn)在已經(jīng)擁有了一個(gè)全新的功能類(lèi)從市場(chǎng)和許可權(quán)的角度來(lái)看主版本號(hào)的升級(jí)相當(dāng)于購(gòu)買(mǎi)一個(gè)完全獨(dú)立的產(chǎn)品從開(kāi)發(fā)者角度來(lái)看一個(gè)主版本號(hào)的迭代差不多總是反映了一個(gè)新的獨(dú)立分支或是主干還可以延續(xù)主版本的生命期。的特征上作了重要的修改用來(lái)確定特征版本號(hào)什么時(shí)候需要修改的一個(gè)衡量準(zhǔn)就是產(chǎn)品功能說(shuō)明書(shū)產(chǎn)品的特征版本升級(jí)是在主版本之間保持產(chǎn)品競(jìng)爭(zhēng)力一種重要機(jī)制。：缺陷修復(fù)版本號(hào)，用來(lái)表示在該版本上所做的缺陷維護(hù)行為的等級(jí)版修復(fù)版本是穩(wěn)定市場(chǎng)和最小化客戶技術(shù)支持費(fèi)用負(fù)擔(dān)的一種重要機(jī)制。Alpha版:此版本表示該軟件在此階段主要是以實(shí)現(xiàn)軟件功能為主，通常只在軟件開(kāi)發(fā)者內(nèi)部交流，一般而言，該版本軟件的Bug較多，需要繼續(xù)修改。a版:該版本相對(duì)于α版已有了很大的改進(jìn)消除了嚴(yán)重的錯(cuò)誤但還是存在著一些缺陷需要經(jīng)過(guò)多次測(cè)試來(lái)進(jìn)一步消除此版本主要的修改對(duì)像是軟件的U。RC版:的行的正式版相差無(wú)幾。e版:該版本意味最終版本在前面版本的一系列測(cè)試版之后終歸會(huì)有一個(gè)正式版本是最終交付用戶使用的一個(gè)版本該版本有時(shí)也稱(chēng)為標(biāo)準(zhǔn)版。一般情況下e不會(huì)以單詞形式出現(xiàn)在軟件封面上取而代之的是符號(hào)(R。例如1.1.1.051021_beta第一個(gè)1為主版本號(hào)，第二個(gè)1為子版本號(hào)，第三個(gè)1為階段版本號(hào)第四部分為日期版本號(hào)加希臘字母版本號(hào)希臘字母版本號(hào)共有5種，分別為、alph、、RC．releas。2.2.目錄結(jié)構(gòu)由于各部門(mén)的實(shí)際情況不同目錄結(jié)構(gòu)很難統(tǒng)一但為了能更好地管理各部門(mén)部文檔，建議可將被管理的配置項(xiàng)分為三大類(lèi)：文檔類(lèi)、源碼類(lèi)及安裝盤(pán)類(lèi)這樣存放比較清晰，有利于版本管理。具體目錄如下表格所示：根目錄一級(jí)目錄二級(jí)目錄三級(jí)目錄集成代碼代碼的合并第一個(gè)模塊代碼源代碼（SRC）第二個(gè)模塊代碼數(shù)據(jù)庫(kù)SQL公共開(kāi)發(fā)包代碼立項(xiàng)文檔立項(xiàng)計(jì)劃書(shū)立項(xiàng)申請(qǐng)書(shū)項(xiàng)目計(jì)劃項(xiàng)目開(kāi)發(fā)計(jì)劃需求文檔需求規(guī)格說(shuō)明書(shū)項(xiàng)目名稱(chēng)設(shè)計(jì)文檔設(shè)計(jì)概要說(shuō)明書(shū)數(shù)據(jù)庫(kù)設(shè)計(jì)說(shuō)明書(shū)+版本號(hào)文檔(DOC)界面布局參考資料原型界面動(dòng)態(tài)頁(yè)面項(xiàng)目一些參考資料驗(yàn)收文檔驗(yàn)收資料測(cè)試文檔測(cè)試計(jì)劃測(cè)試報(bào)告測(cè)試用例試用信息測(cè)試部署部署材料SETUP發(fā)（RELEASE）RELEASE發(fā)布文檔2.3.文檔的存放2.3.1.開(kāi)發(fā)文檔的存放文檔編寫(xiě)員文檔編寫(xiě)員評(píng)審人員配置管理員編寫(xiě)文檔格式規(guī)范化檢查修改文檔評(píng)審版本不通過(guò)通過(guò)文檔評(píng)審確認(rèn)版本2.3.2.源代碼的存放開(kāi)發(fā)人員測(cè)試人員開(kāi)發(fā)人員測(cè)試人員配置管理人員源代碼入庫(kù)從SVN提取代碼編譯制作安裝程勛從SVN上提取代碼系統(tǒng)測(cè)試打印測(cè)試本不通過(guò)通過(guò)修改源代碼入庫(kù)安裝程源代碼測(cè)試報(bào)評(píng)審報(bào)更新版本2.3.3.L的語(yǔ)句存放各子系統(tǒng)SQL文件放入…..\. \SQL下對(duì)于不同的數(shù)據(jù)庫(kù)分別建立不同的子目錄如MSSORC2等公共SQL文件直接放入…下即可，不同數(shù)據(jù)庫(kù)的特殊SQL分別放入對(duì)應(yīng)的子目錄下。2.3.4.發(fā)行文檔的存放發(fā)行文檔是指產(chǎn)品交付用戶使用所必須的文件包括產(chǎn)品可執(zhí)行文件用戶使用說(shuō)明書(shū)聯(lián)機(jī)幫（P資源文（PO等環(huán)境配置文件等。2.4.配置管理流程研發(fā)人員研發(fā)人員項(xiàng)目管理人員測(cè)試人員配置管理人員完成開(kāi)發(fā)任務(wù)提交測(cè)試任務(wù)更新測(cè)試環(huán)境測(cè)試計(jì)測(cè)試用處BUG測(cè)試執(zhí)行回歸測(cè)試提交發(fā)布請(qǐng)求提交測(cè)試報(bào)告額定版本信制作安裝程新版本發(fā)布入提交測(cè)試部發(fā)布文檔更新流程說(shuō)明：1.開(kāi)發(fā)人員完成所負(fù)責(zé)代碼模塊的編寫(xiě)任務(wù)后，提交到項(xiàng)目經(jīng)理處；2.項(xiàng)目經(jīng)理向測(cè)試部提交測(cè)試任務(wù)；3.配置管理員準(zhǔn)備測(cè)試所需環(huán)境；4.測(cè)試員開(kāi)始測(cè)試并提供實(shí)時(shí)測(cè)試；5.開(kāi)發(fā)人員處理測(cè)試人員提供的，并提交測(cè)試員進(jìn)行回歸測(cè)試，直至關(guān)閉；6.測(cè)試完成后，測(cè)試人員提供測(cè)試報(bào)告；7.根據(jù)項(xiàng)目情況決定是否發(fā)布新版本；8.配置管理員與各成員確定好新版本的各項(xiàng)信息；9.配置管理員發(fā)布新版本。2.5.權(quán)限控制的管理不同的訪問(wèn)權(quán)限。文檔權(quán)限類(lèi)別：只讀權(quán)限，讀寫(xiě)權(quán)限文檔類(lèi)別：C，SRD，E。用戶類(lèi)別：開(kāi)發(fā)人員、測(cè)試人員、分析設(shè)計(jì)人員、部門(mén)經(jīng)理、配置管理員安裝盤(pán)制作人員、問(wèn)題及需求管理人員、用戶文檔編寫(xiě)人員等。不同的配置項(xiàng)所在目錄分配不同的權(quán)限。為了便于各部門(mén)的管理，應(yīng)以表格的形式列出人員與管理對(duì)象的訪問(wèn)關(guān)系（用戶權(quán)限清單。3.更新管理3.1.源程序的修改變更申請(qǐng)人變更申請(qǐng)人評(píng)審人員開(kāi)發(fā)人員測(cè)試人員配置管理人員提交變更變更影響分審核變更實(shí)施代碼測(cè)試取消變更測(cè)試報(bào)評(píng)審更新版本歸檔入庫(kù)當(dāng)開(kāi)發(fā)小組在開(kāi)發(fā)同一產(chǎn)品時(shí)，應(yīng)能保障：各成員間的修改不會(huì)互相覆蓋程序員的修改能及時(shí)反映到產(chǎn)品的最新版本中。建議首先在相應(yīng)子系統(tǒng)的下一級(jí)建一目錄，如t，存放正在修改的文檔及修改登記表。當(dāng)某個(gè)程序員要修改某一文檔時(shí)，遵循以下程序：1)接收維護(hù)任務(wù)；2)查看需要修改的文（如PBL及SQL等是否正在被其它人員修（檢查t目錄下是否存在要修改的文件或后綴已改為該程序員姓名簡(jiǎn)寫(xiě)；3)如果有人在修改該文件，等待或與相應(yīng)的開(kāi)發(fā)員聯(lián)系，重復(fù)2。否則繼續(xù)；4)將該文件復(fù)制到checkout目錄下，在修改登記表中登記；或?qū)⒃撐募缶Y改為本人姓名簡(jiǎn)寫(xiě)；5)將該文件拷貝到自己的私有目錄；6)根據(jù)要求修改源文件；7)根據(jù)要求測(cè)試，并進(jìn)行相關(guān)項(xiàng)的回歸測(cè)試；8)交測(cè)試人員測(cè)試，如未通過(guò)，重復(fù)6，如通過(guò)則繼續(xù)；9)在t目錄中刪除該文件，并在修改登記表中標(biāo)注修改完成；10)將修改完畢的文件通過(guò)電子郵件或其它手段送交版本管理員，版本管理員將文件復(fù)制到相應(yīng)的路徑；如遇特殊情況（版本管理員出差，程序員可將修改完畢的文件復(fù)制到相應(yīng)的路徑下，或?qū)⒑缶Y改回正式。11)回復(fù)下達(dá)者，報(bào)告維護(hù)任務(wù)完成。3.2.版本升級(jí)3.2.1.版本升級(jí)原則版本升級(jí)應(yīng)嚴(yán)格納入版本管理的控制之下。應(yīng)當(dāng)謹(jǐn)慎地控制版本的版本升級(jí)應(yīng)嚴(yán)格納入版本管理的控制之下。應(yīng)當(dāng)謹(jǐn)慎地控制版本的升級(jí)，保障高版本的向下兼容性，或提供嚴(yán)格定義的升級(jí)方法。主版本號(hào)(1：當(dāng)功能模塊有較大的變動(dòng)，比如增加多個(gè)模塊或者整體架發(fā)生變化。此版本號(hào)由項(xiàng)目決定是否修改。子版本號(hào)(1：當(dāng)功能有一定的增加或變化，比如增加了對(duì)權(quán)限控制、增自定義視圖等功能。此版本號(hào)由項(xiàng)目決定是否修改。階段版本號(hào)(1：一般是g修復(fù)或是一些小的變動(dòng)，要經(jīng)常發(fā)布修訂版，時(shí)間間隔不限修復(fù)一個(gè)嚴(yán)重的bug即可發(fā)布一個(gè)修訂版此版本號(hào)由項(xiàng)目經(jīng)理決定是否修改。日期版本號(hào)(140606)用于記錄修改項(xiàng)目的當(dāng)前日期每天對(duì)項(xiàng)目的修改都需要更改日期版本號(hào)。此版本號(hào)由開(kāi)發(fā)人員決定是否修改。每次版本升級(jí)，要填寫(xiě)版本升級(jí)記錄表，記錄表樣例如下：主版本號(hào)子系統(tǒng) 子系統(tǒng)名稱(chēng) 版本發(fā)布每次版本升級(jí)，要填寫(xiě)版本升級(jí)記錄表，記錄表樣例如下：主版本號(hào)子系統(tǒng) 子系統(tǒng)名稱(chēng) 版本發(fā)布日期變更功能描述發(fā)布批準(zhǔn) 備注人人主版本號(hào)：記錄當(dāng)前發(fā)布的版本發(fā)布日期：該版本批準(zhǔn)發(fā)布的日期修改文件：版本修改記錄，版本修改日志3.2.2.新版本發(fā)布新版本的發(fā)布包括主版本號(hào)和次版本號(hào)的升級(jí)一般不包括內(nèi)部版本號(hào)的級(jí)。流程如下：1) 接收新版本發(fā)布任務(wù)，接收本次發(fā)布的版本代號(hào)。2) 在指定目錄中根據(jù)本次發(fā)布的版本號(hào)建立相應(yīng)的子目錄將t下的所有內(nèi)容拷貝至新建目錄下。3) 可在新建目錄下建立readme.txt3.3.文檔的變更變更申請(qǐng)人變更申請(qǐng)人評(píng)審人員文檔編寫(xiě)人員配置管理員提交變更變更影響分析及審批通過(guò)變更實(shí)施不通過(guò)取消變更不通過(guò)文檔評(píng)審?fù)ㄟ^(guò)更新版本4.備份管理為了保證文檔的最大可恢復(fù)性，要隨時(shí)及定期地進(jìn)行備份工作。1) 隨時(shí)備份：①開(kāi)發(fā)人員每天都要將自已當(dāng)日修改的源文件在本