1、精選優質文檔-傾情為你奉上專心-專注-專業軟件版本管理規范系統軟件開發部2011-9-20精選優質文檔-傾情為你奉上專心-專注-專業目錄1引言 .21.1目的.21.2范圍.31.3術語定義.31.4版序控制記錄.31.5版本更新記錄.42版本管理 .42.1流程圖.42.2版本命名.52.3版本升級.52.3.1版本升級原則.52.3.2新版本的發布.62.4目錄結構.62.5文檔的存放.72.5.1文本文件的存放.72.5.2源代碼的存放.72.5.3發行文檔的存放.72.6權限控制管理.83備份管理 .83.1源文件備份.83.2庫文件備份.84用戶版本管理 .95版本工具的使用 .95

2、.1配置管理工具.95.2CVS 的使用 .105.2.1常用命令.105.2.2簡單操作.105.2.3版本分支管理.10精選優質文檔-傾情為你奉上專心-專注-專業1 引言1.1 目的本文檔是為規范信息科技中心軟件版本管理而制定的。1.2 范圍本文檔為系統軟件開發管理部版本管理員提供有關版本管理規范的相關內容，包括：版本標識方法軟件系統數據的存放文檔的修改控制文檔的備份制度1.3 術語定義CVSCVSCVS是一個開源的版本控制系統Concurrent Versions System的簡稱文檔文檔一種數據媒體和其上所記錄的數據。配置管理配置管理標識和確定系統中配置項的過程，在系統整個生存周期內

3、控制這些項的投放和更動，記錄并報告配置的狀態和更動要求，驗證配置項的完整性和正確性。軟件配置軟件配置軟件的具體形態在某時刻的瞬時影像。配置項配置項 軟件配置管理的對象稱為配置項，如：系統規格說明書，項目開發計劃，用戶手冊，源碼?；€基線 軟件生存周期中各開發階段末尾的標記，它的作用是把各階段工作的劃分更加明確化，使本來連續的工作在這些點上斷開，使之便于檢驗和肯定階段成果。精選優質文檔-傾情為你奉上專心-專注-專業1.4 版序控制記錄版序狀態擬稿審核批準發布日期1.0系統軟件開發部1.5 版本更新記錄*A - 增加 M - 修改 D - 刪除版本/修訂版修改頁碼修改記錄修改人日期1.0初始版本2

4、 版本管理2.1 流程圖2.1.1文檔歸檔流程文檔編寫人員評審人員配置管理員2.1.2文檔變更流程編寫文檔修改文檔格式規范化檢查 打評審版本文檔評審 確定版本（歸檔入庫）通過不通過精選優質文檔-傾情為你奉上專心-專注-專業變更申請人評審人員文檔編寫人員配置管理員2.1.3代碼歸檔流程開發人員測試人員配置管理員2.1.4代碼變更流程提交變更變更影響分析及審批變更實施取消變更更新版本（歸檔入庫）文檔評審通過通過不通過不通過源代碼入庫從 CVS 庫提取源代碼進行編譯制作安裝程序打測試版本系統測試從 CVS 庫提取源代碼修改源代碼入庫：安裝程序源代碼測試報告評審報告更新版本通過不通過精選優質文檔-傾情

5、為你奉上專心-專注-專業變更申請人評審人員開發人員測試人員配置管理員2.1.5配置管理流程流程說明：1、開發人員完成所負責模塊的代碼編寫任務后，提交到項目經理處2、項目經理向測試部門提交測試任務3、配置管理員準備測試所需的環境4、測試人員開展測試并實時提交 BUG5、開發人員處理測試過程中所出現的 BUG，并提交給測試人員進行回歸測試，直至 BUG 被關閉6、測試基本完成后，測試人員提交測試報告7、項目情況根據實際情況決定是否發布新的版本8、配置管理員與各相關人員經討論后確定好新版本各項信息9、配置管理員發布新版本開發人員項目管理人員測試人員配置管理員完成開發任務提交測試任務更新測試環境提交發

6、布請求提交測試報告確定版本信息制做安裝程序處理 BUG新版本發布入庫輸出給市場部發布文檔更新測試執行提交變更取消變更變更影響分析及審批變更實施代碼測試測試報告評審通過更新版本（歸檔入庫）不通過不通過通過測試計劃、用例回歸測試精選優質文檔-傾情為你奉上專心-專注-專業2.2 軟件版本命名軟件版本號由四部分組成，第一個 1 為主版本號，第二個 1 為子版本號，第三個 1為階段版本號，第四部分為日期版本號加希臘字母版本號，希臘字母版本號共有 5 種，分別為：Alpha、Beta、RC、Release。例如：1.1.1._Beta。對于小項目或子系統而言，可簡化為.，如 1.0.0。* 主版本號：當功

