TortoiseSVN快速使用手冊.doc

安裝順序：1. TortoiseSVN-6974-win32-svn-1.6.5.msi2. LanguagePack_6974-win32-zh_CN.msi安裝及下載client 端下載Windows 端程序：/downloads。一般而言，如果是32-bit的Windows XP 應(yīng)該使用TortoiseSVN-1.4.x.xxxx-win32-svn-1.4.x.msi 這個檔案。如果是64-bit 的操作系統(tǒng)，則應(yīng)該使用TortoiseSVN-1.4.x.xxxx-x64-svn-1.4.x.msi 這個檔案。執(zhí)行下載回來的TortoiseSVN 安裝程序，就會進行TortoiseSVN 的安裝。正確安裝后，應(yīng)該進行一次的重開機，以確保TortoiseSVN 的正確無誤。安裝成功后，在檔案管理員內(nèi)按下鼠標(biāo)右鍵，應(yīng)該可以看到如下的畫面：大部分的TortoiseSVN的操作都是透過檔案管理員及鼠標(biāo)右鍵就可以完成了。如果您之前使用過TortoiseCVS，應(yīng)該會對這種操作方式感到十分親切。什么是SVN（Subversion）?有一個簡單但不十分精確比喻：SVN = 版本控制 + 備份服務(wù)器簡單的說，您可以把SVN當(dāng)成您的備份服務(wù)器，更好的是，他可以幫您記住每次上傳到這個服務(wù)器的檔案內(nèi)容。并且自動的賦予每次的變更一個版本。通常，我們稱用來存放上傳檔案的地方就做Repository。用中文來說，有點像是檔案倉庫的意思。不過，通常我們還是使用Repository這個名詞?；旧希谝淮挝覀冃枰幸粋€新增(add)檔案的動作，將想要備份的檔案放到Repository上面。日后，當(dāng)您有任何修改時，都可以上傳到Repository上面，上傳已經(jīng)存在且修改過的檔案就叫做commit，也就是提交修改給SVN server的意思。針對每次的commit，SVN server都會賦予他一個新的版本。同時，也會把每次上傳的時間記錄下來。日后，因為某些因素，如果您需要從Repository下載曾經(jīng)提交的檔案。您可以直接選擇取得最新的版本，也可以取得任何一個之前的版本。如果忘記了版本，還是可以靠記憶嘗試取得某個日期的版本。為甚么要用SVN?備份工作檔案是十分重要的。您永遠不知道計算機上的硬盤何時會壞掉。根據(jù)經(jīng)驗法則再加上摩菲定理，壞事情往往都發(fā)生在最重要的時刻。例如，要release東西的前一刻，硬盤完全壞掉，無法修復(fù)。所以，常常備份工作數(shù)據(jù)是非常重要的。大部分公司的server都會有專門的備份機制，甚至是異地備援。絕對比放在自己的計算機里頭，或是隨身碟上面來的安全。版本控管非常重要。您無法保證手頭上最新版本永遠都是對的。很多時候，在經(jīng)過數(shù)天努力工作后，您才發(fā)現(xiàn)走錯方向。需要將所有的修改回復(fù)到數(shù)天前版本。沒有幾個人能夠完全記住自己修改過什么東西。如果沒有做好版本控管，那么，最差的狀況就是要全部重來。伙伴間的數(shù)據(jù)同步也是非常重要的。很多時候，除了您個人外，還有其它的伙伴也需要您的檔案。怎么把最新的檔案提供給伙伴呢？用e-mail？根據(jù)經(jīng)驗，用e-mail是一個很差的辦法。到了最后，根本就不知道哪一封e-mail才是新的。因為可能您最新的e-mail已經(jīng)被當(dāng)成垃圾信給丟了。別忘了，現(xiàn)在很多e-mail軟件都有anti-spam的功能，說不定這些信件都被當(dāng)成廣告信給處理掉了。而且，您也應(yīng)該知道一般檔案如果放在e-mail內(nèi)，檔案大小會變得比較大（通常是原來的4/3倍以上）。如果每天更新一次，恐怕幾天沒收信的話，信箱就爆了！如果沒有一個好的辦法，備份不同版本是很耗費硬盤空間的。例如：您有一個總共10MB的目錄，使用單純的檔案備份。如果有10個版本就會變成100MB。20個版本就有200MB。如果，不想備份這么多版本，勢必就是要減少備份的次數(shù)。拉長備份周期將會導(dǎo)致數(shù)據(jù)遺失的危險性增高。把舊的不需要的備份刪除？根據(jù)經(jīng)驗，只要時間一拉長，您跟本就不知道一個月以前的版本是重要或者是不重要。SVN能幫我們解決上面的問題嗎？答案是肯定的：SVN Repository可以是自己計算機上的一個目錄，或者是隨身碟（不建議這樣用）。當(dāng)然也可以是公司的服務(wù)器。SVN有很棒的版本控管機制。所有上傳的版本都會幫您記錄下來。日后您可以隨時取得某一個時刻的版本。而且，也有版本分支及合并等好用的功能。SVN可以讓不同的開發(fā)者存取同樣的檔案，并且利用SVN Server作為檔案同步的機制。也就是說，您有檔案更新時，無須將檔案寄給您的開發(fā)成員。只需要告訴他新的版本已經(jīng)在SVN Server上面，請他自己去SVN Server上面就可以取得最新版本。而且，SVN Server也可以做到當(dāng)您上傳新版本后，自動發(fā)信給相關(guān)的成員。SVN的存放檔案方式是采用差異備份的方式。也就是說，他只會備份有不同的地方。所以很省硬盤空間。此外，他也可以針對所謂的非文字文件進行差異備份。怎么樣在Windows下面建立SVN Repository？假設(shè)您已經(jīng)安裝前面所提及的TortoiseSVN這套軟件，現(xiàn)在我們先告訴您如何用自己的硬盤或是隨身碟當(dāng)作SVN Repository的存放地點。如果您只想知道如何存取一個已經(jīng)建立好的SVN Server上面的Repository，請直接跳過本節(jié)。假設(shè)您的要放置Repository的地方是E槽。您需要先建立一個空的目錄。以下面的例子而言，我們在E槽下面建立了一個名為svn_repo的目錄。SVN并沒有限定Repository目錄名稱。您可以建立任何您自己喜歡的名稱。但是，強烈建議勿使用非英文的檔名(如中文或日文)。透過您的檔案管理員，在E:svn_repo的Icon上面，按下鼠標(biāo)右鍵后，選擇TortoiseSVN-Create repository here。接著，您會看到如下的一個窗口，這個窗口主要是問您，您希望使用的Repository數(shù)據(jù)庫格式是FSFS還是BDB?；旧希堖x擇FSFS就可以了。按下OK按鈕后，您將可以看到下一個畫面。這就表示您的SVN repository已經(jīng)成功的建立了。接下來就是要把您的檔案備份進來。日后，只要需要使用這個repository，我們就可以使用file:/E:/SVN_REPO表示它。SVN就是透過這種URL的方式到如何與Repository取得聯(lián)系。各種URL的格式如下：file:/磁盤驅(qū)動器|/repository所在目錄/子目錄http:/賬號服務(wù)器名稱/ repository所在目錄/子目錄https:/賬號服務(wù)器名稱/ repository所在目錄/子目錄svn+ssh:/賬號服務(wù)器名稱/ repository所在目錄/子目錄其中，http表示使用一般的超文字傳輸通訊協(xié)議。https表示使用加密的超文字傳輸通訊協(xié)議。svn+ssh表示透過SSH加密通訊的管道，進行存取。建立一個Working目錄所謂的Working目錄其實就是您平常用來存放工作檔案的地方。通常我們會等到自己的工作做的一個段落的時候再進行備份。所以我們平常都是在Working目錄下面工作，等到適當(dāng)時機在commit到repository中。舉例來說，我們想在D槽下面建立一個名為working的目錄。首先先把這個目錄建立出來。此時，這個目錄應(yīng)該為空的。在檔案管理員中按下右鍵后(您可以在working目錄的icon上按，也可進入working目錄后，在空白的地方按)，選擇SVN checkout。接著您可以看到如下的畫面：首先我們要填入的是repository的位置，對于SVN來說，repository的位置都是URL。由于我們前面已經(jīng)在E槽建立一個repository，因此，我們現(xiàn)在要在URL of repository這一欄填入file:/E:/svn_repo/。接著，稍微看一下Checkout directory，這個字段應(yīng)該要指向您的working目錄。確認(rèn)后，按下OK按鈕，您應(yīng)該可以看到如下的訊息窗口。這樣就表示動作完成。按下OK按鈕后，再到您剛剛建立的目錄下。您將會看到working目錄下面多了一個名為.svn的目錄(這個目錄是隱藏的，如果您的檔案管理員沒有設(shè)定可以看到隱藏目錄，您將無法看到它) 。SVN會在您的工作目錄下，以及其子目錄下建立這個.svn的子目錄。您不應(yīng)該進去這個目錄，尤其不應(yīng)該更動這個目錄下面的任何內(nèi)容。否則會很可能會造成SVN無法正常運作。由于，原來的repository是空的，所以我們現(xiàn)在的working目錄也是空的。如果您現(xiàn)在checkout的是一個已經(jīng)有內(nèi)容的repository，您將會看到working目錄下面現(xiàn)在多了許多目錄及檔案。如果您要在一個已經(jīng)存在的SVN Server上面checkout出上面的檔案，您只需要給定正確的URL以及working目錄的名稱。就可以取得指定的檔案及目錄了。新增檔案及目錄到Repository中假設(shè)您前面的動作都無誤。現(xiàn)在您開始開發(fā)一個新的程序。假設(shè)您開發(fā)的程序?qū)⒎旁谇懊娼⒌膚orking目錄下面的my_ prj子目錄。如下所示： 假設(shè)您已經(jīng)編輯好檔案，準(zhǔn)備把他們放到SVN的repository中。您需要在my_prj目錄的icon上面，按鼠標(biāo)右鍵，并且選擇TortoiseSVN-Add：接著，TortoiseSVN會把準(zhǔn)備要加入的檔案及目錄，顯示給您看。打勾的就是等下要被加入到Repository中的。如果您有某些檔案或是目錄不想在這次加入，您可以讓該項目不要被勾選。如此，它就不會被加入到Repository去。按下OK后，您將會看到如下的訊息窗口：這樣就表示成功了。有一點要注意的是，這個Add的動作并未真正的將檔案放到Repository中。僅僅是告知SVN準(zhǔn)備要在Repository中放入這些檔案。此時，如果您透過檔案管理員查看這些檔案，應(yīng)該會看到一個白色紅底的驚嘆號在檔案icon的下方。這是表示您的working目錄中的檔案與Repository中的檔案還沒有同步。現(xiàn)在我們要多一個commit的動作。讓這些檔案真正的放入到Repository中。您可以在my_prj目錄的icon上或者是my_prj目錄內(nèi)的空白處按下鼠標(biāo)右鍵，叫出如下的選單，并且選擇SVN commit。緊接著，您將會看到如下的窗口出現(xiàn)：在這個窗口中，下半部會列出一個清單，讓您清楚的了解到哪些檔案要被commit到repository中。同樣的，如果您有檔案不想在這個時候commit到Repository，您可以取消選取的檔案，這樣他們就不會被commit到Repository中。在檔案列表的上方是Message欄，您可以在欄中輸入本次commit的目的。這是十分重要的字段，當(dāng)您commit的次數(shù)很多時，可以靠這個訊息知道版本與版本之間的差異。當(dāng)您輸入好Message，按下OK之后，就可以看到如下的窗口出現(xiàn)，通知您已經(jīng)將指定的檔案送到Repository中。您可以到先前的folder中，確定是否所有的檔案icon都有如下的綠色勾勾在上面，這樣代表您的檔案都正確無誤的到repository中。有時候，因為Windows本身的問題，您可能會看到有些icon沒有變成綠色的勾勾。此時，多按F5幾次，應(yīng)該就可以解決這個問題。如果，仍然不行，表示您之前的commit動作真的有問題。請仔細檢查之前的commit動作是否正確。更新檔案及目錄為何需要更新？由于版本控制系統(tǒng)多半都是由許多人共同使用。所以，同樣的檔案可能還有人會去進行編輯。為了確保您工作目錄中的檔案與Repository中的檔案是同步的。建議您在編輯前都先進行更新的動作。在此，我們都先假設(shè)您已經(jīng)將檔案check out過一次?，F(xiàn)在要說明的是如何在一個check out過的目錄進行update。在想要更新的檔案或目錄icon上面按下鼠標(biāo)右鍵。并且選擇SVN Update。 正常的狀況下，您可以看到如上的窗口。在這個窗口中會顯示有哪些文件更新了。如果沒有看到檔案更新的相關(guān)信息，這表示您的目錄中的檔案已經(jīng)是最新的，所以無須進行更新。更新至特定版本有時我們需要回溯至特定的日期或是版本，這時就可以利用SVN的Update to revision的功能。在想要更新的檔案或目錄icon上面按下鼠標(biāo)右鍵。并且選擇TortoiseSVN-Update to revision。 在這個Update窗口中，您可以選擇更新到最新版本(HEAD)。也可以選擇更新到某個指定的版本(Revision)。當(dāng)然，您可能早就記不起來正確的版本號碼?？赡苤浑[約的記得大概在什么時間。沒關(guān)系，按下Show log按鈕，您就可以回顧歷史了。所有您曾經(jīng)做過的動作，及其日期與對應(yīng)的版本都會列在這個窗口上面，只要在你想要的版上面點一下，讓他變成反白，然后按下OK。這個版本就會自動填入Update窗口中的Revision字段中。您只要再按下一次OK，這個版本就會被取出來到您的硬盤中。復(fù)制檔案及目錄很多時候您會希望有另外一個復(fù)制的目錄來進行新的編修。等到確定這個分支的修改已經(jīng)完畢了，再合并到原來的主要開發(fā)版本上。舉例來說，我們目前在working copy下面有如下的目錄及檔案：現(xiàn)在，我們要為trunk這個目錄建立一個branch。假設(shè)我們希望這個目錄是在D:workingmy_prjbranchmy_new_branch_for_testing。首先我們可以在trunk目錄下面的空白處，或是直接在trunk的icon下面按下鼠標(biāo)右鍵。在選擇Branch/Tag這個項目后，您將會看到如下的對話框出現(xiàn)。請先確認(rèn)From WC at URL: 中的目錄是您要復(fù)制的來源目錄。接著，在To URL中輸入您要復(fù)制過去的路徑。通常我們會將所有的branch集中在一個目錄下面。以上面的例子來說，branch檔案都會集中在branch的子目錄下面。在To URL中您只需要輸入您要的目錄即可。目錄不存在時，會由SVN幫您建立。特別需要注意的是SVN因為斜線作為目錄分隔字符，而非反斜線。接著在Log message輸入您此次branch的目的為何。按下OK就可以了。如果成功，將可以看到下面的畫面：按下OK就可以關(guān)閉這個窗口了。如果您此時立刻去working copy的branch子目錄下面，您將會失望的發(fā)現(xiàn)在該目錄下面并沒有剛剛指定的目錄存在。這是因為您working copy的部份還是舊的，您只需要在branch子目錄下面進行SVN update就可以看到這個新增的目錄了。新增的目錄就與原來的目錄無關(guān)了。您可以任意對他進行編輯，一直到您確認(rèn)好所有在branch下面該做的工作都完成后，您可以選擇將這個branch merge回原來的trunk目錄，或者是保留它在branch中。要merge回trunk目錄中，方法很簡單。以上面的例子來說，我們在D:workingmy_prjtrunk目錄空白處，按下鼠標(biāo)右鍵，選擇Merge:接著可以看到如下的畫面：這個畫面主要分為三個部份，前面的From: 與 To: 是要問您打算從Branch中的哪個版本到哪個版本，merge回原來的trunk目錄中。因此，F(xiàn)rom跟To的URL字段應(yīng)當(dāng)都是指定原來branch的目錄下。剩下的就是指定要merge的revision范圍。以上面的例子而言，我們從Branch的Revision 7開始merge到Branch下面的最新版本。您可以透過，Dry run按鈕，試作一次Merge。這個merge只會顯示一些訊息，不會真正的更新到trunk的目錄去。只有按下Merge按鈕后，才會真正的將branch的檔案與trunk的檔案合并起來。上面的訊息告訴我們在trunk目錄下面的yyyy.cpp及xxx1.cpp已經(jīng)被更改過了。如果您在現(xiàn)在到trunk目錄下，會看到這兩個檔案處于被修改的狀態(tài)。如果您確認(rèn)這次的merge沒有問題，您可以直接使用commit來將這兩個被修改的檔案commit回SVN repository上。如果有問題，您可以直接修改這兩個檔案，直到確認(rèn)ok了，再行commit。 一切順利的話，您就成功的將branch的檔案merge回trunk了。制作Tag或是Release所謂的Tag或是Release就是一個特別的版本，因為這個版本可能有特別的意義。例如：這個版本是特別的Milestone或是release給客戶的版本。其實，Tag與Release的作法與Branch完全相同。只是Branch可能會需要merge回原來的trunk中，而tag及release大部分都不需要merge回trunk中。舉例來說，今天我們的trunk做了一版，這個版本被認(rèn)定是軟件的1.0版。1.0版對于開發(fā)來說是一個非常重要的里程碑。所以我們要特別為他做一個標(biāo)記，亦即Tag。假設(shè)，這個 1.0版是要正式release給客戶或是相關(guān)vendor，我們要可以為他做一個Release的標(biāo)記。基本上，SVN只有目錄的概念，并沒有什么Tag的用法。所以您會看到再SVN的選單上面，Branch與Tag是同一個項目。以這個1.0的例子來說，我們就是在Trunk上面，按下鼠標(biāo)右鍵，選擇Branch/Tag的項目： 成功的話，您就在Tag目錄下面建立了一個1.0的目錄。當(dāng)然，如果您這時到Tag的目錄下面去，會看不到這個目錄，您需要在Tag目錄下面update一下，才能看到它。 制作Release的作法與Tag完全相同。只是把Tag的目錄換成Release而已。看到這里，相信大家都已經(jīng)領(lǐng)悟到無論是Branch，Tag或是Release都只是將指定的Trunk版本復(fù)制一份到另外一個目錄去。至于這個目錄要叫Branch還是叫Release，SVN根本就不管。所以，您也可取其它的目錄名稱。不過，Branch，Tag及Release已經(jīng)是SVN上面約定成俗的名稱。所以，除非您知道自己為何這樣做，否則，最好還是follow這個命名原則，以免后面新加入的人看不懂。NOTE：同樣的道理Trunk也只是一個約定成俗的名稱。不一定要叫Trunk。只是大家看到Trunk目錄就會知道這里面放的是主要的開發(fā)主干?？焖賲⒖记懊鎸懥瞬簧購U話，主要是給完全沒有版本控制觀念的人看的。如果你想直接知道某個功能如何使用，請看下面的章節(jié)。在后面的說明，皆以d:working當(dāng)作工作目錄。您可以將他換成其它任何您想要的目錄。取得(Checkout)R