SVN 命令

   

          svn(subversion)是近年來崛起的版本管理工具，是cvs的接班人。目前絕大多數開源軟件都使用svn作爲代碼版本管理軟件。下面介紹一下如何在Xcode上使用SCM配置源代碼版本控制SVN的方法與技巧：

     Code內置版本控制客戶端SCM，可作爲SVN客戶端。前兩天組裏自己搭SVN服務器沒有弄成，可能是網絡配置問題，索性就申請了googlecode節點，用google提供的SVN服務器了。不過，前提是所有的代碼都要開源。還有就是申請之前還需要一個gmail帳號，至於如何申請，搜一下，很多答案。申請完後別忘了把團隊成員（都需要有gmail帳號）加入進來。

現在，只剩下客戶端配置了。程序員的日常版本控制操作一般是：

import --> checkout --> commit -->update

import :導入工程文件到SVN服務器。在本地建好工程文件後，第一次從客戶端上傳工程文件至SVN服務器

checkout :簽出工程文件到客戶機本地。第一次從SVN服務器上下載工程文件到客戶機本地。

commit : 提交客戶機本地的改動到SVN服務器。客戶端本地在對代碼進行修改後，將修改提交到服務器。如果服務器的版本被團隊裏的其他人更新了，那麼commit之前會提示需要先update一下。

update: 將SVN服務器上的最新版本同步到客戶端。

-----------------

很好理解，import與checkout是一組操作，用在第一次操作時。而commit和update是一組操作，分別對應2個不同方向的操作。

-----------------

1、Checkout 操作

假如SVN上已經有團隊裏其他人上傳的工程項目文件，我們需要checkout到客戶端本地。按下列圖示操作：

首先用gmail帳號登錄申請的googlecode節點，取到SVN服務器的連接串（紅字標明的部分）

緊接着我們需要知道與google SVN服務器連接的密碼，這個密碼並不是gmail帳號的密碼，而是由google幫你自動生成的，我們需要在gmail帳號的profile中找到這個隨機生成的密碼。點擊右上角的Profile，然後選中"Setting"

這時頁面顯示錯誤，這是乍整的呢？我們打開一個在線代理網頁，重新訪問我們的googlecode節點（我選擇默認S1代理仍然出不來，我換了一個S2就OK）

可以看到GOOGLE爲我們生成的SVN服務器訪問密碼，也可以按“Regenerate”按鈕隨機生成另一個密碼

打開Xcode，無需創建任何項目，直接選擇SCM菜單上的"Configure SCM Repositories"
點擊左下角的"+"號新建一個SCM配置文件，起個名字“snb”，然後填入剛纔我們找到的googlecode節點的SVN服務器連接串，以及連接帳號、密碼

接下來我們就可以Checkout代碼了

選擇代碼的本地存放路徑，checkout完成後，可以直接打開工程代碼了

接下來還需要一步：將該工程與SCM配置文件綁定在一起。首先雙擊工程名打開工程配置，選擇"Configure Roots &SCM..."按鈕

指定我們在SCM裏設計的配置文件名snb，這樣就將該工程與snb配置文件綁定在一起了。

2、Commit操作

首先，我們假如對checkout下來的代碼進行了修改，加入了一行註釋，然後我們要將更改發佈到svn服務器，可以選擇SCM菜單的“Commit Entire Project”進行提交

注意，有變更的文件都會出現在SCM分支下，可以顯示自上次update以來，本地修改的代碼文件

在commit時我們可以添加一些說明，在這一步出現了一個提交錯誤信息。不知道是什麼原因，總之我試着把https連接方式改爲了http方式就OK了，而且我發現後面出現的Error:175002 (RA layer request failed) Server sent unexpected return value(405 Method Not Allowed)

錯誤我也是用這種方式解決的，就是又把http改回https方式，真有意思！

在googlecode站點我們看到已經commit成功

3、Update操作

假如在另一臺機器上commit了一個版本，在googlecode上可以看到這個記錄，然後我們準備update到客戶端本地，選擇SCM菜單的“Update Entire Project”就OK了，更新完後我們看到代碼添加的部分

4、import操作

也很簡單，選擇SCM中的Repositories，然後選擇Import按提示操作即可（在這個菜單中可以對SVN服務器上文件進行管理，比如創建目錄和刪除文件操作等等）

import成功！

下面附上一些SVN命令：

 1、將文件checkout到本地目錄

svn checkout path（path是服務器上的目錄）

例如：svn checkout svn://192.168.1.1/pro/domain 

簡寫：svn co

 2、往版本庫中添加新的文件

svn add file 

例如：svn addtest.php(添加test.php) 

svn add *.php(添加當前目錄下所有的php文件)

 3、將改動的文件提交到版本庫