7、能模塊有較大的變動，比如增加多個模塊或者整體架構發生變化。此版本號由項目決定是否修改。* 子版本號：當功能有一定的增加或變化，比如增加了對權限控制、增加自定義視圖等功能。此版本號由項目決定是否修改。* 階段版本號：一般是 Bug 修復或是一些小的變動，要經常發布修訂版，時間間隔不限，修復一個嚴重的 Bug 即可發布一個修訂版。此版本號由項目經理決定是否修改。* 日期版本號用于記錄修改項目的當前日期，每天對項目的修改都需要更改日期版本號。此版本號由開發人員決定是否修改。* Alpha 版: 此版本表示該軟件在此階段主要是以實現軟件功能為主，通常只在軟件開發者內部交流，一般而言，該版本軟件的 Bu

8、g 較多，需要繼續修改。* Beta 版: 該版本相對于 版已有了很大的改進，消除了嚴重的錯誤，但還是存在著一些缺陷，需要經過多次測試來進一步消除，此版本主要的修改對像是軟件的UI。* RC 版: 該版本已經相當成熟了，基本上不存在導致錯誤的 BUG，與即將發行的正式版相差無幾。* Release 版: 該版本意味“最終版本” ，在前面版本的一系列測試版之后，終歸會有一個正式版本，是最終交付用戶使用的一個版本。該版本有時也稱為標準版。一般情況下，Release 不會以單詞形式出現在軟件封面上，取而代之的是符號(R)。2.3 版本升級2.3.1版本升級原則版本升級應嚴格納入版本管理的控制之下。應

9、當謹慎地控制版本的升級，保障高版本的向下兼容性，或提供嚴格定義的升級方法。在下面幾種情況下，進行版本演化和升級：1、當產品發生重大修改和改進時，主版本號加 1。重大修改和改進包括：1）平臺遷移；2）開發工具的遷移；3）體系結構的變遷。2、當產品發生較小的改進或修改時，次版本號可以加 1。精選優質文檔-傾情為你奉上專心-專注-專業3、對于改動量比較少的，如修改產品的錯誤，可升級修訂版本號。4、記錄版本升級過程。每次版本升級，都要填寫版本升級記錄表，記錄表樣例如下：版本升級記錄表主版本子系統名稱子系統版本發布日期功能變更描述發布責任人批準人備注說明：版本號： 記錄當前發布的版本。發布日期：該版本批

10、準發布的日期。修改文件：版本修改記錄文件，一般為版本修改日志。2.3.2新版本的發布新版本的發布包括主版本號和次版本號的升級，一般不包括內部版本號的升級。流程如下：1、根據項目進展情況，或者根據用戶需要進行發布準備。2、將發布所需文件進行打包，放在指定目錄中，給目錄加上標簽 Tag，標簽中包含將要發布的版本信息。3、同樣對源碼文件也要加上與版本信息相關的標簽 Tag。標簽 Tag 命名規則如下：組成：模塊首字母+下劃線+文件類型+下劃線+主版本號+次版本號+內部版本號+時間（+下劃線+合并標記）樣例：qzcj_src_1_0_0_，qzcj 表示采集模塊的首字母，src 表示源碼，1_0_0

11、表示將要發布的版本號，合并標記可省略，只在有合并操作時注明，其中合并前的標記為 mbe， 合并后的標記為 maf。2.4 目錄結構但為了能更好地管理各項目組的文檔，建議可將被管理的配置項分為三大類：文檔類、源碼類及安裝盤類，這樣存放比較清晰，有利于版本管理，現將目錄結構整理如下：根目錄一級目錄二級目錄對應配置項備注resp前置采集源碼精選優質文檔-傾情為你奉上專心-專注-專業后臺計算源碼業務應用源碼數據庫SQL 文件業務支撐源碼code公用開發包需求文檔立項報告、需求分析、需求記錄設計文檔軟件架構、總體設計、概要設計、詳細設計、界面設計數據庫文檔數據字典、數據庫搭建、備份還原方案、PDM 設計

12、測試文檔測試計劃、測試用例、測試報告用戶文檔用戶手冊、產品說明計劃文檔項目計劃、年度月度計劃外部接口文檔文檔doc標準規范SETUPreleaserar 文件發布文件發布文檔二級目錄中的版本指一些特殊的版本，不影響基線版本。2.5 文檔的存放2.5.1文本文件的存放根據各項目部自己的情況，將系統用戶需求記錄、總體設計文檔、詳細設計及數據結構文件、測試記錄、用戶手冊等放入 CVS 倉庫 doc 目錄相應的子目錄下。2.5.2源代碼的存放源代碼包括如：java，jsp，BMP，ICO 等相關文件，是未經編譯處理的、不能直接交付使用的產品文件以及編譯產品所需的文件；聯機幫助文件 HLP 在未生成 H

13、LP 文件之前的 DOC，RTF 等格式的文檔也視為源代碼。各子系統當前的程序源文件放入 CVS 倉庫 code 目錄相應的 bb 目錄下，對于一個子系統又分多個分子系統的情況，應在該目錄下分別建立幾個相應的子目錄。精選優質文檔-傾情為你奉上專心-專注-專業2.5.3發行文檔的存放發行文檔是指產品交付用戶使用所必須的文件。包括：產品可執行文件，用戶使用說明書，聯機幫助（HLP） ；資源文件（BMP，ICO 等） ，環境配置文件等。以上文檔作為制作發行盤的素材，放在 CVS 倉庫發布文件目錄的 Release 目錄之下，制作好的發行盤放在發布文件的 Setup 目錄。2.6 權限控制管理為保障文

