SVN客戶(hù)端圖形使用

1、 目 錄第一章引言11.1Subversion的介紹11.2Subversion的特性11.3SVN鏈接模式21.4SVN操作流程3第二章SVN使用42.1SVN軟件安裝42.2事業(yè)部SVN庫(kù)介紹42.2.1事業(yè)部SVN庫(kù)42.2.2帳號(hào)注冊(cè)、權(quán)限申請(qǐng)52.3基本操作52.3.1操作介紹52.4系統(tǒng)規(guī)范使用182.4.1規(guī)范操作182.4.2版本控制的使用192.4.3與目錄無(wú)關(guān)內(nèi)容192.4.4文件夾目錄名稱(chēng)規(guī)范202.4.5文件上傳格式212.4.6文件、數(shù)據(jù)放置212.5日常使用問(wèn)題212.5.1版本庫(kù)無(wú)響應(yīng)212.5.2郵件中的路徑鏈接212.5.3系統(tǒng)庫(kù)最上層打不開(kāi)222.5.4提交

2、失?。–ommit fail）222.5.5SVN文件夾無(wú)法下載232.5.6特征圖標(biāo)的顯示232.5.7沖突問(wèn)題解決24SVN使用規(guī)范第一章 引言1.1 Subversion的介紹SVN是Subversion的縮寫(xiě)。Subversion管理隨時(shí)改動(dòng)的文件和目錄，以二進(jìn)制格式存儲(chǔ)所有的文件，使用高效的比較二進(jìn)制差異算法來(lái)計(jì)算版本之間的改動(dòng)。同時(shí)，它是一個(gè)時(shí)間機(jī)器，隨時(shí)記錄文件和目錄的每次改動(dòng)，例如：文件的增加、刪除、重新排列文件等。同時(shí)SVN允許你恢復(fù)以前舊版本的數(shù)據(jù)，或者檢查數(shù)據(jù)變化的歷史。SVN使用類(lèi)似數(shù)據(jù)庫(kù)事物的方式來(lái)處理用戶(hù)提交入庫(kù)的過(guò)程，整個(gè)改動(dòng)要么成功的被提交，要么被中斷并回滾。在

3、數(shù)據(jù)提交完之前，其他人是看不到用戶(hù)提交的修改文件，你看到的要么是改動(dòng)之前的狀態(tài)，要么是改動(dòng)之后的狀態(tài)。這樣的行為被稱(chēng)為“原子提交”。原子提交很有用，因?yàn)樗鼙ＷC所有相關(guān)人員看到的總是相同的東西。原子提交過(guò)程的其中一步就是包括把你的所有改動(dòng)打包為一個(gè)“修訂集”（有時(shí)被稱(chēng)為改動(dòng)集），并且再給個(gè)改動(dòng)標(biāo)記的修訂號(hào)（綠色勾變?yōu)榧t色嘆號(hào)）。1.2 Subversion的特性1.2.1 版本化的目錄 Subversion實(shí)現(xiàn)了一個(gè)可以跟蹤目錄樹(shù)更改的“虛擬”版本化文件系統(tǒng)，文件和目錄都是有版本的。1.2.2 真實(shí)的版本歷史 通過(guò)Subversion你可以對(duì)文件或是目錄進(jìn)行增加、拷貝和改名操作，也可以新增一個(gè)

4、具有干凈歷史的文件?？梢院敛豢鋸埖膶⒚恳粋€(gè)版本都可以作為一個(gè)記憶片段定點(diǎn)。1.2.3 原子提交版本庫(kù)采用二進(jìn)制差異形式提交修改的數(shù)據(jù)內(nèi)容，一系列的改動(dòng)，要么全部提交到版本庫(kù)，要么一個(gè)也不提交，這樣可以讓用戶(hù)構(gòu)建一個(gè)需要提交修改的邏輯塊，放置部分修改提交到版本庫(kù)。1.2.4 一致的數(shù)據(jù)操作Subversion表示文件是建立在二進(jìn)制文件區(qū)別算法基礎(chǔ)上的，對(duì)于文本（可讀）和二進(jìn)制（不可讀）文件具備一致的草所方式，兩種類(lèi)型的文件都?jí)嚎s存放在版本庫(kù)中。1.3 SVN鏈接模式其中本地工作副本與SVN系統(tǒng)鏈接的媒介是“.svn”隱藏文件夾，.svn隱藏文件夾中包含了系統(tǒng)鏈接、版本等信息，圖1-1為本地工作副

