要在Subversion(SVN)這種控制系統，要在Eclipse IDE中使用Subversion，必須裝載Subversion插件，也就是Subclipse插件，本文介紹Subclipse插件的安裝和使用。

安裝Subclipse

安裝Subclipse的最好方法是使用Eclipse Update Manager。在Eclipse 3.1中，它位于Help -> Software Updates -> Find and Install...菜單下。請選擇Search，查找要安裝的新特性，并以http://subclipse.tigris.org/update作為URL添加New Remote Site。

圖1：使用Eclipse Update Manager安裝Subclipse

掃描完更新后，您會看到一個可用特性的列表。我寫這篇文章時，Subclipse 0.9.33是最新的更新版本。

圖2：選擇最新的Subclipse更新版本

 在接下來的界面中，會請求用戶接受許可證并選擇安裝位置。建議不要將新插件（包括Subclipse）安裝在默認的Eclipse安裝目錄下，最好將其放在一個外部擴展位置中。這會使手動卸載這些特性更加容易，如果需要的話；同時也使插件可以在多個版本的Eclipse安裝之間共享，比如發行版、嘗鮮(early access)穩定版（M1、M2等等）和集成IDE版本。

圖3：選擇安裝位置

此時，Update Manager已下載并安裝了所選特性，然后請求重啟Eclipse。

一旦重啟Eclipse，用戶就會在Preference對話框中看到一個新的SVN區域，并且還會看到有關Subversion活動的其他視圖。可以使用Window -> Show View -> Other...菜單將這些視圖添加到Java Perspective中。

圖4：添加關于Subversion活動的視圖

我通常將SVN Repository視圖添加到Quick Views中，而將SVN Resource History添加到位于Java Perspective工作區底部的一個標簽組中。這樣，在開發過程中，這兩個視圖就近便可用了，同時也便于利用拖放來運行某些任務，比如“獲得資源歷史”（從諸如Navigator、Package Explorer、SVN Repository和Synchronize之類的面向資源的視圖到SVN Resource History視圖）。

#p#

在Subclipse中配置SVN接口

可以配置Subversion服務器來使用下列協議之一：

•SVN協議，一種輕量級的有狀態協議，由獨立的Subversion服務器（svnserve）所使用。安全版本svn+ssh使用基于ssh的隧道。 •http協議，基于WebDAV擴展，通常被作為模塊部署在Apache HTTP服務器上。安全版本使用https，dev2dev CodeShare上的Subclipse安裝使用的就是該協議。 •file協議，用于訪問本地可用的Subversion庫（例如，共享驅動器上的Subversion庫），它是最少選擇的庫。 　　Subclipse使用專門的適配器抽象化來利用上述協議。可以在Window -> Preferences -> Team -> SVN對話框的插件屬性中選擇下列適配器中的一種。

圖5：選擇適配器

每一種適配器都有其自身的優點：

•JavaSVN是惟一完全基于Java的Subclipse客戶端，是默認支持的。注意，JavaSVN不支持file:///協議。 •JavaHL是包裝本地Subclipse API的瘦包裝器。該適配器是為Win32平臺預構建的，但是在其他所有的平臺上必須手動構建（除非Unix發行版中包含它）。 •命令行適配器，只有在不能安裝JavaHL并且Subclipse庫使用file:///協議時才可以使用。 　　大多數情況下都可以使用JavaSVN；只有需要時才選擇JavaHL或命令行適配器。參考資料小節中的鏈接可以幫助解決特定用例，如配置HTTP代理、SSL客戶端證書，等等。

連接到CodeShare上的SVN庫

現在就可以連接到Subversion庫了。對于dev2dev CodeShare上的項目，可以在訪問選項頁面中看到一個庫的URL，可以從Version控制項目菜單中找到該頁面。 這里是一個例子 。CodeShare SVN服務器要求用戶使用的用戶名和口令與其在dev2dev網站上所使用的相同。

圖6：連接到Subversion庫

如果連接參數設置正確，就可以看到一個SSL證書確認對話框。

圖7：接受SSL證書

接受證書后，應該就可以瀏覽庫并查看現有項目。

圖8：查看SVN庫中的現有項目

現在已經準備好，要開始使用Subversion和Subclipse插件了！

#p#

查看SVN中的現有項目

在SVN Repository視圖中可以看到，在許多CodeShare項目以及使用Subversion的其他項目中都可以看到一種共同的布局，通常如下所示：

