SVN客戶端使用手冊(cè)

1、SVN客戶端使用手冊(cè)200708231 文檔目的本手冊(cè)意在說明在日常工作或軟件開發(fā)過程中，如何使用SVN來進(jìn)行文檔版本的控制及與他們協(xié)同工作。2 目標(biāo)讀者IT軟件開發(fā)部全體員工參與IT軟件開發(fā)部所負(fù)責(zé)項(xiàng)目的其他人員3 模擬環(huán)境現(xiàn)假設(shè)有一項(xiàng)目名為：test服務(wù)端版本庫(kù)：testtest開發(fā)人員：devA，devBtest有子目錄public和private兩個(gè)子目錄并分別有doc、soc和deva、devb兩個(gè)子目錄，即版本庫(kù)目錄結(jié)構(gòu)： test public（公共目錄） private（私人目錄） doc soc deva devb4 基本操作4.1 安裝客戶端下載TortoiseSVN-安裝

2、程序，雙擊直接安裝即可。安裝成功后，在桌面空白處單擊鼠標(biāo)右鍵，彈出右鍵菜單會(huì)多出兩個(gè)選項(xiàng)，分別是SVN checkout和Tortoise SVN。如下圖：4.2 建立工作區(qū)在項(xiàng)目或某項(xiàng)工作開始之前，需首先在本地硬盤上創(chuàng)建一個(gè)工作目錄，工作目錄的名稱隨意，此處用workspace。4.3 下載版本庫(kù)現(xiàn)假設(shè)devA具有test項(xiàng)目的所有權(quán)限，則他就可將本地的workspace目錄配置為與test目錄匹配，具體做法是：在workspace文件夾上，單擊鼠標(biāo)右鍵。選擇SVN checkout，會(huì)出現(xiàn)如下窗口圖 1在URL of repository中輸入版本庫(kù)地址，test，在Checkout di

3、rectory中系統(tǒng)會(huì)自動(dòng)添加第二步所創(chuàng)建的工作區(qū)目錄。在Revision中，選中HEAD revision，這樣將會(huì)下載到版本庫(kù)的最新版本。如果想下載庫(kù)中的舊版本文件，可選中Revision，然后填入版本號(hào)即可。如果不想下載整個(gè)版本庫(kù)，而是只想下載自己負(fù)責(zé)的那部分模塊，可以在URL后添加模塊名，例如test/private/deva。單擊OK。如果有彈出窗要求輸入用戶名和密碼，請(qǐng)輸入SVN管理員提供的您的用戶名與密碼。若假設(shè)devB只具有該項(xiàng)目下的public(公共目錄)下的所有權(quán)限以及private/devB下的所有權(quán)限，則應(yīng)在第二步中的workspace下再創(chuàng)建兩個(gè)子目錄public和d

4、evb，因此，workspace/public與test/public匹配workspace/private/devb與test/private/devb匹配只要分別做一次“SVN Checkout”即可。如圖： 上述操作若執(zhí)行正確，則與SVN匹配的目錄上會(huì)有綠色的勾出現(xiàn)。如：或，其下的文件或子目錄也會(huì)帶有綠色的勾。同時(shí)，若再次在該目錄上再次單擊鼠標(biāo)右鍵，會(huì)發(fā)現(xiàn)右鍵菜單已發(fā)生變化，“SVN Checkout”選項(xiàng)消失了，并多出了“SVN Update”和“SVN Commit”選項(xiàng)。如圖：4.4 提交工作結(jié)果如果對(duì)本地工作目錄中的某一個(gè)文件進(jìn)行了修改，系統(tǒng)會(huì)自動(dòng)為這個(gè)文件和這個(gè)文件所在的各級(jí)父

