SVN使用說明-客戶端-TortoiseSVN篇資料

1、編制部門EPG批準(zhǔn)日期2008/1/22SVN使用說明 - 客戶端 -TortoiseSVN篇為方便項(xiàng)目人員使用Subversion（SVN ）配置管理系統(tǒng)，特編寫此手冊。概述TortoiseSVN 是一個輕松、直觀的客戶端，它讓開發(fā)人員直接從Windows的文件瀏覽器（ explorer）中操作，提供“點(diǎn)擊右鍵并按下（ point-and-click ）”的使用環(huán)境。術(shù)語及定義1.Check out簽出：指將庫中整個模塊首次導(dǎo)出到本地。2.Commit提交：將本地修改過的文件提交到庫中。3.Update更新：從庫下載其他人的修改過的文件。更新本地的拷貝。1TortoiseSVN 安裝與設(shè)置1

2、.1TortoiseSVN 安裝官方網(wǎng)站下載： /downloads內(nèi)網(wǎng)下載：軟件工程配置工具SVNTortoiseSVN-2137-win32-svn-1.4.6.msi點(diǎn)擊安裝程序 , 然后依次按確認(rèn)按鈕即可，安裝完畢后，重啟后就會和資源管理器集成，在右鍵菜單中出現(xiàn)，如圖：1.2為項(xiàng)目創(chuàng)建本地工作目錄如項(xiàng)目 1 的本地工作目錄為：D:workspaceproject1第1頁共17頁編制部門EPG批準(zhǔn)日期2008/1/222TortoiseSVN 的基本用法2.1工作空間首先，您需從配置庫（ repository）簽出（ check out）原始碼的一個版本到本地工作目錄。然后，您可以只編輯

3、想要改變的文件，也可以新增文件或是刪除不再需要的文件。當(dāng)您完成時，可以簽入（ Commit ）到庫中。如果在您修改時，其它人已經(jīng)改變了同一個文件，那么簽入（ commit ）會失敗。那么您必須從倉庫（ repository）更新（ Update）所有您的文件。這將其它開發(fā)人員的改變自動合并到您的文件副本里。但如果兩個人改變了同一行程序代碼或者修改的是二進(jìn)制文件（如 word、 excel 等），這將發(fā)生“沖突（ Conflict ）”，您必須手動解決沖突（見后面） 。2.2 簽出（ check out ）一個模塊第一次從配置庫獲得一個模塊，稱作簽出（checkout）。在工作目錄上按鼠標(biāo)右鍵，

4、 從彈出菜單中選擇SVNcheck out 菜單，如下圖：URLof repository: 為配置庫路徑checkout directory:為本地工作目錄其它一般按缺省設(shè)置。第 2 頁編制部門EPG批準(zhǔn)日期2008/1/222.3 Windows Explorer和 TortoiseSVNExplorer 中文件有不同的小圖標(biāo)覆蓋在上面，指出文件或是文件夾的 SVN 狀態(tài)：如未修改過的本地文件或文件夾是倉庫中最新版本。修改過的本地已經(jīng)被修改過，不同于目前的倉庫版本。文件或文件夾已經(jīng)被新增到SVN ，不過尚未新增的被簽入（ committed）。有沖突的本地與服務(wù)器的版本有沖突。不在 SVN

5、 上文件或文件夾不在倉庫里。您在 Windows Explorer 內(nèi)按鼠標(biāo)右鍵并從內(nèi)容菜單中選擇SVN 操作來與TortoiseSVN 互動。哪個文件和文件夾被執(zhí)行， 是根據(jù)您選了什么和您在哪里按鼠標(biāo)右鍵：第 3 頁編制部門EPG批準(zhǔn)日期2008/1/22此外，文件的屬性及Explorer 的 Detail View 中多了 SVN 的內(nèi)容。2.4 更新工作區(qū)從服務(wù)器取得變動的部分到您的本地副本的過程稱作“更新（ Updating）”。更新可能作用于文件、目錄上。若要更新，選擇您想要的文件或目錄，按鼠標(biāo)右鍵并選擇 SVN Update。對話框會蹦出并顯示當(dāng)它執(zhí)行時更新的過程。由其他人所做的變

6、動會被合并到您的文件之中，執(zhí)行更新（ update）對配置庫不會被影響。如果您在更新期間收到?jīng)_突提示，請先手工解決沖突。2.5 簽入變動到倉庫讓本地的修改在倉庫（ repository）有效稱作“簽入（ committing ）”。在簽入之前，您應(yīng)該做更新以確保沒有沖突（conflicts ）。要開始簽入您的變動，選擇您想要簽入（commit ）的文件或文件夾。在所選的文件或文件夾上按鼠標(biāo)右鍵，并選擇SVN Commit 。第 4 頁編制部門EPG批準(zhǔn)日期2008/1/22然后您將看到簽入對話框（ Commit Dialog ），在里面您可以簡短的總結(jié)您做了什么變動。您也可以不勾選（ unch

