Subversion操作手冊

1、附錄三 subversion操作手冊環(huán)境模擬現(xiàn)有項(xiàng)目名稱：test服務(wù)端版本庫：testurl：0:81/svn開發(fā)人員：deva，devb版本庫目錄結(jié)構(gòu)： test doc（word文檔） soc（源代碼） word_1 word_2 soc_1 sod_21 基本操作1.1 安裝客戶端下載tortoisesvn-3783-win32-svn-1.5.2.msi安裝程序，雙擊直接安裝即可。安裝成功后，右鍵單擊鼠標(biāo)會多出兩個選項(xiàng)，分別是svn checkout和tortoise svn。1.2 建立工作區(qū)項(xiàng)目開始之前，在本地pc的硬盤上，創(chuàng)建一個

2、文件夾，文件夾命名隨意（例如workspace），該文件夾即作為軟件開發(fā)者在項(xiàng)目開發(fā)過程中的工作區(qū)。1.3 下載版本庫 假如現(xiàn)在開發(fā)一個項(xiàng)目，配置管理員會在服務(wù)端建立一個該項(xiàng)目的版本庫test。在workspace文件夾上，右鍵單擊鼠標(biāo)。選擇svn checkout，會出現(xiàn)如下窗口圖 11.1.3-1在url of repository中輸入版本庫地址，0:81/svn/test ，在checkout dir中系統(tǒng)會自動添加第二步所創(chuàng)建的工作區(qū)目錄。在revision中，選中head revision，這樣將會下載到版本庫的最新版本。如果想下載庫中的舊版本文件

3、，可選中revision，然后填入版本號即可。如果不想下載整個版本庫，而是只想下載自己負(fù)責(zé)的那部分模塊，可以在url后添加模塊名，例如0:81/svn/test/doc 。單擊ok，輸入用戶名和密碼1.4 修改版本庫對版本庫的修改包括修改文件內(nèi)容，添加刪除文件，添加刪除目錄。經(jīng)過第三步的操作，本地的工作區(qū)文件夾，即workspace上會有綠色對勾出現(xiàn)，工作區(qū)下的文件也會帶有綠色對勾，如圖： 圖11.1.4-1如果對庫中某一個文件進(jìn)行了修改，系統(tǒng)會自動為這個文件和這個文件所在的各級父文件夾加上紅色嘆號，代表該文件或目錄已經(jīng)在本地被修改，如圖：圖11.1.4-2當(dāng)

4、所有對版本庫的修改操作完畢后，右鍵單擊工作區(qū)文件夾，選擇commit提交新版本，輸入密碼后系統(tǒng)將把修改后的版本庫上傳到服務(wù)端，即完成一次對版本庫的更新。 注意：新版本提交之后，其他擁有寫權(quán)限的用戶也許會重復(fù)以上幾步的操作，完成對版本庫的再一次更新。所以，每次在工作區(qū)文件夾下修改本地版本庫之前，必須首先對本地版本庫執(zhí)行一次更新（右鍵單擊工作區(qū)，選擇svn update），將最新的版本下載到本地，然后再進(jìn)行修改操作。2 其他操作在日常的軟件開發(fā)過程中，除了以上介紹的下載，提交，更新操作外，還有另外幾種常用操作。2.1 強(qiáng)制日志填寫代碼提交時必須寫明注釋以便追蹤問題及合并，可使用工具在客戶端強(qiáng)制添加

5、注釋，選擇checkout的文件夾，單擊此文件夾右鍵單擊屬性，如圖：圖11.2.1-1亦可使用服務(wù)器端控制日志填寫。如果未填寫日志，則不可完成提交功能，彈出如下圖中的信息。2.2 功能提交（1）更新工程文件夾。選中工程所在的文件夾后，右鍵單擊文件夾，選擇update。更新工程所有文件。（2）更新完成之后，查看日志，注意其他開發(fā)者提交代碼后可能影響你開發(fā)的地方。確認(rèn)無誤，無沖突。（3）選中工程所在文件夾，右鍵單擊文件夾，選擇commit。（4）勾選出所提交的文件及文件夾，并撰寫相應(yīng)的提交日志。包括功能簡要描述、部署時需注意情況、修改數(shù)據(jù)庫表等。提醒其他開發(fā)者需要注意的地方。圖11.2.2-1（5

