| 作者: | 北京群英匯信息技術有限公司 |
|---|---|
| 網址: | http://www.ossxp.com/ |
| 版本: | 0.1-35 |
| 日期: | 2011-07-05 10:51:59 |
| 版權信息: |  |
SVN的內容很多，即使其簡明手冊濃縮在一頁紙很難，但是用一張超大的紙也許可以裝得下。下面就是Windows平台下TortoiseSVN的簡明操作手冊，關於SVN的更多內容參見群英匯的SVN培訓講義或如下SVN官方文檔。
-
SVNBOOK (Version Control with Subversion)
-
TSVN manual
http://tortoisesvn.net/docs/release/TortoiseSVN_zh_CN/index.html
1 安裝TortoiseSVN
TortoiseSVN簡稱TSVN，是在Windows平台上廣泛使用的Subversion（SVN）客戶端。該軟件的標識是一只小烏龜（Tortoise），可以從 TSVN官方網站 下載TSVN軟件的最新版。
-
下載並安裝TSVN。
TSVN安裝包有32位和64位兩個版本，下載安裝前先確認你Windows的版本（注意不是Windows XP和Windows 7的版本，而是由所支持的CPU指令架構是32位還是64位決定），如果不確定就先試試32位版本吧。
-
下載並安裝中文語言包。
同樣中文語言包也有32位和64位之分，根據你操作系統的版本進行選擇。
-
先安裝TSVN，再安裝中文語言包，然后設置TSVN，將默認語種設置為中文。
設置方法如下：
-
在資源管理器中單擊鼠標右鍵，彈出菜單參見圖1。
圖1：資源管理器右鍵彈出菜單
-
設置語種為中文。參見圖2。
圖2：設置TSVN語種
-
2 使用需知
TSVN是一個和Windows的資源管理器整合的應用，可從資源管理器、Windows的文件打開對話框甚至桌面上，通過單擊鼠標右鍵，從彈出的右鍵菜單中調用相應功能。
使用TSVN前，需要從管理員那里確認：
- SVN版本庫的地址是什么？例如: https://svn.ossxp.com/svn/demo
- 您的用戶名和口令。
3 TSVN的使用
3.1 瀏覽遠程版本庫
項目的SVN版本庫中可能包含非常多的文件，且開發主線、分支、里程碑都作為獨立的目錄存在，因此從項目的根目錄檢出版本庫不是一個好主意。可以利用TSVN的遠程版本庫瀏覽功能，先看看版本庫都有什么內容，然后根據需要檢出。
-
在資源管理器中的右鍵菜單選擇“版本庫瀏覽器”，如圖3所示。
圖3：右鍵菜單中選中版本庫瀏覽器
-
在彈出的URL地址錄入框中輸入版本庫地址，如圖4所示。
圖4：輸入版本庫URL地址
-
因為連接的是HTTPS協議的SVN版本庫，會詢問是否接受HTTPS網站證書。選擇總是接受，則以后訪問任何該服務器上的版本庫都不會再彈出類似證書確認對話框了。如圖5所示。
圖5：HTTPS網站證書確認
-
在彈出的認證對話框中輸入SVN服務器登錄的用戶名和口令。如圖6所示。
圖6：輸入用戶名和口令
-
顯示遠程版本庫的目錄樹。從圖7可以看出該版本庫有三個頂級目錄，分別是：trunk（主線目錄），branches（保存分支的根目錄），tags（保存里程碑的根目錄）。
圖7：輸入用戶名和口令
-
可以直接通過版本庫瀏覽器打開文件查看，或者進行其他操作，參見圖8。
圖8：直接通過版本庫瀏覽器打開文件
3.2 檢出遠程版本庫到工作區
雖然可以通過版本庫瀏覽器直接查看遠程版本庫中的文件，甚至可以刪除遠程版本庫的文件，但是如果要修改版本庫中的文件，並將修改后的文件更新到遠程版本庫中，首先就需要用到SVN的檢出命令。
檢出動作就是將遠程版本庫的目錄檢出到本地的一個目錄中。這個檢出動作的目標目錄（本地目錄）稱為本地工作區目錄。
-
在資源管理器的右鍵菜單中選擇”SVN檢出“，或通過版本庫瀏覽器選擇要檢出的目錄，點擊鼠標右鍵，如圖9所示。
圖9：版本庫瀏覽器中的右鍵菜單
-
彈出的檢出對話框，確認正確填寫了版本庫URL和目標目錄（即標記為”檢出至目錄“）。如圖10。
圖10：檢出對話框
-
檢出一旦開始，顯示檢出的整個過程。檢出的速度視網絡帶寬和數據下載量而異。如圖11。
圖11：檢出過程
-
檢出后，工作區目錄下的文件和目錄的圖標會疊加上TSVN的標識，可以很容易的識別哪些文件被改動過，哪些文件是本地新增尚未添加到版本庫等。
圖12還顯示出一個隱藏的目錄 ".svn"，在工作區的每一個子目錄下都存在這個 ".svn" 目錄，注意不要擅自改動該目錄下的內容，更不能刪除該目錄。
圖12：檢出后的本地工作區
-
圖13顯示的是工作區文件修改后，文件、目錄圖標的變化。
圖13：工作區文件改動后圖標的改變
3.3 文件提交
在工作區中對文件進行了修改、增、刪等操作后，如果想將改動更新至遠程服務器，需要執行提交操作。
-
選擇通過右鍵菜單中的提交動作，如圖14所示。
圖14：右鍵菜單中的提交
-
默認只有修改或其他已經被TSVN標識的文件被提交。如圖15所示，本地新增和刪除的文件因為尚未標識，缺省不進行提交。
圖15：提交對話框
-
選擇本地刪除的文件，通過右鍵菜單標記為刪除，如圖16所示。
圖16：將本地刪除的文件標記為刪除。
-
選擇本地新增的文件，通過右鍵菜單標記為新增，如圖17所示。
圖17：將本地添加的文件標記為新增。
-
不要忘了撰寫提交說明，如圖18所示。
提交說明可以：為什么要修改這些文件，為什么要這么改，以及解決了什么問題，如有可能把相應的Bug編號也寫上。
注意因為提交本身會自動記錄誰、在什么時間、修改了哪些文件，因此這類信息沒有必要放在提交說明中，以免造成不必要的重復。
圖18：撰寫提交說明，點擊提交按鈕
3.5 反刪除文件
文件檢入到版本庫中便被永久記錄，即使用戶在客戶端刪除文件並提交，也只是在版本庫最新提交中去掉了該文件，但在歷史提交中文件仍然存在。SVN提供了恢復被刪除文件的功能，用TSVN操作非常的簡單。
-
在工作區進入到瀏覽提交日志的界面，找到刪除文件的提交，右鍵點擊被刪除的文件彈出菜單中有”復原此版本作出的修改“一項，如圖20所示。
圖20：從工作區進入到瀏覽提交日志的界面
-
當點擊”復原此版本作出的修改“后，TSVN彈出確認對話框，如圖21所示。
圖21：確認文件恢復的對話框
-
顯示反刪除的過程，如圖22所示。
圖22：反刪除過程顯示
-
經過上面操作后，曾經被刪除的文件被找回，重新出現在工作區中。圖23顯示找回的文件的圖標疊加了一個加號。
圖23：曾經的刪除文件被找回
-
反刪除的最后一步就是執行提交，將反刪除的文件提交到服務器上，這樣才真正完成文件的反刪除。
圖24：提交完成文件反刪除