5、本與SVN系統(tǒng)鏈接后狀態(tài)，綠色勾代表文件受系統(tǒng)控制（后面簡(jiǎn)稱(chēng)：受控）標(biāo)志，紅色嘆號(hào)為受控文件改動(dòng)標(biāo)志。圖1-1 鏈接狀態(tài)1.4 SVN操作流程WorkingCopyWorkingCopyRepositoryNetwork版本庫(kù)網(wǎng)絡(luò)本地工作副本檢出、提交圖1-2 操作流程圖圖1-2總體概括了SVN整個(gè)操作過(guò)程：首先用戶(hù)從版本庫(kù)通過(guò)網(wǎng)絡(luò)“檢出”到本地工作副本中，然后，在本地工作副本中進(jìn)行增加、修改、刪除文件后“提交”到版本庫(kù)中，如果本地工作副本中版本較系統(tǒng)版本過(guò)時(shí)，用戶(hù)使用“更新”功能與系統(tǒng)上版本保持一致。第二章 SVN使用2.1 SVN軟件安裝SVN的安裝軟件是公司受控軟件，用戶(hù)安裝需要由各單位

6、文員走軟件安裝的OA流程，在接到流程申請(qǐng)后電腦中心安排陽(yáng)光服務(wù)安裝。如果SVN軟件在電腦重裝系統(tǒng)后被卸載掉，請(qǐng)用戶(hù)直接聯(lián)系電腦中心（內(nèi)線(xiàn)：63333）處理。2.2 SVN庫(kù)介紹2.2.1 SVN庫(kù)2.2.2 操作介紹1. 系統(tǒng)登錄點(diǎn)擊鼠標(biāo)右鍵出現(xiàn)功能選項(xiàng)，選擇“TortoiseSVN”中的“版本庫(kù)瀏覽器”，這時(shí)系統(tǒng)彈出URL界面，用戶(hù)在URL中輸入需要進(jìn)入的庫(kù)路徑，彈出登錄認(rèn)證框，用戶(hù)輸入用戶(hù)名和密碼進(jìn)入系統(tǒng)主界面。 圖2-1(a) 系統(tǒng)登錄圖2-1(b) 認(rèn)證界面圖2-1(c) public庫(kù)系統(tǒng)界面圖2-1（a）和圖2-1（b）是系統(tǒng)登錄操作界面，圖2-1（c）是系統(tǒng)的主界面，三副圖中整體

7、描述了SVN系統(tǒng)的登錄情況。注：圖2-1（b）中“Save authentication”是保存認(rèn)證選項(xiàng)，用戶(hù)根據(jù)需要對(duì)自己的用戶(hù)名和密碼進(jìn)行保存，以便在下次操作時(shí)不需要再次輸入用戶(hù)名和密碼了。2. 設(shè)置功能的使用在上節(jié)類(lèi)容中主要講述了系統(tǒng)的登錄方式和認(rèn)證保存的方法，接下來(lái)繼續(xù)講述系統(tǒng)“設(shè)置（Setting）”功能的使用。在設(shè)置中，用戶(hù)可以根據(jù)需要選擇系統(tǒng)的語(yǔ)言顯示、清除已保存的數(shù)據(jù)、顯示特征標(biāo)志等等。（1） 系統(tǒng)語(yǔ)言顯示選擇圖2-2 系統(tǒng)語(yǔ)言中-英文轉(zhuǎn)換系統(tǒng)安裝后全部默認(rèn)為英文模式，這時(shí)需要用戶(hù)手動(dòng)切換到中文模式。圖2-2中描述了中英文切換的過(guò)程，在選擇“設(shè)置（Setting）”功能后彈出的