svn commit -m “LogMessage“ [-N] [--no-unlock] PATH(如果選擇了保持鎖，就使用–no-unlock開關)

例如：svn commit -m “add test file for my test“ test.php

簡寫：svn ci

4、加鎖/解鎖 

svn lock -m “LockMessage“ [--force] PATH

例如：svn lock -m “lock test file“ test.php

svn unlock PATH

 5、更新到某個版本

svn update -r m path

例如： 

svn update如果後面沒有目錄，默認將當前目錄以及子目錄下的所有文件都更新到最新版本。 

svn update -r 200 test.php(將版本庫中的文件test.php還原到版本200) 

svn update test.php(更新，於版本庫同步。如果在提交的時候提示過期的話，是因爲衝突，需要先update，修改文件，然後清除svn resolved，最後再提交commit) 

簡寫：svn up

6、查看文件或者目錄狀態

1）svn status path（目錄下的文件和子目錄的狀態，正常狀態不顯示） 

【?：不在svn的控制中；M：內容被修改；C：發生衝突；A：預定加入到版本庫；K：被鎖定】

2）svn status -v path(顯示文件和子目錄狀態)

第一列保持相同，第二列顯示工作版本號，第三和第四列顯示最後一次修改的版本號和修改人。

注：svn status、svn diff和 svn revert這三條命令在沒有網絡的情況下也可以執行的，原因是svn在本地的.svn中保留了本地版本的原始拷貝。 

簡寫：svn st

 7、刪除文件

svn delete path -m “delete test fle“

例如：svn delete svn://192.168.1.1/pro/domain/test.php -m “delete test file” 

或者直接svn delete test.php 然後再svn ci -m ‘delete test file‘，推薦使用這種

簡寫：svn (del, remove, rm)

8、查看日誌

 svn log path

例如：svn log test.php 顯示這個文件的所有修改記錄，及其版本號的變化

9、查看文件詳細信息 

svn info path

例如：svn info test.php

 10、比較差異

svn diff path(將修改的文件與基礎版本比較)

例如：svn diff test.php 

svn diff -r m:n path(對版本m和版本n比較差異)

例如：svn diff -r 200:201 test.php

簡寫：svn di

   11、將兩個版本之間的差異合併到當前文件

svn merge -r m:n path 

例如：svn merge -r 200:205 test.php（將版本200與205之間的差異合併到當前文件，但是一般都會產生衝突，需要處理一下）

 12、SVN 幫助

svn help

svn help ci

——————————————————————————

 

以上是常用命令，下面寫幾個不經常用的

 

——————————————————————————

13、版本庫下的文件和目錄列表

svn list path

顯示path目錄下的所有屬於版本庫的文件和目錄 

簡寫：svn ls

 14、創建納入版本控制下的新目錄

svn mkdir: 創建納入版本控制下的新目錄。

用法: 

 1、mkdir PATH…

  2、mkdir URL… 

創建版本控制的目錄。

1、每一個以工作副本 PATH 指定的目錄，都會創建在本地端，並且加入新增調度，以待下一次的提交。

2、每個以URL指定的目錄，都會透過立即提交於倉庫中創建。在這兩個情況下，所有的中間目錄都必須事先存在。

15、恢復本地修改

svn revert: 恢復原始未改變的工作副本文件 (恢復大部份的本地修改)。revert:

用法: revert PATH…

注意: 本子命令不會存取網絡，並且會解除衝突的狀況。但是它不會恢復被刪除的目錄

16、代碼庫URL變更

svn switch (sw): 更新工作副本至不同的URL。

用法: 1、switch URL [PATH]

 2、switch –relocate FROM TO [PATH...]

 1、更新你的工作副本，映射到一個新的URL，其行爲跟“svn update”很像，也會將服務器上文件與本地文件合併。這是將工作副本對應到同一倉庫中某個分支或者標記的方法。

2、改寫工作副本的URL元數據，以反映單純的URL上的改變。當倉庫的根URL變動(比如方案名或是主機名稱變動)，但是工作副本仍舊對映到同一倉庫的同一目錄時使用這個命令更新工作副本與倉庫的對應關係。

17、解決衝突

svn resolved: 移除工作副本的目錄或文件的“衝突”狀態。 

用法: resolved PATH…

注意: 本子命令不會依語法來解決衝突或是移除衝突標記；它只是移除衝突的相關文件，然後讓 PATH 可以再次提交。

18、輸出指定文件或URL的內容。

svn cat 目標[@版本]…如果指定了版本，將從指定的版本開始查找。

svn cat -r PREV filename > filename (PREV 是上一版本,也可以寫具體版本號,這樣輸出結果是可以提交的)