14、檔的安全性，一致性，以及防止意外修改，必須對不同的文檔設置不同的訪問權限。文檔權限類別：無任何權限，只讀權限，所有權限。文檔類別：設計文檔，源碼，發行文檔。用戶類別：開發人員、測試人員、項目經理、配置管理員等。為了控制不同的使用權限，根據要求在服務器上分別建立不同的用戶，針對不同的配置項所在目錄分配不同的權限。為了便于管理，應以表格的形式列出人員與管理對象的訪問關系（用戶權限清單） ，詳見系統部 CVS 權限配置 。3 備份管理為了保證文檔的最大可恢復性，要隨時及定期地進行備份工作。3.1 源文件備份開發人員每天都要將自已當日修改的源文件提交（commit）至 CVS 倉庫。3.2 庫文件備份

15、為防止服務器出現異常，需對服務器上的 CVS 倉庫文件進行備份，目前采用的方案如下：工作日備份：每個工作日將原本位于 D 盤的倉庫文件在 H 盤上備份一份，當 D 盤倉庫出現異常時，用戶可把 ROOT 目錄修改至 H 盤備份的目錄，再進行更新操作。每周備份：每周五下班時將 H 盤備份文件異地備份至其它 IP（目前備份在192.168.53.68 上） 。每月備份：每個月底將最新版本備份至光盤。精選優質文檔-傾情為你奉上專心-專注-專業4 用戶版本管理為了更好地管理源程序，應為每一用戶建立一個用戶版本文件，該文件應包含以下內容：用戶編號：用戶名稱：軟件版本號：開始使用時間：聯系人：聯系電話：用戶

16、程序更改日志樣例如下：更改時間版本號修改模塊名稱變更原因變更概述軟件位置變更人員備注說明：1）用戶購買軟件時要為該用戶建立一個包含上述內容的一個用戶版本文件，并填寫有關數據。2）用戶進行版本更新時要求填寫該文件的版本變更記錄，用以反映用戶版本的變更情況。5 版本工具的使用5.1 配置管理工具開發部采用 CVS 進行配置管理，CVS 是一個 C/S 系統，多個開發人員通過一個中心版本控制系統來記錄，從而達到保證文件同步的目的。目前采用的 CVS 服務端為 cvsnt-2.5.03.2260，客戶端為 TortoiseCVS-1.8.29。精選優質文檔-傾情為你奉上專心-專注-專業5.2 CVS

17、的使用5.2.1常用命令英文命令中文命令操作、說明備注Checkout提取/取出將文件下載到本地目錄第一次下載目錄用Commit提交將改動過的文件提交到版本庫每次對文件更新后使用Update更新將文件同步到最新版本獲取最新版本Tag標簽給某個版本添加一個標記符號便于合并分支與主線Branch分支創建某個文件的分支建立特殊版本時用到Merge合并將分支文件（或主文件）的更改合并到主文件（或分支文件）diff比較不同比較任意兩個版本間的不同ReversionGraph版本分支圖查看文件各版本（包括分支文件）的走向圖查詢各個版本及 TagHistory歷史查看文件各個版本更新歷史查詢版本詳細信息5.

18、2.2簡單操作文件提?。撼醮问褂眯鑼⒃次募膫}庫提取出來，執行 checkout 命令將庫文件提取至本地相應位置。定時更新：開發人員每天早上對源代碼或文件進行更新操作（右鍵執行 update 操作） 。實時更新：某一開發人員提交更改后，可通知其它人員進行更新操作。實時提交：對某一文件進行更改完成后，執行 commit 命令將更改提交至倉庫，更改前先進行更新操作，如多個人員對同一文件同時進行操作，會產生沖突，這時需要對沖突進行處理。沖突處理：提交產生沖突時，先對文件進行同步（即更新）操作，之后會產生一個合并文件，前為當前服務器最新版本修改的內容，找到最近提交該文件的同事，進行協商后對源文件進行修

19、改并提交。創建分支/標簽：右鍵菜單中選擇Branch或Tag找開創建對話框，輸入 Branch 名或Tag 名，選中Create new branch/Create new tag ，點擊 OK 即可。查看版本/歷史：文件（非文件夾）右健菜單中選擇Revision Graph.或History. ，可查看該文件的版本更新記錄或歷史信息。5.2.3版本分支管理我們把一個項目的主要開發過程稱作開發基線。當某一個特殊事件發生的時候，例如，有一個用戶有特殊的需求，于是就從這個開發基線里分離出來一個叉，以滿足用戶特殊的需求，這個叉有它自己的發展方向，這就是分支。精選優質文檔-傾情為你奉上專心-專注-專業-分支/-開發基線上面這個點，代表開發基線的最新版本，如果從開發基線建立分支來進行定