8、對(duì)話(huà)框自動(dòng)顯示語(yǔ)言欄（Language），用戶(hù)選擇“中文（簡(jiǎn)體）”后確認(rèn)即可。（2） 忽略上傳文件SVN系統(tǒng)有一個(gè)似過(guò)濾器的功能，在本地工作副本中用戶(hù)可以根據(jù)需要過(guò)濾一些不需要上傳到服務(wù)器的文件，這個(gè)功能就是“全局忽略樣式”。圖2-3（a） 全局忽略樣式忽略樣式對(duì)提交文件擴(kuò)展名進(jìn)行選擇性忽略，忽略格式通常以*.X形式被系統(tǒng)識(shí)別，例如：用戶(hù)不需要將編譯產(chǎn)生的.o和.err文件提交到SVN上，這時(shí)用戶(hù)在全局忽略樣式中輸入*.o *.err如圖2-3（a），各條目之間以空格分隔。注意：當(dāng)用戶(hù)在本地工作副本中對(duì)新添加文件采用了系統(tǒng)添加功能操作，忽略樣式功能對(duì)本地副本中的文件將不起作用，如圖2-3(b)

9、表藍(lán)色加號(hào)表示文件已添加；另外還有一種情況，如果已經(jīng)將想忽略的文件提交到了SVN系統(tǒng)上，是無(wú)法進(jìn)行忽略的。圖2-3（b） 添加文件樣式（3） 保存清除在對(duì)系統(tǒng)保存認(rèn)證后相應(yīng)需要對(duì)認(rèn)證進(jìn)行清除，清除功能仍然在設(shè)置模塊中，界面如圖2-4。在保存清除中共可以對(duì)本地四種已保存數(shù)據(jù)進(jìn)行清除，分別有URL歷史記錄、日志信息、窗口大小、認(rèn)證數(shù)據(jù)，在對(duì)這些數(shù)據(jù)完全清理后系統(tǒng)自動(dòng)恢復(fù)到“零”狀態(tài)。因此，用戶(hù)在離機(jī)后也別忘記將保存認(rèn)證數(shù)據(jù)清除掉，以保障資料的安全性。圖2-4(a) 認(rèn)證清除圖2-4(b) 密碼清除（4） 特征標(biāo)志選擇不少用戶(hù)在使用SVN“檢出”功能后，本地工作副本沒(méi)有出現(xiàn)特征符號(hào)綠色勾或其他特征符

10、號(hào)，這是由于系統(tǒng)無(wú)法識(shí)別默認(rèn)的狀態(tài)緩存，需要人工手推選擇狀態(tài)緩存方式，改變狀態(tài)緩存方法如圖2-5，在設(shè)置中選擇“外觀與樣式”的“圖標(biāo)疊加”模塊，再在“狀態(tài)緩存”中選擇“Windows外殼”。圖2-5 特征顯示設(shè)置中其他不常用的功能不再進(jìn)行一一介紹，用戶(hù)可以根據(jù)日常操作實(shí)踐來(lái)理解。3. 在SVN系統(tǒng)上進(jìn)行日常工作SVN系統(tǒng)不支持直接在系統(tǒng)上對(duì)文件修改的操作。如果有受控文件需要修改，用戶(hù)可以通過(guò)在本地工作副本中修改后提交到系統(tǒng)上，這中間的媒介就是.svn隱藏文件夾，系統(tǒng)的整個(gè)操作范圍：“檢出”“提交”“更新”，接下來(lái)給大家詳細(xì)介紹各操作。（1）本機(jī)文件夾與服務(wù)器文件夾之間的鏈接首先，在本地電腦新建