5、文件夾加上紅色嘆號(hào)，代表該文件或目錄已經(jīng)在本地被修改，如圖當(dāng)所有對(duì)版本庫(kù)的修改操作完畢后，右鍵單擊工作區(qū)文件夾，選擇“SVN Commit”提交新版本，輸入密碼后系統(tǒng)將把修改后的版本庫(kù)上傳到服務(wù)端，即完成一次對(duì)版本庫(kù)的更新。提交后，紅色感嘆號(hào)會(huì)恢復(fù)成綠色的勾。切記：新版本提交之后，其他擁有寫權(quán)限的用戶也許會(huì)重復(fù)以上幾步的操作，完成對(duì)版本庫(kù)的再一次更新。所以，每次在工作區(qū)文件夾下修改本地版本庫(kù)之前，必須首先對(duì)本地版本庫(kù)執(zhí)行一次更新（右鍵單擊工作區(qū)，選擇“SVN Update”），將最新的版本下載到本地，然后再進(jìn)行修改操作。5 高級(jí)操作在日常的軟件開發(fā)過程中，除了以上介紹的下載，提交，更新操作外，

6、還有另外幾種常用操作。5.1 比較文件的不同之處 當(dāng)對(duì)文件做了修改之后，文件會(huì)出現(xiàn)紅色嘆號(hào)，表示已經(jīng)修改，如果想查看修改后的文件與修改前有何不同，可以右鍵單擊此文件，選擇Diff，如圖：對(duì)于一般文本文件（比如JAVA源程序），系統(tǒng)會(huì)彈出一個(gè)窗口，窗口分為兩個(gè)部分，左邊為更改之前的版本，右邊為更改之后的版本，并在不同之處作出標(biāo)記和說明。如圖：如果是word文檔的話，選擇Diff之后，系統(tǒng)會(huì)打開一個(gè)word文檔，并在其中以Word修訂的形式標(biāo)出修改后的版本與修改前有何不同。如圖：5.2 查看日志 如果想查看一個(gè)文件的日志，右鍵單擊這個(gè)文件，選擇show log，系統(tǒng)會(huì)彈出一個(gè)窗口，并在窗口中顯示該

7、文件的各個(gè)版本的log。5.3 查看版本樹 如果想查看文件的版本樹，右鍵單擊該文件，選擇Revision graph，系統(tǒng)將會(huì)打開一個(gè)窗口，并在窗口中顯示該文件的版本樹。如圖：圖6 5.4 下載某個(gè)文件的舊版本 如果想要得到某個(gè)文件的舊版本，只需在該文件上單擊右鍵，選擇Updata to revision即可。系統(tǒng)會(huì)提示輸入版本號(hào)。例如要下載上述文檔的1479版本，只需填入1479即可。如下圖。查看完版本1479的內(nèi)容后，如果想再次回到最新版本，只需要對(duì)該文檔執(zhí)行“SVN Update”即可。5.5 重名名和刪除文件 如果要?jiǎng)h除一個(gè)文件或重名名一個(gè)文件，注意：不要在windows下直接操作。只

8、需右鍵單擊該文件，選擇SVN菜單的Rename或Delete，SVN系統(tǒng)便會(huì)完成操作。 在workspace中將文件重命名或刪除后，服務(wù)端的文件結(jié)構(gòu)不會(huì)變化，只有當(dāng)提交新版本庫(kù)后，即執(zhí)行“SVN Commit”后，服務(wù)端的文件結(jié)構(gòu)才會(huì)被更新。 如果誤刪除了文件，在沒有提交版本庫(kù)之前，可以通過在該目錄下空白處單擊鼠標(biāo)右鍵執(zhí)行“SVN Update”將文件重新下載到本地的工作目錄，也可以通過revert恢復(fù)（參考第八條）。如果文件刪除，并且已經(jīng)提交，那么要找回文件只能通過下載舊版本庫(kù)來完成，參考（4）。注意：在做任何恢復(fù)前，必須把本次已修改但不想恢復(fù)的文件先單獨(dú)做一次提交。5.6 創(chuàng)建分支 版本庫(kù)