6、）確認(rèn)無誤后提交。2.3 鎖定-修改-解鎖（1）更新工程文件夾。選中工程所在的文件夾后，右鍵單擊文件夾，選擇update。更新工程所有文件。（2）選擇某文件，右鍵單擊選擇get lock，并輸入必要說明。圖11.2.3-1圖11.2.3-2（3）提交后看到“鎖定”說明。其他人在svn瀏覽器中也可以看到。圖11.2.3-3其他人在svn瀏覽器中也可以看到。鎖定文件的用戶。圖11.2.3-4（4）修改文件后，右鍵單擊文件commit，填寫相關(guān)日志，并選擇是否還要繼續(xù)鎖定。需要則勾選，圖11.2.3-5（5）如果不勾選，提交之后則表示自動解鎖。svn瀏覽器中看不到鎖定文件的用戶。圖11.2.3-62

7、.4 比較文件的不同之處當(dāng)對soc_1做了修改之后，soc_1文件會出現(xiàn)紅色嘆號，表示已經(jīng)修改，如果想查看修改后的soc_1文件與修改前有何不同，可以右鍵單擊此文件，選擇diff，系統(tǒng)探出一個窗口，如圖3，窗口分為兩個部分，左邊為更改之前的版本，右邊為更改之后的版本。并在不同之處作出標(biāo)記和說明。如圖：圖11.2.4-1 如果是word文檔的話，選擇diff之后，系統(tǒng)會打開一個word文檔，并在其中標(biāo)出修改后的版本與修改前有何不同。如圖：圖11.2.4-12.5 查看日志 如果想查看一個文件的日志，例如soc_1，右鍵單擊這個文件，選擇show log，系統(tǒng)會踏出一個窗口，并在窗口中顯示soc_

8、1各個版本的log。如圖：圖11.2.5-12.6 查看版本樹 如果想查看soc_1文件的版本樹，右鍵單擊該文件，選擇revision graph，系統(tǒng)將會打開一個窗口，并在窗口中顯示該文件的版本樹。如圖：圖11.2.6-1 之所以只顯示了四個版本，是因?yàn)檫x擇了只顯示發(fā)生過變化的版本。即.7每一個版本都有不同的地方，都是經(jīng)過用戶修改后提交的。而2.3兩個版本是與版本1相同的。2.7 下載某個文件的舊版本 如果想要得到某個文件的舊版本，只需在該文件上單擊右鍵，選擇update to revision即可。系統(tǒng)會提示輸入版本號。例如要下載soc_1的第五個版本，只需填入

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

10、么要找回文件只能通過下載舊版本庫來完成，參考1.3下載版本庫。2.9 創(chuàng)建分支 版本庫中最初的文件soc_1,soc_2,word_1,word_2都是主干文件。如果想要為soc_1創(chuàng)建一個分支，只需右鍵單擊soc_1，選擇branch/tag，系統(tǒng)會彈出一個窗口，如下圖。在窗口中，from url表示要創(chuàng)建的這個分支是soc_1的分支（系統(tǒng)會自動添加，不必更改）。在to url中，需要更改一下文件名，在文件名后加一個標(biāo)志即可，例如“_branch”，路徑不需要更改。在creat copy in the repository from中，可以選擇分支文件是由soc_1的那一個版本拷貝來的。最后

11、填寫日志，選擇ok。圖11.2.9-1分支創(chuàng)建完畢，update版本庫，系統(tǒng)會將soc_1的主干文件和分支文件soc_1_branch同時下載到本地版本庫，如圖8.1，然后即可在分支文件上進(jìn)行操作。此時soc_1的版本樹如圖8.2圖11.2.9-2圖11.2.9-32.10 合并分支2.10.1 使用svn自帶合并方式當(dāng)需要把soc_1_branc分支文件合并到soc_1主干文件時，右鍵單擊soc_1，選擇merge，會彈出一個窗口，如圖9。圖-1在from輸入框中填入主干的url，在to輸入框中填入分支的url。在from和to中，都有兩個選項(xiàng)head revision和r