https://xjms-ra.projects.dev2dev.bea.com/svn/xjms-ra
   +-- branches
       +-- www
       +-- xjms-ra
           +-- mqseries (work in progress)
           +-- activemq
   +-- tags
       +-- xjms-ra
           +-- 0.0.1 (stable versions or releases)
           +-- 0.0.2
   +-- trunk
       +-- www     (project web site)
       +-- xjms-ra (project source)

trunk文件夾中包含主線開發源代碼；tags文件夾中包含穩定版或發行版；branches文件夾中包含來自替代開發線上的代碼。在Subversion中，標簽和分支僅僅是選中的源代碼快照的版本化副本。若想獲得更多詳細內容，請參閱Subversion book。

可以在SVN Repository視圖中選擇當前項目的主線或者特定的標簽或分支，并從彈出菜單中選擇Check Out As...動作。接著就會出現一個指導性的標準New Project Wizard，它允許用戶選擇項目類型（例如，Java或Simple Project）、項目名稱和位置，并在需要時配置Java build路徑。

為新的CodeShare項目配置SVN庫

版本控制庫是任何項目的基礎架構的重要部分，對于開源項目（包括CodeShare上的項目）而言，它還在開發人員與其他社區成員之間的交流中起著重要作用。例如，它允許終端用戶為最新的代碼捐獻補丁，并為重要的修復提供早期更新機制。由于它的重要作用，為一個新項目配置SVN庫并從一開始就將所有的項目代碼置于版本控制之下就顯得非常重要了。

創建了新CodeShare項目之后，SVN庫就包含了trunk、tags和branches文件夾，以及trunk下的www模塊，它包含項目Web首頁的index.html文件。可以在SVN Repository視圖中驗證這些，并使用該視圖中的彈出菜單上的動作創建缺少的文件夾。

我們假設所有的源代碼、build腳本、文檔和其他項目資源被組織為一個Eclipse項目，那么就可以在Package Explorer或Navigator視圖中使用彈出菜單中的Team -> Share Project...動作。Share Project Wizard會要求用戶選擇SVN庫類型，然后在下一個頁面中，可以選擇一個現有庫或配置一個新庫。

圖9：在Share Project Wizard中選擇SVN庫類型

在接下來的界面中指定模塊名。為了與CodeShare項目布局相匹配，我們應該在trunk文件夾下創建模塊，因此，指定trunk/<project name>作為模塊名，比如trunk/xjms-ra。

圖10：指定模塊名

經過確認后，Subclipse會創建模塊，并將所有的項目文件導入SVN庫。

#p#

使用SVN庫

當項目連接到SVN庫以后，在Package Explorer和Navigator視圖中會彈出一個Team菜單，顯示特定于Subversion的全部動作。可以直接運行Commit、Update、Add to svn:ignore，以及Version Control with Subversion一書中所描述的其他動作。該書中的內容也可以在Help -> Help Contents -> Version Control with Subversion下的Eclipse幫助系統中找到。

Subclipse插件還允許使用Eclipse的Team Synchronize視圖，它可以使用戶從庫中清楚地觀察到哪些項將要提交、哪些項已經被其他開發人員更改并需要更新。從這個Synchronize視圖中還可以執行大多數的SVN命令。

可以使用彈出的Team -> Synchronize with Repository菜單或位于主工具欄上的Synchronize...向導按鈕將項目或工作集添加到Synchronize視圖中。如果看不到該按鈕，那么請將Team命令添加到當前視圖中；可以使用Customize Perspective對話框添加，該對話框可從主工具欄上的彈出菜單中獲得（單擊任意空白處），然后，使用Window -> Save Perspective As...菜單以相同的名稱保存透視圖。

圖11：將命令組添加到當前透視圖中

在工具欄下拉菜單中選擇Synchronize...動作來啟動向導。在第一個界面中，它又讓用戶選擇SVN版本跟蹤系統，然后會顯示標準資源選擇面板，用戶可以選擇同步整個工作區，也可以選擇某組項目或者一個指定的工作集。

圖12：同步工作區、工作集或選中的資源

一旦完成創建，Synchronize視圖就可以使用版本控制系統安排自動刷新的時間。可以通過Synchronize視圖菜單中的Schedule...菜單對其進行配置。這將有助于用戶保持最新狀態，還可以看到其他開發人員所做的所有改動。

圖13：安排自動刷新的時間

由于Subclipse仍在發展，所以用戶可能會遇到bug或者無法找到真正希望獲得的一些特性。這帶我們進入下一個話題。

#p#

修補Subclipse

