TortoiseSVN 使用教程

TortoiseSVN 是 Subversion 版本控制系統的一個免費開源客戶端,可以超越時間的管理檔案和目錄。


TortoiseSVN 安裝

下載地址:https://tortoisesvn.net/downloads.html, 頁面裡有語言包補丁的下載連結。

目前最新版為 1.11.0 下載地址: https://osdn.net/projects/tortoisesvn/storage/1.11.0/

在語言補丁包中我們可以找到中文的補丁並下載下來:

執行下載的 TortoiseSVN 安裝程式

執行下載的 TortoiseSVN 中文語言包

正確安裝後,應該進行一次的重開機,以確保 TortoiseSVN 的正確無誤。

修改 TortoiseSVN 預設語言

TortoiseSVN 安裝完後預設的介面是英文的,我們可以通過設定修改成已安裝語言


TortoiseSVN 的使用

建立一個 itread0101 的工作目錄

所謂的 itread0101 目錄其實就是您平常用來存放工作檔案的地方。通常我們會等到自己的工作做的一個段落的時候再進行備份。所以我們平常都是在 itread0101 目錄下面工作,等到適當時機在 commit 到 repository 中。舉例來說,我們想在 D 盤下面建立一個名為 itread0101 的目錄。首先先把這個目錄建立出來。

進入建立的目錄在空白處按下右鍵後(您可以在 MyWork 目錄的 icon 上按,也可進入 MyWork 目錄後,在空白的地方按),選擇 SVN checkout

接著您可以看到如下的畫面:

首先我們要填入的是 repository(版本庫)的位置,對於 SVN 來說,repository 的位置都是 URL。版本庫 URL 這裡填入我們測試的版本倉庫地址 svn://10.0.4.17/itread0101

接著,稍微看一下 Checkout directory(檢出至目錄),這個欄位應該要指向您的 itread0101 目錄。

確認後,按下 OK 按鈕,您應該可以看到如下的資訊視窗。

這樣就表示動作完成。按下 OK 按鈕後,再到您剛剛建立的目錄下。您將會看到 MyWork 目錄下面多了一個名為 .svn 的目錄(這個目錄是隱藏的,如果您的檔案管理員沒有設定可以看到隱藏目錄,您將無法看到它) 。

如果您要在一個已經存在的 SVN Server 上面 checkout 出上面的檔案,您只需要給定正確的 SVN URL 以及要 checkout 目錄的名稱。就可以取得指定的檔案及目錄了。


新增檔案及目錄到 Repository 中 add commit

建立目錄 dir01, 在目錄裡新增檔案

將新增的檔案加入到 SVN 版本控制中,TortoiseSVN 會把準備要加入的檔案及目錄,勾選需要加入的檔案。

按下 OK 後,您將會看到如下的訊息視窗:

這個 Add(增加)的動作並未真正的將檔案放到 Repository 中。僅僅是告知 SVN 準備要在 Repository 中放入這些檔案。 此時的檔案狀態為:

這些檔案真正的放入到 Repository 中,空白處右鍵選擇 SVN commit(提交) 緊接著,您將會看到如下的窗口出現:

在這裡可以清楚地瞭解到哪些檔案要被 commit 到 repository(版本庫)中。同樣的,如果您有檔案不想在這個時候 commit 到 Repository,您可以取消選取的檔案,這樣他們就不會被 commit 到 Repository 中。在"資訊"文字框中可以寫入對本次 commit 的說明。

點選"確認"後完成 commit 動作,然後您可以到 itread01 目錄中,確定是否所有的檔案 icon 都有如下的綠色勾勾在上面,這樣代表您的檔案都正確無誤的到 repository 中。


更新檔案及目錄 update

由於版本控制系統多半都是由許多人共同使用。所以,同樣的檔案可能還有人會去進行編輯。為了確保您工作目錄中的檔案與 Repository 中的檔案是同步的。建議您在編輯前都先進行更新的動作。

在想要更新的檔案或目錄 icon 上面按下滑鼠右鍵。並且選擇 SVN Update。

有時我們需要回溯至特定的日期或是版本,這時就可以利用 SVN 的 Update to revision 的功能。在想要更新的檔案或目錄 icon 上面按下滑鼠右鍵。並且選擇 TortoiseSVN->Update to revision(更新至版本)。


複製檔案及目錄 branch

