程序員編寫程序的過程中,每個程序都會有很多不同的版本,這就需要程序員很好的管理代碼,在需要的時間可以取出需要的版本,并且每個版本都有一個完整的說明。
我們使用Sub Version(簡稱SVN)作為版本管理工具。這里著重介紹SVN作為跨平臺的多人協作使用方法。在多個程序員管理同一段代碼的過程中,版本的管理顯得尤為重要,使用SVN可以方便的進行分支、合并,記錄下所有的版本。
基本配置
在開始某項軟件、文檔的開發與撰寫時,首先由配置管理負責人建立SVN倉庫、用戶名及其權限,并通知相關人員SVN倉庫地址、SVN倉庫負責人。
SVN倉庫的負責人把工程的tsvn:logminisize設置為1,以便強制注釋。設置方法:在你的工程文件夾右鍵->屬性中,進入Subversion標簽,選中tsvn: logminisize,確保復選框recursive選中,然后點擊Set按鈕把它的值設為1,其意思是指提交的注釋最短長度為一個字。如圖:
圖
2
.
1
軟件配置
l???????
忽略文件
在
SVN
的
[Setting]
的
[General]
中
,
設置需要忽略的文件以便忽略掉一些臨時的、無用的文件
,
常被忽略的文件有
*.opt *.ncb *.suo *.plg *.pch *.idb *.pdb *.scc *.obj Debug Release *.o *.bin *.out *.ilk *.aps debug release *.clw *.bak
。每個程序員可以根據自己的需要進行修改忽略文件,上面只是使用VC++與Tornado編程時常用的一些忽略文件。
圖
2
.
2
以上說的忽略文件是指全局的忽略文件。SVN還能在特定的目錄中指定需要忽略的文件。忽略文件支持通配符。
l???????
合并比較工具
在Merge Tool中可以選擇用來合并的工具,強烈推薦用Araxis Merge。在[Setting]->[Diff]中填入"C:\Program Files\Araxis\Araxis Merge v6.5\Merge.exe";在[Setting]->[Merge]的選項中,填入"C:\Program Files\Araxis\Araxis Merge v6.5\Merge.exe" %theirs %mine %merged ;其中"C:\Program Files\Araxis\Araxis Merge v6.5\Merge.exe"是指合并工具的路徑,%theirs %mine %merged分別指..將要合并到主干的分支,主干,及合并后的結果。
圖
2
.
3
倉庫目錄結構
SVN倉庫的負責人規劃好倉庫的目錄結構。推薦的目錄結構如下圖所示。
倉庫的一級目錄只有兩個,分別為code和doc。其中,doc主要用來放置先期的文檔,code主要用來放置工程的代碼,也可以包含后期的文檔。
倉庫的二級目錄只可以是branch與trunk兩個目錄,分別存放主干與分支。trunk目錄下直接存放工程文件。branch目錄下包括一些子目錄分別對應各個分支。
圖
2
.
4
從
SVN
倉庫中取出代碼時
,一定
不要把整個倉庫取出來
,
而應該只取出
trunk
目錄
,
或只取出
branch
下的某個分支目錄
(比
如上圖中的
svn:\\code\branch\xw_051206
)
。
一個項目會有多個人共同合作開發完成。基本流程是:
l???????
各開發成員建立自己的分支,并在此分支上開發;
l???????
各開發成員把分支合并到主干上并形成較為穩定的版本;
l???????
各個成員重新從主干上建立新的分支,在此分支上開發
(
即回到第一步
)
l???????
循環往復,直到工程結束。
下面我用一個例子來說明合作開發的基本流程。
現在xb與lzj兩個開發人員要共同開發一個工程onlytest,其這個工程的主干的SVN倉庫地址如下圖。
圖
2
.
5
xb與lzj分別在onlytest這個工程中建立兩個分支,分別為xb _051115和lz_051115。
在這里分支命名要采用[姓名縮寫_6個數的日期_后綴(可選)]的形式,比如xb_051208_1,xb_051212之類的。創建完分支后我們可以看到這個工程的目錄結構如下圖所示:
圖
2
.
6
分支目錄
建完之后, xb和lzj分別在本地取出對應的分支進行開發。
當
程序到達一個比較穩定的階段,就需要把分支合并到主干上,下面講述一下合并的流程。
在本節中繼續使用上一節中所示的工程與SVN倉庫講解。
1.2.3.1
xb
與
lzj
分別修改自己分支上的代碼
現在
,
主干上的
test_SVN.txt
是空文檔。
由
xb
與
lzj
修改提交后
,
兩個分支中
test_SVN.txt
分別如下兩圖所示
:
圖
2
.
7
xb_051129
分支下的
test_SVN.txt
圖
2
.
8
lzj_051129
分支下的
test_SVN.txt
1.2.3.2
xb
將
xb_051129
分支合并到主干
xb
先把主干
check out
到本地。然后在主干的目錄上右鍵
選擇svn->merge,彈出如下窗口:
圖
2
.
9
合并對話框
此對話框的含義是把From指定的分支版本到To指定的分支版本之間的差異合并到主干上。
在這里分支選的是xb_051129。版本號的選定方法是點擊From中的Show Log,在Log窗口中按住Ctrl鍵,點擊選擇”made a copy”之上的那個版本,以及最頂上的那個版本,如圖2.11所示。然后點擊確定回到上圖中的對話框,會自動填寫From與To中的Revision號。
2
.
10
選擇需要合并的版本
然后直接點擊merge進行合并,你也可以通過dry run來看是不是兩者之間有差異。由于沒有其它人修改主干,所以合并的很順利,下圖是xb_051115與主干合并后的結果。合并完畢之后,由xb對主干進行提交。
圖
2
.
11
合并后,主干上的
test_SVN.txt
?
1.2.3.3
lzj
將
lzj_051129
分支合并到主干,解決沖突
xb合并完畢之后,lzj要將他的分支合并到主干上去,方法同上。但是由于xb已經修改過主干,所以產生了沖突,會彈出一個沖突對話框。雙擊對話框中的產生沖突的文件名,就可以調出工具對此文件進行合并,下圖是我們用merge工具顯示的界面。
圖
2
.
12
l???????
首先比較第一個窗口與第二個窗口,把結果修改合并到第二個窗口。
l???????
然后確保光標處于第二個窗口時,點擊上圖中紅色圈圈所示的按鈕。這樣會把第二個窗口的內容全部復制到第三個容口。之后保存,退出。
l???????
然后在工程目錄上點右鍵,進行SVN->Resolved。這樣會刪除無用的臨時文件。
l???????
最后提交所作的修改,并添加詳細的注釋。
中的標簽
與CVS不同,使用SVN時不用專門為目錄添加標簽,因為SVN也對目錄進行版本管理。
我們在提交時寫好注釋(比如重要的版本提交時使用
051201
之類的日期作為開頭),就可以通過注釋來查找比較重要的目錄版本號,相當于
CVS
或
VSS
中的標簽。
另外,每個工程都會有一個版本說明文件,通過此文件可以查找關鍵版本。
你可以重命名、移動或刪除你的文件或文件夾,但請使用SVN進行這些操作,否則之前的版本信息會丟失。
使用SVN刪除、移動與重命名文件夾的方法是在文件/文件夾上點右鍵進行SVN操作,或直接在資源瀏覽器中使用右鍵拖放(會彈出SVN選項)。
文件的刪除、移動與重命名之前,必須保證工作目錄是最新的版本;進行這些操作之后,需要進行提交。
1.3.3
版本的回退
在代碼的編寫過程中,難免會有不盡人意的地方,你也許需要回退到某一個版本,但是在這個過程中可能有一些文件你想保留,也有一些文件你不想保留,這就牽扯到很復雜的版本管理過程,在這里給大家推薦幾種方法。
1.???????
若是你編輯了工程,在沒有提交的前提下,你想放棄這些修改,你可以直接選擇
revert
就可以更新到工程的最新的版本。
2.???????
若是你想退回到某一個版本,你就可以直接選擇
update to reversion
如圖
,
這樣我們就可以把我們的版本回退到你選中的版本去,這種情況下
SVN
并沒有顯示出有什么沖突,并且新建立的文件也還在,但是在這種情況下你并不能直接在你回退后的版本上進行編輯,因為
SVN
的版本控制還是在最新的主干上。我們需要
update
并解決沖突。
3.???????
你可以直接選擇
revert changes from this revision
如圖,這樣的話你可以直接解決沖突并提交。不過這種方法的不足是,你新建的文件都沒有了,整個工程都回退到之前的版本了。
4.???????
我推薦的一種方法是,直接
export
一個你需要的版本,然后用你
export
的版本覆蓋你的最新的版本,這樣你就可以不丟失你新建的文件,同時獲得
head
的
SVN
控制文件。
圖
13
?
每個工程會有很多個小模塊,當某個模塊達到穩定的時候,你就需要提交一次,以免寫下個模塊代碼的時候出現不可恢復的錯誤。
每一次提交需要前,需要通過pclint檢查,保證是一個編譯沒有錯誤的版本。當提交比較穩定的版本的時候,同時要修改你的版本號。
1.3.5
版本說明文件
版本說明文件為xml表格,可用excel編輯,它會記錄下關鍵的版本信息。
版本說明文件內容如下表。發布版本是指用戶對外公布的版本號,后文中有詳細描述;Revision是SVN內部的工程文件夾的版本號。一個發布版本可能對應多個Revision:
發布版本
|
Revision
|
詳細說明
|
1,0,0,12
|
76
|
加入了抗干擾日志,需長時間測試
程序代碼進行了重構,已經調試通過
|
77
|
xxx @#$%^&
|
78
|
啥...
|
1,0,0,13
|
81
|
測試過的穩定版本
|
1,0,0,14
|
99
|
fix some bug,沒有測試
|
?
|
?
|
?
|
?