當在Subclipse中遇到問題時，可以有多種選擇。如果是瑕疵問題，那么可以簡單地選擇不使用該產品或等待下一個版本。還可以搜索問題跟蹤系統以及郵件列表檔案user@subclipse.tigris.org和dev@subclipse.tigris.org，有可能找到當前問題的應對措施或解釋。如果這樣沒有幫助，那么可以在郵件列表中咨詢此問題；如果有興趣試著自己解決，那么，下面的段落將簡要介紹如何開始調試和修補Eclipse。但是，如果非常希望有所捐助，那么一種好的方法是訂閱dev@subclipse.tigris.org郵件列表，從而使您所做的努力與其他開發人員相協調，根據項目路線圖調整您的想法。

著手開始真的非常容易，即使您以前從沒有使用過Eclipse插件。需要將Subclipse項目放入Eclipse工作區中。Subclipse項目的Subversion庫位于http://subclipse.tigris.org/svn/subclipse/，可以使用以前安裝的Subclipse插件或者諸如命令行Subversion客戶端或TortoiseSVN之類的外部工具來查看代碼。還有一種非常好的辦法是在tigris.org Web站點上注冊，并請求Subclipse項目的Observer角色。然后，就可以使用相同的用戶名連接到Subversion庫了（也可以用“guest”/“guest”進行只讀訪問），還可以在問題跟蹤器（一個集成的Bugzilla庫）上發表評論，并附上對問題的補丁（如果有的話）。

一旦連接到版本控制庫，就需要在自己的工作區中檢查下述項目。對每一個模塊選擇Check Out As...，選擇一個位置和項目名（建議使用下表所列出的實際的插件名），并單擊Finish。

對于開發和測試，只需要org.tigris.subversion.subclipse.core, org.tigris.subversion.subclipse.ui以及org.tigris.subversion.javahl.win32或svnClientAdapter;其他的模塊僅在打包整個插件特性或構建更新站點時需要。

當所有的項目都在Eclipse工作區中之后，就可以試著運行了。使用Run -> Run...菜單（或Debug，在調試器下運行），啟動新的Eclipse Application類型，并在Workspace Plug-Ins列表中選擇Subclipse插件。如果使用已安裝的Subclipse運行IDE，那么應該在External Plug-Ins列表中取消對Subclipse插件的選擇，但是要使其他插件均保持選中狀態。

圖14：運行Eclipse應用程序

單擊Run（或Debug），如果一切都配置正確，那么就會出現第二個Eclipse Workbench窗口；應該可以打開Subclipse視圖，并像Eclipse本身的實例一樣連接到庫。此時，如果是在調試器下運行，就可以開始將斷點放到Subclipse類、或Subclipse所使用的Eclipse核心類中，調試器會停在這些斷點上。一個非常好的起點是org.tigris.subversion.subclipse.ui插件中的org.tigris.subversion.subclipse.ui.actions包，它包括菜單或工具欄中特定于Subclipse的UI動作。注意，可以使用UI注冊這些動作，可以在plugin.xml中聲明式地注冊（通常是action元素），或者是在Java代碼中編程式地注冊，因此，這兩個地方都要查看。

#p#

假定已經完成了最棘手的部分，并且已經設法實現了更改，那么現在就該創建補丁并將其附在Subclipse 問題跟蹤庫中的原始問題上了。在創建補丁以前，請確保從版本控制庫中選擇最新的更改（如果有的話），并最后一次測試更改。如果一切都沒有問題，那么就使用Team -> Create Patch...菜單來啟動向導。選擇Save To Clipboard或Save In File System，并指定是否需要對子目錄進行循環掃描來查看更改。

圖15：創建補丁

創建了補丁之后，就可以將其發送至dev@subclipse.tigris.org郵件列表了，或者也可以在問題跟蹤器中創建問題并將其附上。

結束語

諸如Subclipse插件之類的Eclipse平臺開源擴展可以提高開發人員的生產力，降低出錯的可能性，并增強開發團隊內部的交流。本文演示了如何安裝、配置和使用Subclipse插件來從Eclipse IDE內部與Subversion版本控制系統進行交互。

以Subclipse插件為例，本文還演示了如何設置一個環境以進行Eclipse插件開發、如何調試現有插件、如何創建補丁。事實上，任何Eclipse用戶都可以為該開源擴展以及Eclipse平臺本身捐獻想法和補丁。

【編輯推薦】

1. Domino提供Eclipse的快速應用程序開發工具
2. Eclipse 3.6 M7發布 可自定義Java代碼風格
3. Eclipse啟動新計劃：通用的SOA平臺