很多時候您會希望有另外一個複製的目錄來進行新的編修。等到確定這個分支的修改已經完畢了,再合併到原來的主要開發版本上。舉例來說,我們目前在itread0101/trunk下面有如下的目錄及檔案:

現在,我們要為 trunk 這個目錄建立一個 branch。假設我們希望這個目錄是在 D:\itread0101\branch。首先我們可以在 trunk 目錄下面的空白處,或是直接在 trunk 的 icon 下面按下滑鼠右鍵選擇 Branch/Tag…(分支/標記)這個選項,您將會看到如下的對話框出現。

請先確認 From WC at URL(從工作副本/URL): 中的目錄是您要複製的來源目錄。接著,在 To URL(至路徑)中輸入您要複製過去的路徑。通常我們會將所有的 branch 集中在一個目錄下面。以上面的例子來說,branch 檔案都會集中在 branch 的子目錄下面。在 To URL 中您只需要輸入您要的目錄即可。目錄不存在時,會由 SVN 幫您建立。特別需要注意的是 SVN 因為斜線作為目錄分隔字元,而非反斜線。 接著在 Log message(日誌資訊)輸入您此次 branch 的目的為何。按下 OK 就可以了。

如果成功,將可以看到下面的畫面:

按下 OK 就可以關閉這個視窗了。如果您此時立刻去 itread0101 目錄的 branch 子目錄下面,您將會失望的發現在該目錄下面並沒有剛剛指定的目錄存在。這是因為您 itread0101 目錄的部份還是舊的,您只需要在 branch 子目錄下面進行 SVN update 就可以看到這個新增的目錄了。新增的目錄就與原來的目錄無關了。您可以任意對他進行編輯,一直到您確認好所有在 branch 下面該做的工作都完成後,您可以選擇將這個 branch merge 回原來的 trunk 目錄,或者是保留它在 branch 中。


合併動作 merge

假如我們在 branch 分支中對檔案進行了修改或增加了檔案,要 merge 回 trunk 目錄中,方法很簡單。以上面的例子來說,我們在 D:\itread0101\trunk目錄空白處,按下滑鼠右鍵,選擇 Merge(合併):

這個畫面主要分為三個部份,前面的 From: 與 To: 是要問您打算從 Branch 中的哪個版本到哪個版本,merge 回原來的 trunk 目錄中。因此,From 跟 To 的 URL 欄位應當都是指定原來 branch 的目錄下。剩下的就是指定要 merge 的 revision 範圍。以上面的例子而言,我們從 Branch 的 Revision 7 開始 merge 到 Branch 下面的最新版本。您可以透過,Dry run 按鈕,試作一次 Merge。這個 merge 只會顯示一些訊息,不會真正的更新到 trunk 的目錄去。只有按下 Merge 按鈕後,才會真正的將 branch 的檔案與 trunk 的檔案合併起來。

如果您確認這次的 merge 沒有問題,您可以直接使用 commit 來將這兩個被修改的檔案 commit 回 SVN repository 上。如果有問題,您可以直接修改這兩個檔案,直到確認 ok 了,再行 commit。


製作 Tag 或是 Release

所謂的 Tag 或是 Release 就是一個特別的版本,因為這個版本可能有特別的意義。例如:這個版本是特別的 Milestone 或是 release 給客戶的版本。其實,Tag 與 Release 的作法與 Branch 完全相同。只是 Branch 可能會需要 merge 回原來的 trunk 中,而 tag 及 release 大部分都不需要 merge 回 trunk 中。

舉例來說,今天我們的 trunk 做了一版,這個版本被認定是軟體的 1.0 版。 1.0版對於開發來說是一個非常重要的里程碑。所以我們要特別為他做一個標記,亦即 Tag。假設,這個 1.0 版是要正式 release 給客戶或是相關 vendor,我們要可以為他做一個 Release 的標記。基本上,SVN 只有目錄的概念,並沒有什麼 Tag 的用法。所以您會看到在 SVN 的選單上面,Branch 與 Tag 是同一個專案。以這個 1.0 的例子來說,我們在 itread0101 目錄下建立 tags 目錄用於存放打 tag 的版本,並提交到版本庫,然後在 Trunk 上面,按下滑鼠右鍵,選擇 Branch/Tag 的專案:

成功的話,您就在對應的 Tag 目錄下面建立了一個 v1.0 的目錄。當然,如果您這時到 Tag 的目錄下面去,會看不到這個目錄,您需要在 Tag 目錄下面 update 一下,才能看到它。