SVN客戶端用戶使用手冊

1、SVN客戶端用戶使用手冊文章摘要：該該文檔將逐步教您如何在軟件開發(fā)過程中使用svn客戶端環(huán)境模擬現(xiàn)有項目名稱：test 服務(wù)端版本庫：test URL：0:81/svn 開發(fā)人員：devA，devB 版本庫目錄結(jié)構(gòu)： 一基本操作第一步：安裝客戶端到共享文件夾下，下載TortoiseSVN- 該文檔將逐步教您如何在軟件開發(fā)過程中使用svn客戶端環(huán)境模擬現(xiàn)有項目名稱：test服務(wù)端版本庫：testURL：0:81/svn開發(fā)人員：devA，devB版本庫目錄結(jié)構(gòu)： 圖片1一基本操作第一步：安裝客戶端到共享文件夾下，下載Tortoi

2、seSVN-501-win32-svn-1.4.0.msi安裝程序，雙擊直接安裝即可。安裝成功后，右鍵單擊鼠標會多出兩個選項，分別是SVN checkout和Tortoise SVN。第二步：建立工作區(qū)項目開始之前，在本地PC的硬盤上，創(chuàng)建一個文件夾，文件夾命名隨意（例如workspace），該文件夾即作為軟件開發(fā)者在項目開發(fā)過程中的工作區(qū)。 第三步：下載版本庫 假如現(xiàn)在開發(fā)一個項目，配置管理員會在服務(wù)端建立一個該項目的版本庫test在workspace文件夾上，右鍵單擊鼠標。選擇SVN checkout，會出現(xiàn)如下窗口 在URL of repository中輸入版本庫地址，ht

3、tp:/0:81/svn/test ，在Checkout dir中系統(tǒng)會自動添加第二步所創(chuàng)建的工作區(qū)目錄。在Revision中，選中HEAD revision，這樣將會下載到版本庫的最新版本。如果想下載庫中的舊版本文件，可選中Revision，然后填入版本號即可。如果不想下載整個版本庫，而是只想下載自己負責的那部分模塊，可以在URL后添加模塊名，例如0:81/svn/test/Doc 。單擊OK，輸入用戶名和密碼 第四步：修改版本庫對版本庫的修改包括修改文件內(nèi)容，添加刪除文件，添加刪除目錄。經(jīng)過第三步的操作，本地的工作區(qū)文件夾，即work

4、space上會有綠色對勾出現(xiàn)，工作區(qū)下的文件也會帶有綠色對勾，如圖2 如果對庫中某一個文件進行了修改，系統(tǒng)會自動為這個文件和這個文件所在的各級父文件夾加上紅色嘆號，代表該文件或目錄已經(jīng)在本地被修改，如圖3 圖3當所有對版本庫的修改操作完畢后，右鍵單擊工作區(qū)文件夾，選擇commit提交新版本，輸入密碼后系統(tǒng)將把修改后的版本庫上傳到服務(wù)端，即完成一次對版本庫的更新。注意：新版本提交之后，其他擁有寫權(quán)限的用戶也許會重復(fù)以上幾步的操作，完成對版本庫的再一次更新。所以，每次在工作區(qū)文件夾下修改本地版本庫之前，必須首先對本地版本庫執(zhí)行一次更新（右鍵單擊工作區(qū)，選擇SVN Updata），將最新的版本下載到

5、本地，然后再進行修改操作。二其他操作在日常的軟件開發(fā)過程中，除了以上介紹的下載，提交，更新操作外，還有另外幾種常用操作。（1）比較文件的不同之處當對soc_1做了修改之后，soc_1文件會出現(xiàn)紅色嘆號，表示已經(jīng)修改，如果想查看修改后的soc_1文件與修改前有何不同，可以右鍵單擊此文件，選擇diff，系統(tǒng)探出一個窗口，如圖3，窗口分為兩個部分，左邊為更改之前的版本，右邊為更改之后的版本。并在不同之處作出標記和說明。如圖4如果是word文檔的話，選擇diff之后，系統(tǒng)會打開一個word文檔，并在其中標出修改后的版本與修改前有何不同。如圖4.1（2）查看日志如果想查看一個文件的日志，例如soc_1，

6、右鍵單擊這個文件，選擇show log，系統(tǒng)會踏出一個窗口，并在窗口中顯示soc_1各個版本的log。（3）查看版本樹如果想查看soc_1文件的版本樹，右123鍵單擊該文件，選擇Revision graph，系統(tǒng)將會打開一個窗口，并在窗口中顯示該文件的版本樹。如圖6。 之所以只顯示了四個版本，是因為選擇了只顯示發(fā)生過變化的版本。即.7每一個版本都有不同的地方，都是經(jīng)過用戶修改后提交的。而2.3兩個版本是與版本1相同的。（4）下載某個文件的舊版本如果想要得到某個文件的舊版本，只需在該文件上單擊右鍵，選擇Updata to revision即可。系統(tǒng)會提示輸入版本號。例