11、一個(gè)文件夾，并給文件夾重新命名；然后，鼠標(biāo)選擇文件夾，點(diǎn)擊右鍵選擇“檢出（Checkout）”功能,使用檢出功能后本地文件夾有一個(gè)綠色的勾，稱(chēng)之為本地“工作副本”。圖2-6（a）中黃色框?yàn)镾VN路徑選擇區(qū)域，綠色框?yàn)楸镜芈窂竭x擇區(qū)域，用戶(hù)根據(jù)需要在后面按鈕處選擇相關(guān)下載路徑。圖2-6（b）中為系統(tǒng)文件夾檢出到本地后的狀態(tài)。 圖2-6（a） SVN檢出按鈕圖2-6（b） SVN檢出視圖另外，用戶(hù)還可以在系統(tǒng)界面直接檢出需要文件夾到本地，在服務(wù)器界面選擇需要下載文件夾如圖2-6（c），然后點(diǎn)擊右鍵選擇“檢出”功能再繼續(xù)按照以上操作即可。注：用戶(hù)需要注意“檢出”功能只針對(duì)系統(tǒng)文件夾，對(duì)于系統(tǒng)中單個(gè)文

12、件是不能夠使用檢出的。圖2-6（c） 界面SVN檢出（2）日常操作上傳SVN當(dāng)創(chuàng)建了本地工作副本后，可以在副本中進(jìn)行任何日常操作，如：增加文件夾、文件、修改文件、數(shù)據(jù)等，用戶(hù)每天下班前將需要本地副本中做的修改提交（Commit）到SVN上，確保服務(wù)器上數(shù)據(jù)與本地副本中的數(shù)據(jù)保持同一版本。需要強(qiáng)調(diào)的是，雖然用戶(hù)在本地創(chuàng)建了工作副本，但如果所有執(zhí)行操作沒(méi)有提交到SVN上，一旦本機(jī)數(shù)據(jù)丟失，將無(wú)法追溯。用戶(hù)在提交時(shí)需要注意兩點(diǎn)，如圖2-7： 選擇提交無(wú)版本控制選項(xiàng)，避免出現(xiàn)新增文件漏提現(xiàn)象； 日志備注的填寫(xiě)，方便后續(xù)對(duì)文件的追溯。圖2-7 SVN提交（3）文件修改差異比較SVN系統(tǒng)有一個(gè)非常適用的功

13、能“修改差異的比較”，可以將本次修改內(nèi)容和原稿作比較并顯示出來(lái)，圖2-8（a）為提交版本與修改前差異比較方法，圖2-8（b）為追溯歷史版本之間差異的比較方法。圖2-8（a） 修改差異比較圖2-8（b） 追溯差異比較1圖2-8（b） 追溯差異比較2（4）歷史追溯SVN系統(tǒng)的記憶猶如時(shí)間片段的集合，每一個(gè)版本代表了一個(gè)時(shí)間定點(diǎn)，當(dāng)用戶(hù)需要回顧或追溯之前的某一個(gè)時(shí)間節(jié)點(diǎn)時(shí)，通過(guò)系統(tǒng)的日志顯示（show log）功能來(lái)實(shí)現(xiàn)。通俗一點(diǎn)講，十五部的SVN系統(tǒng)正是一部錄制過(guò)程中的電影，每一個(gè)用戶(hù)提交的內(nèi)容都是勞動(dòng)集成點(diǎn)的片段，當(dāng)某一天用戶(hù)需要回憶某個(gè)記憶點(diǎn)時(shí)，可以結(jié)合圖2-9的操作來(lái)實(shí)現(xiàn)。在看圖2-9之前，

14、 先回到2-8（b）的過(guò)程中，選擇了顯示日志功能列表中有一個(gè)專(zhuān)用“瀏覽版本庫(kù)”功能，用戶(hù)通過(guò)這個(gè)功能可以回到之前任意一個(gè)版本時(shí)代。圖2-9 歷史記錄追溯（5）系統(tǒng)自帶的搜索功能SVN系統(tǒng)自帶強(qiáng)大的搜索功能，用戶(hù)可以通過(guò)選擇日志信息、路徑、作者、版本號(hào)查詢(xún)所需版本文件。具體操作步驟如下：第一步：選擇需要查找的目錄，右鍵選擇“顯示日志”功能，彈出圖2-10（a）界面。第二步：如果日志信息在100條以上，需要選擇左下角的“全部顯示”或“下100”按鈕。圖2-10（a）日志顯示 第三步：從對(duì)話(huà)框右上角的放大鏡窗口選擇需要搜索的信息，例如：需要查詢(xún)zhaoxizu提交的文件，在對(duì)話(huà)框中輸入zhaoxiz

