SVN客戶端操作手冊(cè)范本

1、SVNg己置管理工具操作手冊(cè)之 SVN客戶端篇接下來(lái)，我們就學(xué)習(xí)怎樣使用 SVN配置管理工具。該操作手冊(cè)將逐步教您如何在軟件開(kāi)發(fā)過(guò) 程中使用SVN客戶端。環(huán)境模擬：現(xiàn)有項(xiàng)目數(shù)據(jù)名稱：ProjectData服務(wù)端版本庫(kù)：repository訪問(wèn) URL 一、基本操作1. 安裝客戶端。下載下載安裝程序，雙擊直接安裝即可。安裝成功后，在任意位置右鍵單擊鼠標(biāo)會(huì)多出兩個(gè)選項(xiàng)，分別是SVNCheckout 和 Tortoise SVN。如下圖所示。排列閨標(biāo) 刷新（£）揃銷(xiāo)移動(dòng)Ctrl+Z穴 SVN Checkout.Tor toisek2. 建立工作區(qū)。項(xiàng)目開(kāi)始之前，在本地的硬盤(pán)上（比如：E盤(pán)）

2、創(chuàng)建一個(gè)文件夾，文件夾命名隨意（例如 MyWork），該文件夾即作為軟件開(kāi)發(fā)者在項(xiàng)目開(kāi)發(fā)過(guò)程中的工作區(qū)。如 下圖所示。3. 下載版本庫(kù)。假如現(xiàn)在開(kāi)發(fā)一個(gè)項(xiàng)目，配置管理員會(huì)在服務(wù)端建立一個(gè)該項(xiàng)目的版本庫(kù)repository 。在MyWork文件夾上，右鍵單擊鼠標(biāo)。在彈出的菜單中選擇 SVNCheckout 選項(xiàng)，如下圖所示。4. 在 URL of repository中輸入版本庫(kù)地址：ProjectData ，在Checkout directory中系統(tǒng)會(huì)自動(dòng)添加第二步所創(chuàng)建的工作區(qū)目錄。在Revision中，選中HEAD revision，這樣將會(huì)下載到版本庫(kù)的最新版本。如果想下 載庫(kù)中的舊版

3、本文件，可選中Revision，然后填入版本號(hào)即可。如下圖所示。痹 Ctieckaut-RepositoryURL of repository;http: /192 163,1.1D3; 8010/s vn/repcsitory/Proj ectcF&ckdlx aiiectoiy:一 Checkout Depth| Fuly recursiveOmit exbernalsRevisionShow logHelp回昨 revision' R-evisionCancel如果不想下載整個(gè)版本庫(kù)，而是只想下載自己負(fù)責(zé)的那部分模塊，可以在URL后添加模塊名，例如 。如下圖所示。2d-

4、RepositoryURL cF repository:|© ht8：/19QlES-l, 103:801ors¥ni/Fpo£itQFy/PtQjmED3tar4yDCheckout directory: |El*lyWorl ITI/Doc3川一川Checkout Depth|Fully recurve二J廠 Omit externalsRevisionf* HEAD revision廠 Revisionshew logQICLanceltjelp5. 單擊“ OK按鈕，彈出提示對(duì)話框提示“該文件不存在，您是否需要?jiǎng)?chuàng)建它”。如下圖所示6. 我們單擊“Yes&q

5、uot;按鈕，需要輸入用戶名和密碼。如果我們未選中“Save authentication選項(xiàng)，我們需要重復(fù)輸入幾次密碼，它表示是否保存密碼鑒定。如下圖所示。AWi | F創(chuàng)h匚 ornnand CheckautAuhhentkiatBon<htp /M?M&5,L-1Q3；3C 10 A JJK1A 0hF TRAlpfl3JB>EF6C'Nin HEAC Fl" recurs ve_ E>terUserrwme：Pa<sord：ve idthentlcaclor7.當(dāng)我們選中"Save authentication”選項(xiàng)時(shí)，輸入一