12、evision，表示要進(jìn)行合并的是soc_1的那個版本。合并之后主干文件會標(biāo)注紅色嘆號，表示已被修改，并可以提交。如果合并后文件標(biāo)注的是黃色嘆號，表示文件有沖突，處理方法見“3 異常處理”。2.10.2 使用araxis merge工具合并處理使用其他工具進(jìn)行合并處理時，首先要在svn中設(shè)置使用此工具。在setting-diff中填入c:program filesaraxisaraxis merge v6.5merge.exe；在setting-merge的選項(xiàng)中，填入c:program filesaraxisaraxis merge v6.5merge.exe %theirs %mine %

13、merged ；其中c:program filesaraxisaraxis merge v6.5merge.exe是指合并工具的路徑，%theirs %mine %merged分別指.將要合并到主干的分支，主干，及合并后的結(jié)果。圖 .-1合并者deva先把主干check out到本地。然后在主干的目錄上右鍵選擇svn-merge，彈出如下窗口： 圖 -2 合并對話框此對話框的含義是把from指定的分支版本到to指定的分支版本之間的差異合并到主在這里分支選的是revision 6。版本號的選定方法是點(diǎn)擊from中的show log，在log窗口中按住ctrl鍵

14、，點(diǎn)擊選擇”made a copy”之上的那個版本，以及revision 4版本，如圖10.2所示。然后點(diǎn)擊確定回到上圖中的對話框，會自動填寫from與to中的revision號。圖-3選擇需要合并的版本然后直接點(diǎn)擊merge進(jìn)行合并，你也可以通過dry run來看是不是兩者之間有差異。如果沒有其它人修改主干，合并會很順利。合并完畢之后，由合并者deva對主干進(jìn)行提交。如果有其他人修改主干，則有可能會產(chǎn)生沖突，處理方法詳見下面的“3 異常處理”2.11 撤銷修改當(dāng)對一個文件進(jìn)行了修改并保存后（注意此處并沒有進(jìn)行提交），如果對修改不滿意，想要重新修改，可以右鍵單擊修改過的文件（

15、帶紅色嘆號的那個），然后選擇revert，前面的一系列修改便會被撤銷，恢復(fù)到update之后的狀態(tài)。如果一個文件被誤刪除，也可通過右鍵單擊該文件所在的目錄，選擇revert來恢復(fù)。3 異常處理此處所說的異常主要是指文件發(fā)生沖突。以用戶deva和用戶devb為例，當(dāng)兩個用戶同時下載了最新的版本庫，并對庫中同一個文件soc_2進(jìn)行修改提交時，首先提交的用戶deva不會發(fā)生異常，第二個提交的用戶devb便會出現(xiàn)無法提交的現(xiàn)象。因?yàn)榉?wù)端的版本庫已經(jīng)被deva更新，devb用戶在上傳時，系統(tǒng)會提示出錯如圖11。圖11.3-1在這種情況下，devb用戶需要首先對修改的文件進(jìn)行update文件操作。如果兩

16、個用戶修改了文件soc_2的同一個地方，則在devb用戶執(zhí)行update后，系統(tǒng)會將本地的soc_2與從服務(wù)端下載soc_2合并到一個文件上，并在該文件圖標(biāo)上標(biāo)上黃色嘆號，表示文件出沖突?？梢宰孕薪鉀Q或利用工具解決出現(xiàn)的沖突。3.1 自行解決沖突在出現(xiàn)黃色嘆號的文件中通過“”標(biāo)識沖突位置和沖突內(nèi)容。devb用戶只有與deva協(xié)商，將該沖突處理，之后單擊右鍵，選擇resolve，沖突標(biāo)記消除，才能夠再次提交，否則無法提交。文件標(biāo)記沖突的格式： .r15綠色部分表示本地文件的修改藍(lán)色部分表示服務(wù)端版本庫中的最新版本與本地文件修改發(fā)生沖突的地方。紫色表示是第15個版本發(fā)生了沖突3.2 使用工具解決沖突deva提交完畢之后，devb要將他的文件同樣提交上去，方法同上。但是由于