15、u回車(chē)即可，如圖2-10（b）。圖2-10(b) 系統(tǒng)自帶搜索（6）SVN輔助功能使用SVN輔助系統(tǒng)主要應(yīng)用于public、project、office三個(gè)庫(kù)中，功能主要包括用戶(hù)密碼的修改、使用記錄查詢(xún)、文件搜索三個(gè)模塊。 客戶(hù)端界面登錄用戶(hù)通過(guò)IE瀏覽器輸入路徑 :8080 進(jìn)入圖2-11界面，然后輸入SVN用戶(hù)名和密碼登錄管理系統(tǒng)。圖2-11 輔助功能登錄界面 其他輔助功能的使用進(jìn)入管理系統(tǒng)界面后，用戶(hù)根據(jù)需要來(lái)修改密碼和搜索文件等等。圖2-12 密碼修改2.3 系統(tǒng)規(guī)范使用SVN系統(tǒng)的日常使用一律按照SVN使用管理辦法執(zhí)行。2.3.1 規(guī)范操作日常文件更新一律

16、按照“檢出提交”的方法，用戶(hù)需要在本地創(chuàng)建工作副本，在本地修改后提交到SVN系統(tǒng)上，不允許直接將文件拉到系統(tǒng)上，圖2-13中列舉用戶(hù)操作不規(guī)范現(xiàn)象。 2-13 使用不規(guī)范現(xiàn)象2.3.2 版本控制的使用文件的追溯性主要表現(xiàn)在文件的版本提交控制情況，一個(gè)文件或數(shù)據(jù)的成型可能經(jīng)歷上百個(gè)版本修改。因此，只要使用好版本控制，不僅節(jié)省腦力勞動(dòng)，而且提高了工作效率，當(dāng)日文件修改后提交過(guò)程中日志備注是必不可少的。圖2-14 版本控制管理2.3.3 與目錄無(wú)關(guān)內(nèi)容SVN系統(tǒng)平臺(tái)是事業(yè)部各人員日常工作平臺(tái)，提交的文件和數(shù)據(jù)均是工作相關(guān)內(nèi)容，因此不允許用戶(hù)將私人照片、電影等不相關(guān)內(nèi)容上傳。另外在project庫(kù)中研

17、發(fā)工程師需按照PQE項(xiàng)目質(zhì)量擬定的基線(xiàn)目錄提交相關(guān)內(nèi)容，圖2-15中列舉了M6車(chē)型中上傳F3項(xiàng)目的不規(guī)范現(xiàn)在。圖2-15 使用不規(guī)范目錄2.3.4 文件夾目錄名稱(chēng)規(guī)范用戶(hù)在提交日常文件成功后，系統(tǒng)會(huì)自動(dòng)精確到秒的記錄用戶(hù)所有操作，因此，用戶(hù)在日志備注中注明提交原因和較詳細(xì)的描述修改的地方，不需要在文件夾名后添加文件修改日期，圖2-16中形象的表現(xiàn)了用戶(hù)在文件夾后加日期不規(guī)范現(xiàn)象。圖2-16 文件夾帶日期不規(guī)范現(xiàn)象2.3.5 文件上傳格式日常更新的文件、數(shù)據(jù)不能轉(zhuǎn)換成PDF、壓縮包等格式提交；文件不用壓縮，不能設(shè)置密碼。2.3.6 文件、數(shù)據(jù)放置 文件、數(shù)據(jù)不允許重復(fù)放置。2.4 日常使用問(wèn)題2

