SVN客戶端操作手冊范本

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

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

3、本文件，可選中Revision，然后填入版本號即可。如下圖所示。痹 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如果不想下載整個版本庫，而是只想下載自己負責的那部分模塊，可以在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按鈕，彈出提示對話框提示“該文件不存在，您是否需要創(chuàng)建它”。如下圖所示6. 我們單擊“Yes&q

5、uot;按鈕，需要輸入用戶名和密碼。如果我們未選中“Save authentication選項，我們需要重復輸入幾次密碼，它表示是否保存密碼鑒定。如下圖所示。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.當我們選中"Save authentication”選項時，輸入一

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

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

8、d?A (idee： 114點擊“OK'按鈕后，然后文件上面會出現(xiàn)一個加號。如下圖所示。15.此時，服務器上還沒有存在該文件，我們還需要Commit該文件。右擊該文件選擇 SVNCommit提交到服務器中。如下圖所示。16.當提交（或修改）的文件需要寫上一個消息，表示該文件是做什么的，有什么好處等。如下圖所示。轎 匸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點擊“ OK'按鈕，被Commit的文件會被標記為綠色對勾，沒有綠色對勾的文件表示沒 有被提交。如下圖所示。注意：有的時候，當文件 Commit后，圖標沒有發(fā)生變化。此時，只需要刷新一下即可。 如下圖所示。18.如果對庫中某一個文件進行了修改，系統(tǒng)會自動為這個文件和這個文件所在的各級

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

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

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

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

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

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

16、果想查看“我的資料信息.txt "文件的版本樹，右鍵單擊該文件，選擇TortoiseSVN->Revision graph 選項，如下圖所示。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)將會打開一個

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

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

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

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

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