7、eck）它們的可選框（ checkboxes）來排除變動的文件，使其不被簽入。一旦您滿意您所簽入的東西，在對話框上按下 OK 來繼續(xù)進(jìn)行您的簽入（ commit）操作。請注意簽入變動不會自動地新增您已經(jīng)建立的本地新文件。 如何新增文件，詳見新增文件和目錄到倉庫中。第 5 頁編制部門EPG批準(zhǔn)日期2008/1/222.6 解決沖突有時候，當(dāng)您從倉庫（ repository）更新您的文件， SVN 服務(wù)器會報(bào)告沖突。當(dāng)二個或更多開發(fā)人員變動了一個文件的同一行，沖突會發(fā)生， 需要人工解決。在沖突文件上按鼠標(biāo)右鍵并選擇Edit Conflicts.，現(xiàn)在 TortoiseSVN 會啟動您在合并應(yīng)用程序

8、。解決每個沖突，儲存結(jié)果文件，并且退出合并應(yīng)用程序。2.7 新增文件和目錄到倉庫如果您已經(jīng)建立新文件或目錄， 您會注意到它們以 Not In SVN 狀態(tài)覆蓋的小圖標(biāo)顯示。要在 SVN 控制下放置新的文件或文件夾， 選擇您想要新增的項(xiàng)目，按鼠標(biāo)右鍵并從內(nèi)容菜單中選擇 SVN Add 來新增。您不需要煩惱一個文件是否是ASCII/Text ， Unicode/Text，或二進(jìn)制文件Binary），TortoiseSVN 會自動地檢測它。在新增操作被執(zhí)行后， 文件或文件小圖標(biāo)顯示為 “被改變了的 （ changed）”。這是因?yàn)樾略霰灰暈楸镜囟说淖儎?，且尚未被用到倉庫（ repository）上，

9、直到您簽入（ commit ）它們。此外，您可以使用 SVN Add Contents.命令來新增一些文件和目錄到SVN。此操作遞歸地往下到文件夾結(jié)構(gòu)里，并在Add Dialog 中顯示所有尚未新增（ unadded）的文件。在此您可以選擇可選框和取消可選框選您希望新增到SVN的文件和文件夾。第 6 頁編制部門EPG批準(zhǔn)日期2008/1/223TortoiseSVN 的進(jìn)階用法3.1鎖定文件按下鼠標(biāo)右鍵并選擇SVN Get lock。對于二進(jìn)制文件，如 doc、xls 等，可采用設(shè)置鎖的方式。這對于習(xí)慣于VSS模式的人員，也可用此方式。選定目錄 / 文件，文件菜單屬性 subversion 頁

10、， property 欄增加 svn:need-lock, 值可填 *以后改文件，需先 get lock ，如成功，則可修改并提交。否則可檢查狀態(tài)，看是被誰鎖住了。修改完后， commit 時系統(tǒng)默認(rèn)會自動解鎖。如果未修改，也可通過release lock來釋放鎖。3.2TAG 和 BranchTAG使得系統(tǒng)目前的狀態(tài)可以在未來被重新建構(gòu)。 SVN使用整體版本號， 每次提交都將使全局版本號加 1，Tag 可為全局版本號取個容易記憶的名稱。與CVS不同，它執(zhí)行非?？臁Ｔ?SVN中，標(biāo)記（ Tags）和分支（ Branch）的命令是在一起，說明兩者有相似之處。未修改的分支即為“標(biāo)記”，標(biāo)記修改后就

11、轉(zhuǎn)化為分支。作基線時，可通過標(biāo)記操作實(shí)現(xiàn)，將系統(tǒng)主干（ trunk ）復(fù)制到 tags 目錄下即可。如：1、選中 trunk 目錄2、右鍵 TortoiseSVN-tags/branches3、出現(xiàn)界面第 7 頁編制部門EPG批準(zhǔn)日期2008/1/22因此，項(xiàng)目目錄結(jié)構(gòu)中， 頂層必須符合規(guī)范， 設(shè)立 trunk 、tags 和 branches 目錄，否則將無法做基線。對于文件級的標(biāo)簽，雖然也可以通過 tags 操作，但效果不大好， 可在提交時寫在備注說明中，以后可在日志顯示中查到。3.3版本庫瀏覽器通過版本庫瀏覽器可對系統(tǒng)概貌有個全面的了解。如果想看文件，也可直接選中文件，右鍵，選擇打開功能

12、。注意：對于 word、 excel 等文件，應(yīng)選擇 open with ，然后選擇相應(yīng)的軟件打開。第 8 頁編制部門EPG批準(zhǔn)日期2008/1/223.4切換 (relocation)通過切換，可將版本庫地址切換到另一個地方。在使用分支時經(jīng)常用到。另外在內(nèi)外網(wǎng)切換時也可以通過此方式實(shí)現(xiàn)。為了內(nèi)外網(wǎng)使用同一地址，避免切換，也可在 C:WINDOWSsystem32driversetchosts 文件內(nèi)增加一行：62這樣無論內(nèi)外網(wǎng)都可統(tǒng)一使用一個地址了。注意事項(xiàng)：1、有卡巴斯基時， 獲取項(xiàng)目只能獲取到 svn 控制文件 , 卻不能獲取項(xiàng)目源文件 , 并且打開 svn 版本樹時 , 程序一直在運(yùn)行狀態(tài) , 不能打開樹目錄。解決方法 : 打開卡巴斯基設(shè)置 - 保護(hù) - 信息區(qū)域 - 信息程