SVN快速入門（TSVN）

做者:	北京羣英匯信息技術有限公司
網址:	http://www.ossxp.com/
版本:	0.1-35
日期:	2011-07-05 10:51:59
版權信息:

目錄

• 1   安裝TortoiseSVN
• 2   使用需知
• 3   TSVN的使用
  • 3.1   瀏覽遠程版本庫
  • 3.2   檢出遠程版本庫到工做區
  • 3.3   文件提交
  • 3.4   提交日誌
  • 3.5   反刪除文件

SVN的內容不少，即便其簡明手冊濃縮在一頁紙很難，可是用一張超大的紙也許能夠裝得下。下面就是Windows平臺下TortoiseSVN的簡明操做手冊，關於SVN的更多內容參見羣英匯的SVN培訓講義或以下SVN官方文檔。

• SVNBOOK (Version Control with Subversion)

  http://svnbook.red-bean.com/nightly/en/index.html

• TSVN manual

  http://tortoisesvn.net/docs/release/TortoiseSVN_zh_CN/index.html

1   安裝TortoiseSVN

TortoiseSVN簡稱TSVN，是在Windows平臺上普遍使用的Subversion（SVN）客戶端。該軟件的標識是一隻小烏龜（Tortoise），能夠從 TSVN官方網站 下載TSVN軟件的最新版。

1. 下載並安裝TSVN。

   TSVN安裝包有32位和64位兩個版本，下載安裝前先確認你Windows的版本（注意不是Windows XP和Windows 7的版本，而是由所支持的CPU指令架構是32位仍是64位決定），若是不肯定就先試試32位版本吧。

2. 下載並安裝中文語言包。

   一樣中文語言包也有32位和64位之分，根據你操做系統的版本進行選擇。

3. 先安裝TSVN，再安裝中文語言包，而後設置TSVN，將默認語種設置爲中文。

   設置方法以下：

   • 在資源管理器中單擊鼠標右鍵，彈出菜單參見圖1。

     圖1：資源管理器右鍵彈出菜單

   • 設置語種爲中文。參見圖2。

     圖2：設置TSVN語種

2   使用需知

TSVN是一個和Windows的資源管理器整合的應用，可從資源管理器、Windows的文件打開對話框甚至桌面上，經過單擊鼠標右鍵，從彈出的右鍵菜單中調用相應功能。

使用TSVN前，須要從管理員那裏確認：

1. SVN版本庫的地址是什麼？例如: https://svn.ossxp.com/svn/demo
2. 您的用戶名和口令。

3   TSVN的使用

3.1   瀏覽遠程版本庫

項目的SVN版本庫中可能包含很是多的文件，且開發主線、分支、里程碑都做爲獨立的目錄存在，所以從項目的根目錄檢出版本庫不是一個好主意。能夠利用TSVN的遠程版本庫瀏覽功能，先看看版本庫都有什麼內容，而後根據須要檢出。

1. 在資源管理器中的右鍵菜單選擇「版本庫瀏覽器」，如圖3所示。

   圖3：右鍵菜單中選中版本庫瀏覽器

2. 在彈出的URL地址錄入框中輸入版本庫地址，如圖4所示。

   圖4：輸入版本庫URL地址

3. 由於鏈接的是HTTPS協議的SVN版本庫，會詢問是否接受HTTPS網站證書。選擇老是接受，則之後訪問任何該服務器上的版本庫都不會再彈出相似證書確認對話框了。如圖5所示。

   圖5：HTTPS網站證書確認

4. 在彈出的認證對話框中輸入SVN服務器登陸的用戶名和口令。如圖6所示。

   圖6：輸入用戶名和口令

5. 顯示遠程版本庫的目錄樹。從圖7能夠看出該版本庫有三個頂級目錄，分別是：trunk（主線目錄），branches（保存分支的根目錄），tags（保存里程碑的根目錄）。

   圖7：輸入用戶名和口令

6. 能夠直接經過版本庫瀏覽器打開文件查看，或者進行其餘操做，參見圖8。

   圖8：直接經過版本庫瀏覽器打開文件

3.2   檢出遠程版本庫到工做區

