Subversion (SVN)是一個版本控制系統(tǒng)，是CVS的極具競爭力的替代品。它支持CVS所缺少的一些重要特性，比如版本化的重命名、目錄和元數(shù)據(jù)；還支持原子提交和通過HTTP/HTTPS的遠(yuǎn)程訪問。許多開源項(xiàng)目使用Subversion作為版本控制系統(tǒng)，其中包括BEA的dev2dev CodeShare 站點(diǎn)上的項(xiàng)目。 有一個簡短的指南介紹了如何為CodeShare建立支持Windows的命令行SVN客戶端和Tortiose SVN。然而，使用自己的IDE中的Subversion庫才有意義。
本文描述如何在Eclipse IDE中使用Subversion，具體來說，介紹了Subclipse插件的安裝和使用。順著這個思路，我還將展示如何使用產(chǎn)生的配置來修改或擴(kuò)展Subclipse插件本身。
安裝Subclipse的最好方法是使用Eclipse Update Manager。在Eclipse 3.1中，它位于Help -> Software Updates -> Find and Install...菜單下。請選擇Search，查找要安裝的新特性，并以http://subclipse.tigris.org/update作為URL添加New Remote Site。
掃描完更新后，您會看到一個可用特性的列表。我寫這篇文章時，Subclipse 0.9.33是最新的更新版本。
在接下來的界面中，會請求用戶接受許可證并選擇安裝位置。建議不要將新插件（包括Subclipse）安裝在默認(rèn)的Eclipse安裝目錄下，最好將其放在一個外部擴(kuò)展位置中。這會使手動卸載這些特性更加容易，如果需要的話；同時也使插件可以在多個版本的Eclipse安裝之間共享，比如發(fā)行版、嘗鮮(early access)穩(wěn)定版（M1、M2等等）和集成IDE版本。
此時，Update Manager已下載并安裝了所選特性，然后請求重啟Eclipse。
一旦重啟Eclipse，用戶就會在Preference對話框中看到一個新的SVN區(qū)域，并且還會看到有關(guān)Subversion活動的其他視圖?？梢允褂肳indow -> Show View -> Other...菜單將這些視圖添加到Java Perspective中。
我通常將SVN Repository視圖添加到Quick Views中，而將SVN Resource History添加到位于Java Perspective工作區(qū)底部的一個標(biāo)簽組中。這樣，在開發(fā)過程中，這兩個視圖就近便可用了，同時也便于利用拖放來運(yùn)行某些任務(wù)，比如“獲得資源歷史”（從諸如Navigator、Package Explorer、SVN Repository和Synchronize之類的面向資源的視圖到SVN Resource History視圖）。
可以配置Subversion服務(wù)器來使用下列協(xié)議之一：
Subclipse使用專門的適配器抽象化來利用上述協(xié)議?？梢栽赪indow -> Preferences -> Team -> SVN對話框的插件屬性中選擇下列適配器中的一種。
每一種適配器都有其自身的優(yōu)點(diǎn)：
大多數(shù)情況下都可以使用JavaSVN；只有需要時才選擇JavaHL或命令行適配器。參考資料小節(jié)中的鏈接可以幫助解決特定用例，如配置HTTP代理、SSL客戶端證書，等等。
現(xiàn)在就可以連接到Subversion庫了。對于dev2dev CodeShare上的項(xiàng)目，可以在訪問選項(xiàng)頁面中看到一個庫的URL，可以從Version控制項(xiàng)目菜單中找到該頁面。 這里是一個例子 。CodeShare SVN服務(wù)器要求用戶使用的用戶名和口令與其在dev2dev網(wǎng)站上所使用的相同。
如果連接參數(shù)設(shè)置正確，就可以看到一個SSL證書確認(rèn)對話框。
接受證書后，應(yīng)該就可以瀏覽庫并查看現(xiàn)有項(xiàng)目。
現(xiàn)在已經(jīng)準(zhǔn)備好，要開始使用Subversion和Subclipse插件了！
在SVN Repository視圖中可以看到，在許多CodeShare項(xiàng)目以及使用Subversion的其他項(xiàng)目中都可以看到一種共同的布局，通常如下所示：
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文件夾中包含主線開發(fā)源代碼；tags文件夾中包含穩(wěn)定版或發(fā)行版；branches文件夾中包含來自替代開發(fā)線上的代碼。在Subversion中，標(biāo)簽和分支僅僅是選中的源代碼快照的版本化副本。若想獲得更多詳細(xì)內(nèi)容，請參閱Subversion book。
可以在SVN Repository視圖中選擇當(dāng)前項(xiàng)目的主線或者特定的標(biāo)簽或分支，并從彈出菜單中選擇Check Out As...動作。接著就會出現(xiàn)一個指導(dǎo)性的標(biāo)準(zhǔn)New Project Wizard，它允許用戶選擇項(xiàng)目類型（例如，Java或Simple Project）、項(xiàng)目名稱和位置，并在需要時配置Java build路徑。
版本控制庫是任何項(xiàng)目的基礎(chǔ)架構(gòu)的重要部分，對于開源項(xiàng)目（包括CodeShare上的項(xiàng)目）而言，它還在開發(fā)人員與其他社區(qū)成員之間的交流中起著重要作用。例如，它允許終端用戶為最新的代碼捐獻(xiàn)補(bǔ)丁，并為重要的修復(fù)提供早期更新機(jī)制。由于它的重要作用，為一個新項(xiàng)目配置SVN庫并從一開始就將所有的項(xiàng)目代碼置于版本控制之下就顯得非常重要了。
創(chuàng)建了新CodeShare項(xiàng)目之后，SVN庫就包含了trunk、tags和branches文件夾，以及trunk下的www模塊，它包含項(xiàng)目Web首頁的index.html文件?？梢栽赟VN Repository視圖中驗(yàn)證這些，并使用該視圖中的彈出菜單上的動作創(chuàng)建缺少的文件夾。
我們假設(shè)所有的源代碼、build腳本、文檔和其他項(xiàng)目資源被組織為一個Eclipse項(xiàng)目，那么就可以在Package Explorer或Navigator視圖中使用彈出菜單中的Team -> Share Project...動作。Share Project Wizard會要求用戶選擇SVN庫類型，然后在下一個頁面中，可以選擇一個現(xiàn)有庫或配置一個新庫。
在接下來的界面中指定模塊名。為了與CodeShare項(xiàng)目布局相匹配，我們應(yīng)該在trunk文件夾下創(chuàng)建模塊，因此，指定trunk/<project name>作為模塊名，比如trunk/xjms-ra。
經(jīng)過確認(rèn)后，Subclipse會創(chuàng)建模塊，并將所有的項(xiàng)目文件導(dǎo)入SVN庫。
當(dāng)項(xiàng)目連接到SVN庫以后，在Package Explorer和Navigator視圖中會彈出一個Team菜單，顯示特定于Subversion的全部動作?？梢灾苯舆\(yùn)行Commit、Update、Add to svn:ignore，以及Version Control with Subversion一書中所描述的其他動作。該書中的內(nèi)容也可以在Help -> Help Contents -> Version Control with Subversion下的Eclipse幫助系統(tǒng)中找到。
Subclipse插件還允許使用Eclipse的Team Synchronize視圖，它可以使用戶從庫中清楚地觀察到哪些項(xiàng)將要提交、哪些項(xiàng)已經(jīng)被其他開發(fā)人員更改并需要更新。從這個Synchronize視圖中還可以執(zhí)行大多數(shù)的SVN命令。
可以使用彈出的Team -> Synchronize with Repository菜單或位于主工具欄上的Synchronize...向?qū)О粹o將項(xiàng)目或工作集添加到Synchronize視圖中。如果看不到該按鈕，那么請將Team命令添加到當(dāng)前視圖中；可以使用Customize Perspective對話框添加，該對話框可從主工具欄上的彈出菜單中獲得（單擊任意空白處），然后，使用Window -> Save Perspective As...菜單以相同的名稱保存透視圖。
在工具欄下拉菜單中選擇Synchronize...動作來啟動向?qū)АＴ诘谝粋€界面中，它又讓用戶選擇SVN版本跟蹤系統(tǒng)，然后會顯示標(biāo)準(zhǔn)資源選擇面板，用戶可以選擇同步整個工作區(qū)，也可以選擇某組項(xiàng)目或者一個指定的工作集。
一旦完成創(chuàng)建，Synchronize視圖就可以使用版本控制系統(tǒng)安排自動刷新的時間。可以通過Synchronize視圖菜單中的Schedule...菜單對其進(jìn)行配置。這將有助于用戶保持最新狀態(tài)，還可以看到其他開發(fā)人員所做的所有改動。
由于Subclipse仍在發(fā)展，所以用戶可能會遇到bug或者無法找到真正希望獲得的一些特性。這帶我們進(jìn)入下一個話題。
當(dāng)在Subclipse中遇到問題時，可以有多種選擇。如果是瑕疵問題，那么可以簡單地選擇不使用該產(chǎn)品或等待下一個版本。還可以搜索問題跟蹤系統(tǒng)以及郵件列表檔案user@subclipse.tigris.org和dev@subclipse.tigris.org，有可能找到當(dāng)前問題的應(yīng)對措施或解釋。如果這樣沒有幫助，那么可以在郵件列表中咨詢此問題；如果有興趣試著自己解決，那么，下面的段落將簡要介紹如何開始調(diào)試和修補(bǔ)Eclipse。但是，如果非常希望有所捐助，那么一種好的方法是訂閱dev@subclipse.tigris.org郵件列表，從而使您所做的努力與其他開發(fā)人員相協(xié)調(diào)，根據(jù)項(xiàng)目路線圖調(diào)整您的想法。
著手開始真的非常容易，即使您以前從沒有使用過Eclipse插件。需要將Subclipse項(xiàng)目放入Eclipse工作區(qū)中。Subclipse項(xiàng)目的Subversion庫位于http://subclipse.tigris.org/svn/subclipse/，可以使用以前安裝的Subclipse插件或者諸如命令行Subversion客戶端或TortoiseSVN之類的外部工具來查看代碼。還有一種非常好的辦法是在tigris.org Web站點(diǎn)上注冊，并請求Subclipse項(xiàng)目的Observer角色。然后，就可以使用相同的用戶名連接到Subversion庫了（也可以用“guest”/“guest”進(jìn)行只讀訪問），還可以在問題跟蹤器（一個集成的Bugzilla庫）上發(fā)表評論，并附上對問題的補(bǔ)?。ㄈ绻械脑挘?。
一旦連接到版本控制庫，就需要在自己的工作區(qū)中檢查下述項(xiàng)目。對每一個模塊選擇Check Out As...，選擇一個位置和項(xiàng)目名（建議使用下表所列出的實(shí)際的插件名），并單擊Finish。
| 庫路徑 | Jar或Eclipse插件名 | 描述 |
|---|---|---|
| trunk/svnClientAdapter | svnClientAdapter.jar | 用于非Windows系統(tǒng)，或者當(dāng)用戶需要構(gòu)建svnClientAdapter或JavaHL時 |
| trunk/subclipse/core | org.tigris.subversion.subclipse.core | 特定于Eclipse的插件后端 |
| trunk/subclipse/javahl-win32 | org.tigris.subversion.javahl.win32 | 為svnClientAdapter和JavaHL預(yù)構(gòu)建本地Windows二進(jìn)制文件 |
| trunk/subclipse/ui | org.tigris.subversion.subclipse.ui | 特定于Eclipse的UI |
| trunk/subclipse/feature-plugin | org.tigris.subversion.subclipse | 介紹，無代碼 |
| trunk/subclipse/feature | org.tigris.subversion.subclipse (feature) | Subclipse特性 |
| trunk/subclipse/book | org.tigris.subversion.book | Eclipse幫助小節(jié)，包括“Version Control with Subversion”這本書 |
| trunk/subclipse/book-feature | org.tigris.subversion.book (feature) | “Version Control with Subversion”這本書的特寫 |
| trunk/subclipse/update-site | - | Subclipse和“Version Control with Subversion”一書的特寫的更新站點(diǎn) |
對于開發(fā)和測試，只需要org.tigris.subversion.subclipse.core, org.tigris.subversion.subclipse.ui以及org.tigris.subversion.javahl.win32或svnClientAdapter;其他的模塊僅在打包整個插件特性或構(gòu)建更新站點(diǎn)時需要。
當(dāng)所有的項(xiàng)目都在Eclipse工作區(qū)中之后，就可以試著運(yùn)行了。使用Run -> Run...菜單（或Debug，在調(diào)試器下運(yùn)行），啟動新的Eclipse Application類型，并在Workspace Plug-Ins列表中選擇Subclipse插件。如果使用已安裝的Subclipse運(yùn)行IDE，那么應(yīng)該在External Plug-Ins列表中取消對Subclipse插件的選擇，但是要使其他插件均保持選中狀態(tài)。
單擊Run（或Debug），如果一切都配置正確，那么就會出現(xiàn)第二個Eclipse Workbench窗口；應(yīng)該可以打開Subclipse視圖，并像Eclipse本身的實(shí)例一樣連接到庫。此時，如果是在調(diào)試器下運(yùn)行，就可以開始將斷點(diǎn)放到Subclipse類、或Subclipse所使用的Eclipse核心類中，調(diào)試器會停在這些斷點(diǎn)上。一個非常好的起點(diǎn)是org.tigris.subversion.subclipse.ui插件中的org.tigris.subversion.subclipse.ui.actions包，它包括菜單或工具欄中特定于Subclipse的UI動作。注意，可以使用UI注冊這些動作，可以在plugin.xml中聲明式地注冊（通常是action元素），或者是在Java代碼中編程式地注冊，因此，這兩個地方都要查看。
假定已經(jīng)完成了最棘手的部分，并且已經(jīng)設(shè)法實(shí)現(xiàn)了更改，那么現(xiàn)在就該創(chuàng)建補(bǔ)丁并將其附在Subclipse 問題跟蹤庫中的原始問題上了。在創(chuàng)建補(bǔ)丁以前，請確保從版本控制庫中選擇最新的更改（如果有的話），并最后一次測試更改。如果一切都沒有問題，那么就使用Team -> Create Patch...菜單來啟動向?qū)?。選擇Save To Clipboard或Save In File System，并指定是否需要對子目錄進(jìn)行循環(huán)掃描來查看更改。
創(chuàng)建了補(bǔ)丁之后，就可以將其發(fā)送至dev@subclipse.tigris.org郵件列表了，或者也可以在問題跟蹤器中創(chuàng)建問題并將其附上。
諸如Subclipse插件之類的Eclipse平臺開源擴(kuò)展可以提高開發(fā)人員的生產(chǎn)力，降低出錯的可能性，并增強(qiáng)開發(fā)團(tuán)隊(duì)內(nèi)部的交流。本文演示了如何安裝、配置和使用Subclipse插件來從Eclipse IDE內(nèi)部與Subversion版本控制系統(tǒng)進(jìn)行交互。
以Subclipse插件為例，本文還演示了如何設(shè)置一個環(huán)境以進(jìn)行Eclipse插件開發(fā)、如何調(diào)試現(xiàn)有插件、如何創(chuàng)建補(bǔ)丁。事實(shí)上，任何Eclipse用戶都可以為該開源擴(kuò)展以及Eclipse平臺本身捐獻(xiàn)想法和補(bǔ)丁。
原文出處:http://dev2dev.bea.com/pub/a/2005/11/subclipse.html
| 作者簡介 | |
| Eugene Kuleshov 是一位獨(dú)立顧問。他在軟件設(shè)計(jì)和開發(fā)方面具有超過12年的經(jīng)驗(yàn)，擅長于應(yīng)用程序安全、企業(yè)集成(EAI)和面向消息的中間件。他的客戶包括大型的金融和保險公司。 | |
