svn使用教程:http://wiki.open.qq.com/wiki/SVN%E4%BD%BF%E7%94%A8%E6%8C%87%E5%BC%95%EF%BC%88%E6%9C%AC%E5%9C%B0%E6%9C%8D%E5%8A%A1%E5%99%A8%E4%B8%BAWindows%EF%BC%89
SVN使用指引(本地服務器為Windows)
1. 安裝SVN客戶端
使用SVN進行文件上傳前,請在您的本地PC上安裝SVN客戶端。推薦使用1.7版本的SVN客戶端。請不要升級到1.8版本,TortoiseSVN 1.8版本存在缺陷,可能會導致SVN同步異常。
本地服務器為Windows時,推薦使用TortoiseSVN,下載地址:http://sourceforge.net/projects/tortoisesvn/files/
下面的操作指引都以TortoiseSVN為例。
2. 創建本地目錄並連接到SVN庫
1. 在您的本地機器上新建一個目錄,例如“MyApp”,如下圖所示:
2. 進入該文件夾,鼠標右鍵點擊空白處,在郵件菜單中選擇“SVN Checkout...”,如下圖所示:
3. 在彈框里填入您的應用的SVN庫的路徑(你可能需要了解如何獲取SVN倉庫地址),彈框中的其它選項保持默認,如下圖所示:
4. 點擊彈框中的“OK”按鈕,首次登錄時要求輸入該SVN版本庫的用戶名和密碼(即應用的雲服務賬號和密碼,您可能需要了解如何查看雲服務賬號和密碼)。
登錄框如下圖所示:
注意不要勾選下面的“Save authentication”,原因是如果1個開發者有多個應用,則有多個SVN庫,保留1個SVN庫的登錄憑證可能會導致登錄別的SVN庫失敗。
如果失敗,請選擇右鍵菜單的“TortoiseSVN”->“Settings”->“Save Data”對話框中,點擊“Authentication data”旁的“Clear”按鈕,清除登錄憑證。 清除登錄憑證如下圖所示:
5. 通過驗證后,即開始從SVN庫中checkout該SVN庫里的所有文件。如下所示:
6. Checkout成功后,即可在本地機器“MyApp”目錄下看到該SVN庫下的所有文件。
注意,對於CEE SVN庫來說:
(1)如果輸入的SVN庫路徑是該應用的SVN庫地址,則checkout出該應用所有的WebService下的所有版本的代碼。MyApp目錄下是您的應用下所有的WebService的目錄,每個WebService是1個文件夾。
(2)如果你輸入的是您的應用的1個Web服務下的1個版本的SVN路徑,則只會checkout出該版本下的代碼。每個WebService下是所有的版本目錄,每個版本是1個文件夾。
(3)在您還沒有上傳任何代碼到SVN庫之前,這里checkout出來的只是目錄,版本目錄下是沒有文件的(除了自動生成的.svny文件夾以及index.html )。
3. 提交文件
1. 將您需要提交的復制到本地對應的目錄下。
例如您需要將文件“test2.php”上傳到Web服務“helloc”下的版本“1”里,則需要將您的應用程序復制到“MyApp/10507/helloc/1”目錄下。如下圖所示:
2.右鍵點擊文件“test2.php”,選擇“TortoiseSVN -> Add”菜單,即將剛才復制的代碼添加到SVN工作目錄中。
(只要是新增了文件,在提交前都必須先“add”,否則SVN不識別該文件) 如下圖所示:
add成功后,該文件的圖標變成藍色的十字,如下圖所示:
3. 然后右鍵點擊文件“test2.php”,選擇“SVN Commit..”菜單,然后填寫本次提交的日志(必填項,不填將導致提交失敗),即將剛才復制的代碼提交到SVN工作目錄中。
如下圖所示:
4. 提交成功后,該文件的圖標會變為綠色的對勾,如下圖所示:
4. 修改文件
1. 您可以直接在本地使用編輯器打開SVN工作目錄下的某個文件並進行修改,修改完成后,可以看到該文件的圖標變成紅色的感嘆號,如下圖所示:
2. 右鍵點擊該文件,選擇“SVN Commit...”,並填寫本次提交的日志(必填項,不填將導致提交失敗),即將該更新提交到SVN庫。
3. 對於CEE SVN庫來說,對於當前生效版本,我們強烈建議您在提交前需保證所做的修改已經通過了測試,以避免影響現網服務。
5. 歷史版本回滾
SVN服務器天然支持版本管理,因此如果開發者需要對某些歷史版本進行回滾,可以直接在SVN客戶端上進行歷史版本回滾操作,將歷史版本的目錄或文件下載到本地服務器,然后再提交到SVN服務器即可。
詳細說明如下:
1. 在需要進行歷史版本回滾的目錄或文件上,點擊右鍵,選擇菜單“TortoiseSVN”->“Show log”,如下圖所示:
2. 在打開的“Log Messages”面板中,右鍵選中你要回滾的版本,在出現的右鍵菜單中選擇“Revert to this revision”,即可執行回滾操作。如下圖所示:
3. 回滾成功后,本地的目錄或文件就被歷史版本的目錄或文件替代,可看到其圖標變成紅色的感嘆號。
4. 開發者需要將該目錄或文件提交到SVN服務器上,即右鍵選中該目錄或文件,然后選擇菜單中的“SVN Commit...”將文件提交到服務器。提交成功后,即完成歷史版本的回滾。
6. 刪除文件
步驟如下:
1. 在需要刪除的目錄或文件上,點擊右鍵,選擇菜單“TortoiseSVN”->“Delete”,如下圖所示:
2. 點擊“Delete”后,可以看見本地已經不存在該文件或目錄。
3. 右鍵點擊已刪除文件原來所在的目錄,選擇“SVN Commit...”,並填寫本次提交的日志(必填項,不填將導致提交失敗),提交到SVN庫。
7. 其它操作
SVN的操作與一般的SVN操作是一致的,這里不再列舉,您可以參考SVN手冊。