6、次正確的用戶名和密碼即可。如-|D| x|即 http:/1 yz. 1 bu. 1.1U315UI o；svn(repository Project Data/ FyDo:F圖所示。8. 當(dāng)用戶名和密碼正確后， 就會(huì)從SVN服務(wù)器中下載最新版本庫(kù)文件。會(huì)顯示一下關(guān)于版本庫(kù)和文件的信息，如下圖所示。9. 點(diǎn)擊“0K'按鈕后，我們的工作目錄（MyWorl）下就有一個(gè)從服務(wù)器下載的版本目錄。本地的工作區(qū)文件夾，即 MyWork上會(huì)有綠色對(duì)勾出現(xiàn)，該目錄下的文件也會(huì)帶有綠色對(duì)勾。如下圖所示。10. 修改版本庫(kù)。對(duì)版本庫(kù)的修改包括修改文件容、添加和刪除文件、添加刪除目錄。我們?nèi)绾紊蟼饕粋€(gè)文件呢

7、？在該工作區(qū)文件目錄下，新建一個(gè)文件。此時(shí)該文件上顯示一個(gè)問(wèn)號(hào)符號(hào)，表示是新加入的文件。如下圖所示。11. 新加入了某些文件后，需要右鍵點(diǎn)擊文件選擇TortoiseSVN->Add ，如下圖所示。12.然后會(huì)提示您是否確認(rèn)提交該文件，如下圖所示。13點(diǎn)擊"0K'按鈕后，提示該文件新增信息。如下圖所示。-101x1ActianiPadhMime typeComncnd AddAddedE:刖1 艸/wlAflyDo 也刖 fl 服客和 SE 豊 dec appkathri/actet-streafnFrushed!flr Add - Tortois亡5YN Finishe

8、d?A (idee： 114點(diǎn)擊“OK'按鈕后，然后文件上面會(huì)出現(xiàn)一個(gè)加號(hào)。如下圖所示。15.此時(shí)，服務(wù)器上還沒(méi)有存在該文件，我們還需要Commit該文件。右擊該文件選擇 SVNCommit提交到服務(wù)器中。如下圖所示。16.當(dāng)提交（或修改）的文件需要寫(xiě)上一個(gè)消息，表示該文件是做什么的，有什么好處等。如下圖所示。轎 匸ommit - EiMy Wor lc "MyDoc-lol x|匚dPTMTl* tO：.1.03:601 Ofsvnjreposftory/PrqjectData|IHyDoc/SVN服雰踹安裝和ecerit messages|這晟副m爰聘遲囲配翼s諫助丈&#

9、163;1Changes made (double-click on file for ifF):雨 5how unvsioned filesP Select / deselect all1 F iles sclectedj i files totalL Keep neksV Keep dn目口口已5匕17點(diǎn)擊“ OK'按鈕，被Commit的文件會(huì)被標(biāo)記為綠色對(duì)勾，沒(méi)有綠色對(duì)勾的文件表示沒(méi) 有被提交。如下圖所示。注意：有的時(shí)候，當(dāng)文件 Commit后，圖標(biāo)沒(méi)有發(fā)生變化。此時(shí)，只需要刷新一下即可。 如下圖所示。18.如果對(duì)庫(kù)中某一個(gè)文件進(jìn)行了修改，系統(tǒng)會(huì)自動(dòng)為這個(gè)文件和這個(gè)文件所在的各級(jí)

10、父文件夾加上紅色嘆號(hào)，代表該文件或目錄已經(jīng)在本地被修改。如下圖所示。| 右 My Doc文件 編歡自 查看囪 收麓阿 ra（T） wh）%后退* /搜索L文件興囪地址（0 |lO EiyWorKMyDocJ1轉(zhuǎn)到文件夾酚桌面上3 U我的哀檔 9我的電胞a 本地磁盤(pán)忙：）E 2本地磁蠱（D:）曰*i新加卷（E;）：-I iTp MvWork竝洞si卜 臣J本地曲畫(huà)（F：）13 Q 8馳動(dòng)器）|岸 I 廠l.弓州服第戟安裝和配置docI Microsoft Word 丈檔1平梅（加2佬話對(duì)象）（可用|137KB文件和父口錄 顯亦紅色嘆號(hào)I 2J19.當(dāng)所有對(duì)版本庫(kù)的修改操作完畢后，右鍵單擊工作區(qū)文

11、件夾，選擇SVN Commit提交新版本，輸入密碼后系統(tǒng)將把修改后的版本庫(kù)上傳到服務(wù)端，即完成一次對(duì)版本庫(kù)的更新。如下圖所示。注意：提交新版本之后，其他擁有寫(xiě)權(quán)限的用戶也許會(huì)重復(fù)以上幾步的操作，完成對(duì)版本庫(kù)的再一次更新。所以，每次在工作區(qū)文件夾下修改本地版本庫(kù)之前，必須首先對(duì)本地版本庫(kù)執(zhí)行一次更新（右鍵單擊工作區(qū)，選擇SVNUpdate），將最新的版本下載到本地，然后再進(jìn)行修改操作。如下圖所示。20.假如不知道版本庫(kù)中有哪些文件，這時(shí)可以先對(duì)版本庫(kù)進(jìn)行瀏覽，然后根據(jù)自己的需要下載相應(yīng)的資源。在任意空白位置單擊鼠標(biāo)右鍵，選擇TortoiseSVN->Repo-browser進(jìn)行瀏覽。如下圖

12、所示?，摽床榱袊?guó)係刷新侶自定文立件夾込 釉貼（M粘貼快睫方式（9目 5VN Checyxjt.,HTortoiseSVN卜|*、Repo-brow«er匚植鯉卜-j Expart.Create p spositopy. he re 詢 Import.iiSetting ? Help 令 Atout21.我們需要輸入 URLM址，就是版本庫(kù)的路徑。如下圖所示。22點(diǎn)擊“0K按鈕后，就可以瀏覽自己擁有權(quán)限的版本庫(kù)信息。如下圖所示。提示：當(dāng)自己沒(méi)有保存密碼鑒定時(shí)，需要重新輸入用戶名和密碼。、其他操作在日常的軟件開(kāi)發(fā)過(guò)程中，除了以上介紹的下載，提交，更新操作外，還有另外幾種常用操作。1.

13、比較文件的不同之處。當(dāng)對(duì)soc_1做了修改之后，soc_1文件會(huì)出現(xiàn)紅色嘆號(hào)，表示已經(jīng)修改，如果想查看修改后的soc_1文件與修改前有何不同，可以右鍵單擊此文件，選擇TortoiseSVN->Diff 選項(xiàng)。如下圖所示。Edit with rEdpse Text Editor 打印回LJ 匱用 E5E7 MOD32 Antivirus 曲描 高級(jí)迤頂 打弁方式（比IT SVN尸 5VNCommit-,with previous version Show log Cepo-broiAiser H=匚heck for modifications 離 R 沁ionQFarih電 Tortois

14、eSVN總孫加刮壓縮文件倉(cāng)孫加到"我的貴料信l.rar'XD 倉(cāng) JOS笄 E-mil.9醫(yī)縮到議的資科信息曲'并E-mail2. 系統(tǒng)彈出一個(gè)窗口， 窗口分為兩個(gè)部分， 左邊為更改之前的版本，右邊為更改之后的版本。并在不同之處作出標(biāo)記和說(shuō)明。如下圖所示。提示：如果是 Word文檔，選擇Diff之后，系統(tǒng)會(huì)打開(kāi)一個(gè) Word文檔，并在其中標(biāo)出 修改后的版本與修改前有何不同。txt ”，右鍵單擊這個(gè)文3. 查看日志。如果想查看一個(gè)文件的日志，例如“我的資料信息 件，選擇TortoiseSVN->Show Log 選項(xiàng)，如下圖所示。I., .txt；I 打開(kāi)（Edi

15、t with Mi/Ejcllpse Text Editor打印舊J 使用 E5ET lIOD32 Antivirus 掃推 高級(jí)選頂打開(kāi)方式（出f 5VN Update *耳 £燈耐 Cpnnmfc.UltraEdit-3Z這添加刊壓縮寶件（帕 倉(cāng)爲(wèi)0倒蟻的熒料信息* 簷壓縮 E-tnal.! 5haw logL0iff 卅 ith preriQus versionp R.epa-brcwsf皚=Check fcr mcxjificatioris 貞 REViBcin4. 系統(tǒng)會(huì)彈出一個(gè)窗口，并在窗口中顯示“我的資料信息.txt ”各個(gè)版本的Log。如下圖所示。5. 查看版本樹(shù)。如

16、果想查看“我的資料信息.txt "文件的版本樹(shù)，右鍵單擊該文件，選擇TortoiseSVN->Revision graph 選項(xiàng)，如下圖所示。njF(o)Tortoise 5¥N|電 Q肝 洲th previous versionUltraEdit-32舊海加到壓縮文件砂遷裾加到"我的資科恒息"(T)醫(yī)縮井 E-mail.-苣壓縮到"我的資稈信U.rar"并E-mail© =弗卻Ipg Repa-brovjMr=Check for notificationsw -頭 Revision flraph6. 系統(tǒng)將會(huì)打開(kāi)一個(gè)

17、窗口，并在窗口中顯示該文件的版本樹(shù)。如下圖所示。Edit with MyEtlipse Te?<t Editor打她(J 便用 ESE1 NOD32 Antivirus 掃菇 高級(jí)選項(xiàng)打開(kāi)方式(tDF 54hl update嚴(yán) 5VNCommit,.,7. 下載某個(gè)文件的舊版本。如果想要得到某個(gè)文件的舊版本，只需在該文件上單擊右鍵, 選擇TortoiseSVN-> Updata to revision選項(xiàng)即可。如下圖所示。Edit wth My Eclipse Text Editor 打ER®編輯舊J 使用 ESET N0M2 Antivirus 掃描 高級(jí)選項(xiàng)打幵才式H

18、)lT 引N Update滬 SVN Commit.*' Tortoi5®5VN| 二 Riff 啊th previous vercionUltraEdit-32到壓縮MW 逢軌倒"我的資細(xì)t息 壓縮并E-mdil. 逢壓蹌到哦的贊料信息er“ # E-mail埃送埶囪護(hù) 5how log*4. LePO-browserGs 匚I歸dk. for modificationsRe vision graph$ Update to revision.8.系統(tǒng)會(huì)提示輸入版本號(hào)。例如要下載“我的資料信息.txt ”的第6個(gè)版本，只需選中“Revision ”和填入版本號(hào) 6即

19、可。如下圖所示。9. 點(diǎn)擊“ OK'按鈕，即可查看版本號(hào)為6的容。如下圖所示。10. 查看完版本6的文件后，如果想在此回到最新版本，右鍵單擊“我的資料信息.txt ”文件，選擇SVN Update選項(xiàng)即可。打幵0)Edit 怖th HyEdipie Text Editor 打印(日序a©O 使用 E5ET NOD32 Antivirus 掃描 高級(jí)選項(xiàng)< 5VN update戸 5VN Commit.,命 TcrtaiseSVN11. “我的資料信息.txt ”文件已更改至最新版，文件容回到最新。如下圖所示。B我的盜料倍宜上祇-記爭(zhēng)本文件（日騙話格式® 查看（

20、也幫勘（比大家好！很高興認(rèn)識(shí)你們，我的名字叫小明。d-J12. 重名名和刪除文件。如果要?jiǎng)h除一個(gè)文件或重名名一個(gè)文件，注意不要在windows下直接操作。只需右鍵單擊該文件，選擇Rename或 Delete ,svn系統(tǒng)便會(huì)完成操作。在MyWork 中將文件重命名或刪除后，服務(wù)端的文件結(jié)構(gòu)不會(huì)變化，只有當(dāng)提交新版本庫(kù)后，即Commit后，服務(wù)端的文件結(jié)構(gòu)才會(huì)被更新。如果誤刪除了文件，在沒(méi)有提交版本庫(kù)之 前，可以通過(guò)對(duì)版本庫(kù)的更新將文件重新下載到本地的版本庫(kù)，也可以通過(guò)revert恢復(fù)。如果文件刪除，并且已經(jīng)提交，那么要找回文件只能通過(guò)下載舊版本庫(kù)來(lái)完成。13. 撤銷(xiāo)修改。當(dāng)對(duì)一個(gè)文件進(jìn)行了修改

21、并保存后（注意此處并沒(méi)有進(jìn)行提交），如果對(duì)修改不滿意，想要重新修改，可以右鍵單擊修改過(guò)的文件（帶紅色嘆號(hào)的那個(gè)），然后選擇revert，前面的一系列修改便會(huì)被撤銷(xiāo)，恢復(fù)到 Updata之前的狀態(tài)。如果一個(gè)文件 被誤刪除，也可通過(guò)右鍵單擊該文件所在的目錄，選擇revert來(lái)恢復(fù)。三、異常處理1.此處所說(shuō)的異常主要是指文件發(fā)生沖突。以用戶A和用戶B為例，當(dāng)兩個(gè)用戶同時(shí)下載了最新的版本庫(kù)，并對(duì)庫(kù)中同一個(gè)文件“我的資料信息.txt ”進(jìn)行修改提交時(shí)，首先提交的用戶A不會(huì)發(fā)生異常，第二個(gè)提交的用戶 B便會(huì)出現(xiàn)無(wú)法提交的現(xiàn)象。因?yàn)榉?wù)端的版本庫(kù)已經(jīng)被A更新，B用戶在上傳時(shí)，系統(tǒng)會(huì)提示出錯(cuò)。如下圖所示。ActionP砒Mime typeCommandCounitModifiedErrorComnit Failed (detail?ErrorFite m dir ectcry 叢的資理信息上x(chóng)Fk tut cr data; try updatingError ii4resoirce out of date, try up»dating-|口|刃The operatbn fniledL；il|t 養(yǎng)的脊科信包.