雖然能夠經過版本庫瀏覽器直接查看遠程版本庫中的文件，甚至能夠刪除遠程版本庫的文件，可是若是要修改版本庫中的文件，並將修改後的文件更新到遠程版本庫中，首先就須要用到SVN的檢出命令。

檢出動做就是將遠程版本庫的目錄檢出到本地的一個目錄中。這個檢出動做的目標目錄（本地目錄）稱爲本地工做區目錄。

1. 在資源管理器的右鍵菜單中選擇」SVN檢出「，或經過版本庫瀏覽器選擇要檢出的目錄，點擊鼠標右鍵，如圖9所示。

   圖9：版本庫瀏覽器中的右鍵菜單

2. 彈出的檢出對話框，確認正確填寫了版本庫URL和目標目錄（即標記爲」檢出至目錄「）。如圖10。

   圖10：檢出對話框

3. 檢出一旦開始，顯示檢出的整個過程。檢出的速度視網絡帶寬和數據下載量而異。如圖11。

   圖11：檢出過程

4. 檢出後，工做區目錄下的文件和目錄的圖標會疊加上TSVN的標識，能夠很容易的識別哪些文件被改動過，哪些文件是本地新增還沒有添加到版本庫等。

   圖12還顯示出一個隱藏的目錄 ".svn"，在工做區的每個子目錄下都存在這個 ".svn" 目錄，注意不要擅自改動該目錄下的內容，更不能刪除該目錄。

   圖12：檢出後的本地工做區

5. 圖13顯示的是工做區文件修改後，文件、目錄圖標的變化。

   圖13：工做區文件改動後圖標的改變

3.3   文件提交

在工做區中對文件進行了修改、增、刪等操做後，若是想將改動更新至遠程服務器，須要執行提交操做。

1. 選擇經過右鍵菜單中的提交動做，如圖14所示。

   圖14：右鍵菜單中的提交

2. 默認只有修改或其餘已經被TSVN標識的文件被提交。如圖15所示，本地新增和刪除的文件由於還沒有標識，缺省不進行提交。

   圖15：提交對話框

3. 選擇本地刪除的文件，經過右鍵菜單標記爲刪除，如圖16所示。

   圖16：將本地刪除的文件標記爲刪除。

4. 選擇本地新增的文件，經過右鍵菜單標記爲新增，如圖17所示。

   圖17：將本地添加的文件標記爲新增。

5. 不要忘了撰寫提交說明，如圖18所示。

   提交說明能夠：爲何要修改這些文件，爲何要這麼改，以及解決了什麼問題，若有可能把相應的Bug編號也寫上。

   注意由於提交自己會自動記錄誰、在什麼時間、修改了哪些文件，所以這類信息沒有必要放在提交說明中，以避免形成沒必要要的重複。

   圖18：撰寫提交說明，點擊提交按鈕

3.4   提交日誌

在提交日誌中能夠看到包括最新提交在內的歷次提交記錄，點擊右鍵菜單的中的」顯示日誌「便可。

圖19：提交日誌

3.5   反刪除文件

文件檢入到版本庫中便被永久記錄，即便用戶在客戶端刪除文件並提交，也只是在版本庫最新提交中去掉了該文件，但在歷史提交中文件仍然存在。SVN提供了恢復被刪除文件的功能，用TSVN操做很是的簡單。

1. 在工做區進入到瀏覽提交日誌的界面，找到刪除文件的提交，右鍵點擊被刪除的文件彈出菜單中有」復原此版本做出的修改「一項，如圖20所示。

   圖20：從工做區進入到瀏覽提交日誌的界面

2. 當點擊」復原此版本做出的修改「後，TSVN彈出確認對話框，如圖21所示。

   圖21：確認文件恢復的對話框

3. 顯示反刪除的過程，如圖22所示。

   圖22：反刪除過程顯示

4. 通過上面操做後，曾經被刪除的文件被找回，從新出如今工做區中。圖23顯示找回的文件的圖標疊加了一個加號。

   圖23：曾經的刪除文件被找回

5. 反刪除的最後一步就是執行提交，將反刪除的文件提交到服務器上，這樣才真正完成文件的反刪除。

   圖24：提交完成文件反刪除