18、.4.1 版本庫(kù)無(wú)響應(yīng)在版本庫(kù)瀏覽器中輸入SVN路徑后系統(tǒng)處于無(wú)響應(yīng)狀態(tài)。解決方法：檢查SVN路徑是否輸入正確，如果正確，請(qǐng)用戶(hù)確認(rèn)路徑和符號(hào)是否在英文模式下輸入的，如果不是請(qǐng)將其修改為英文模式。導(dǎo)致原因：由于SVN現(xiàn)階段只支持全英文狀態(tài)路徑，因此用戶(hù)在輸入路徑時(shí)要注意。2.4.2 郵件中的路徑鏈接直接點(diǎn)擊郵件中的鏈接地址為何打不開(kāi)文件？導(dǎo)致原因：輸入路徑太長(zhǎng)，OE（Outlook Express）中只默認(rèn)到一定字節(jié)數(shù)，導(dǎo)致點(diǎn)擊鏈接文件無(wú)法達(dá)到底層目錄或直接發(fā)生鏈接錯(cuò)誤。解決方法：在OE中選擇“插入”“超級(jí)鏈接”“URL”，將全部路徑粘貼進(jìn)URL中，接收方在點(diǎn)擊鏈接后能順利打開(kāi)文件。如圖2-1

19、7：圖2-17 outlook路徑輸入模式2.4.3 系統(tǒng)庫(kù)最上層打不開(kāi)導(dǎo)致原因： 網(wǎng)絡(luò)不通； 使用IE代理； 路徑輸入錯(cuò)誤.問(wèn)題解析：用戶(hù)要清楚一點(diǎn)，所有系統(tǒng)帳號(hào)，最上層是一定能打開(kāi)的，除非你沒(méi)有SVN帳號(hào)。一旦發(fā)現(xiàn)上述情況，用戶(hù)首先是檢查路徑的正確性。如果路徑正確，請(qǐng)確認(rèn)是否存是由以下兩種因素引起的。（1）首先，請(qǐng)檢查網(wǎng)絡(luò)是否連通；（2）其次，檢查是否使用了網(wǎng)絡(luò)代理，由于Apache關(guān)系，用戶(hù)在使用代理后是無(wú)法登錄SVN的。2.4.4 提交失敗（Commit fail）（1） 文件提交不上圖2-18 文件無(wú)法提交導(dǎo)致原因：綠框內(nèi)記錄了問(wèn)題點(diǎn)存在的直接原因，當(dāng)用戶(hù)提交文件時(shí)，系統(tǒng)提示路徑不存

20、在，該路徑指代的是系統(tǒng)上與本地鏈接的路徑已經(jīng)不存在。此時(shí)，用戶(hù)首先確認(rèn)是否對(duì)服務(wù)器上相應(yīng)目錄名稱(chēng)做過(guò)改動(dòng)，或者是將該目錄移植、刪除。（2）沒(méi)有權(quán)限看到報(bào)錯(cuò)信息中包含以上信息（Commit fail）時(shí)，請(qǐng)聯(lián)系SVN管理員處理權(quán)限配置。2.4.5 SVN文件夾無(wú)法下載如果一個(gè)文件夾內(nèi)容的無(wú)法下載，導(dǎo)致原因有兩種：（1）文件名末尾有空格解決方法：將文件名稱(chēng)的空格去除，再執(zhí)行下載操作。（2）本地目錄中已下載相同路徑（如以下圖片）在本機(jī)中已存在“.svn”路徑的目錄下繼續(xù)下載第二個(gè)目錄是不可執(zhí)行的操作，如圖2-19。解決方法：如果真需要繼續(xù)在本目錄中下載其他文件夾，用戶(hù)在該目錄下新建一個(gè)文件夾后再執(zhí)行檢出操作，以新建目錄為本地副本。圖2-19 目錄無(wú)法下載2.4.6 特征圖標(biāo)的顯示明明是檢出了，受控文件（夾）為何沒(méi)有綠色勾？導(dǎo)致原因：由于個(gè)別電腦無(wú)法識(shí)別SVN默認(rèn)選擇的Default，因此電腦在檢出后沒(méi)有綠色勾特征。解決方法：在設(shè)置中的Icon Overlays 中選擇