7、如要下載soc_1的第五個版本，只需填入5即可。如圖7。查看完版本5的文件后，如果想在此回到最新版本，只需要對soc_1運行Updata即可。5）重名名和刪除文件如果要刪除一個文件或重名名一個文件，注意不要在windows下直接操作。只需右鍵單擊該文件，選擇Rename或Delete，svn系統(tǒng)便會完成操作。在workspace中將文件重命名或刪除后，服務(wù)端的文件結(jié)構(gòu)不會變化，只有當提交新版本庫后，即commit后，服務(wù)端的文件結(jié)構(gòu)才會被更新。如果誤刪除了文件，在沒有提交版本庫之前，可以通過對版本庫的升級將文件重新下載到本地的版本庫，也可以通過revert恢復(fù)（參考第八條）。如果文件刪除，并且

8、已經(jīng)提交，那么要找回文件只能通過下載舊版本庫來完成，參考（4）。（6）創(chuàng)建分支版本庫中最初的文件soc_1,soc_2,word_1,word_2都是主干文件。如果想要為soc_1創(chuàng)建一個分支，只需右鍵單擊soc_1，選擇Branch/Tag，系統(tǒng)會彈出一個窗口，如圖8。在窗口中，F(xiàn)rom URL表示要創(chuàng)建的這個分支是soc_1的分支（系統(tǒng)會自動添加，不必更改）。在To URL中，需要更改一下文件名，在文件名后加一個標志即可，例如“ _branch”，路徑不需要更改。在Creat copy in the repository from中，可以選擇分支文件是由soc_1的那一個版本拷貝來的。最后

9、填寫日志，選擇OK。分支創(chuàng)建完畢，Updata版本庫，系統(tǒng)會將soc_1的主干文件和分支文件soc_1_branch同時下載到本地版本庫，如圖8.1，然后即可在分支文件上進行操作。此時soc_1的版本樹如圖8.2（7）合并分支當需要把soc_1_branc分支文件合并到soc_1主干文件時，右鍵單擊soc_1，選擇Merge，會彈出一個窗口，如圖9。在 From輸入框中填入主干的URL，在To輸入框中填入分支的URL。在From和To中，都有兩個選項HEAD Revision和Revision，表示要進行合并的是soc_1的那個版本。合并之后主干文件會標注紅色嘆號，表示已被修改，并可以提交。如

10、果合并后文件標注的是黃色嘆號，表示文件有沖突，處理方法見第三部分“異常處理”。（8）撤銷修改當對一個文件進行了修改并保存后（注意此處并沒有進行提交），如果對修改不滿意，想要重新修改，可以右鍵單擊修改過的文件（帶紅色嘆號的那個），然后選擇revert，前面的一系列修改便會被撤銷，恢復(fù)到Updata之后的狀態(tài)。如果一個文件被誤刪除，也可通過右鍵單擊該文件所在的目錄，選擇revert來恢復(fù)。三異常處理此處所說的異常主要是指文件發(fā)生沖突。以用戶devA和用戶devB為例，當兩個用戶同時下載了最新的版本庫，并對庫中同一個文件soc_2進行修改提交時，首先提交的用戶devA不會發(fā)生異常，第二個提交的用戶

11、devB便會出現(xiàn)無法提交的現(xiàn)象。因為服務(wù)端的版本庫已經(jīng)被devA更新，devB用戶在上傳時，系統(tǒng)會提示出錯如圖10。圖片1在這種情況下，devB用戶需要首先對修改的文件進行Updata文件操作。如果兩個用戶修改了文件soc_2的同一個地方，則在devB用戶執(zhí)行Updata后，系統(tǒng)會將本地的soc_2與從服務(wù)端下載soc_2合并到一個文件上，并在該文件圖標上標上黃色嘆號，表示文件出沖突。在文件中通過“<<<<<<”和“>>>>>>”標識沖突位置和沖突內(nèi)容。devB用戶只有與devA協(xié)商，將該沖突處理，之后單擊右鍵，選擇Resolve，沖突標記消除，才能夠再次提交，否則無法提交。文件標記沖突的格式：<<<<<<< .mine workspsace工作區(qū)，等abc工作區(qū)提交結(jié)束后再提交，應(yīng)該會出現(xiàn)沖突 = 在此插入一段話，啊啊aaa，測試沖突>>>>>>>