9、中最初的文件都是主干文件。如果想要為某個(gè)文件創(chuàng)建一個(gè)分支，只需右鍵單擊，選擇Branch/Tag，系統(tǒng)會(huì)彈出一個(gè)窗口，在窗口中，F(xiàn)rom URL表示要?jiǎng)?chuàng)建的這個(gè)分支的原始文件（不能修改）。在To URL中，一定要更改一下文件名，如在文件名后加一個(gè)標(biāo)志即可，例如“_branch”，路徑不需要更改。在Creat copy in the repository from中，一般選第一個(gè)選項(xiàng)即可，即從數(shù)據(jù)庫(kù)中最新的版本復(fù)制。最后填寫日志，選擇OK。如圖：分支創(chuàng)建完畢，執(zhí)行“SVN Update”版本庫(kù)，系統(tǒng)會(huì)將主干文件和分支文件同時(shí)下載到本地目錄，然后即可在分支文件上進(jìn)行操作。5.7 合并分支當(dāng)需要把分

10、支文件合并到主干文件時(shí)，右鍵單擊主干文件，選擇Merge，會(huì)彈出一個(gè)窗口，如圖：在From輸入框中填入主干的URL，在To輸入框中填入分支的URL（之前要先把“Use From URL”的勾去掉）。在From和To中，都有兩個(gè)選項(xiàng)HEAD Revision和Revision，表示要進(jìn)行合并的是哪個(gè)版本，一般選HEAD Revision即可。合并之后主干文件會(huì)標(biāo)注紅色嘆號(hào)，表示已被修改，并可以提交。如果合并后文件標(biāo)注的是黃色感嘆號(hào)，表示文件有沖突，處理方法見第6章“異常處理”。5.8 撤銷修改當(dāng)對(duì)一個(gè)文件進(jìn)行了修改并保存后（注意此處并沒有進(jìn)行提交），如果對(duì)修改不滿意，想要重新修改，可以右鍵單擊修

11、改過的文件（帶紅色嘆號(hào)的那個(gè)），然后選擇revert，前面的一系列修改便會(huì)被撤銷，恢復(fù)到Update之后的狀態(tài)。如果一個(gè)文件被誤刪除，也可通過右鍵單擊該文件所在的目錄，選擇revert來恢復(fù)（注意，如此操作會(huì)影響到該目錄下的所有文件）。6 異常處理此處所說的異常主要是指文件發(fā)生沖突。以用戶devA和用戶devB為例，當(dāng)兩個(gè)用戶同時(shí)下載了最新的版本庫(kù)，并對(duì)庫(kù)中同一個(gè)文件test進(jìn)行修改提交時(shí)，首先提交的用戶devA不會(huì)發(fā)生異常，第二個(gè)提交的用戶devB便會(huì)出現(xiàn)無法提交的現(xiàn)象。因?yàn)榉?wù)端的版本庫(kù)已經(jīng)被devA更新，devB用戶在Commit時(shí)，系統(tǒng)會(huì)提示出錯(cuò)。出錯(cuò)信息如：Modified D:戴I

12、T部工作20070312：質(zhì)量控制功能區(qū)SVN使用workspacepublictest.txtErrorCommit failed(details follow):ErrorYour file or directory test.txt is probably out-of-dateErrorThe version resource does not correspond to the resource with the transaction. 在這種情況下，devB用戶需要首先對(duì)修改的文件進(jìn)行Update文件操作。如果兩個(gè)用戶修改了test.txt文件的同一個(gè)地方，則在devB用戶執(zhí)行Update后，系統(tǒng)會(huì)將本地的test.txt與從服務(wù)端下載test.txt合并到一個(gè)文件上，并在該文件圖標(biāo)上標(biāo)上黃色嘆號(hào)，表示文件出沖突。在文件中通過“<<<<<<”和“>>>>>>”標(biāo)識(shí)沖突位置和沖突內(nèi)容。devB用戶只有與devA協(xié)商，將該沖突手工處理，之后單擊右鍵，選擇Resolve，沖突標(biāo)記消除，才能夠再次提交，否則無法