最近在與人合作的項目中使用了Zend Framework。為保證項目穩定性和方便發布，合作者把框架導出(export)到他的版本庫然后提交(check in)。因為ZF框架的文件大量頻繁的更新，他放棄了從框架版本庫導出(export)的本地版本庫同步到版本控制服務器上的辦法，每次更新框架的時候都從版本庫中刪除框架然后重新添加，

這在我看來是在是低效的，特別是考慮到這會讓他從開發分支合并到產品分支非常困難。（刪除并重新添加目錄會在一定成都影響合并）我想會有更好的辦法。

曾經聽說過svn:externals屬性，但是從來沒有使用過。既然有這個屬性，肯定有一個適合運用他的條件。問題是SVN電子書中?svn:externals說明文檔?部分并沒有說明這個屬性該怎樣設置，而且我發現很多”怎么做”條目都省去了一個或多個重要的細節。通過一些實驗、排除一些自己的錯誤，最后我終于知道怎么弄了。因此我現在來分享這個處理過程，希望大家也能夠從這次經歷中得到經驗。

事實上相當容易，假設你的你的項目文件系統結構想下面這樣子：

project/ branch/ production/ tag/ trunk/

• 在trunk目錄下執行如下命令:svn propedit svn:externals .
• 運行命令后會調用編輯器編輯屬性。在編輯器打開的文件中，每行代表一個你要從那里取得代碼的不同的外部svn倉庫。一行中的第一段代表你想讓取回代碼存放的目錄，最后一部分是取得代碼的svn版本庫URL。中間你還可以用一些可選配置參數來決定要取回的版本。以下是一些例子:
  • 取得Zend Framework倉庫的當前版本(head)::framework http://framework.zend.com/svn/framework/trunk
  • 取得Zend Framework倉庫的版本2616:framework -r2616 http://framework.zend.com/svn/framework/trunk
• 保存文件退出編輯器，更新版本庫:svn up
• 提交所做更改:svn commit

請注意一點：在svn:externals中設置的取出代碼存放目錄在不能是你的版本庫中已經存在的目錄。如果存在，你會得到如下錯誤提醒：

svn: Working copy 'sharedproject' lockedsvn: run ’svn cleanup’ to remove locks

上面的例子中我使用的是版本，你也可以使用標簽來取得外部倉庫中特殊標簽的版本。兩種方法都能很好的工作。

現在，當我們實現分支之間或從主干到分支之間的轉換時，你可以為每個分支設置不同的svn:externals屬性。例如,你當期那的產品環境可能從某個特殊的版本中取出，但是你的主干需要跟進最新版本（head)。當你覺得可以實施這些改變的時候，你需要做的僅僅是查到主干的版本號然后更新產品版本的svn:externals屬性即可。

希望這能幫祝你了解svn:externals。

使用svn——外部定義

在svn中提供了一個非常好的功能叫做外部定義，簡單的說就是可以把外部的svn版本庫映射到一個目錄。這是一個本身很簡單的功能，但是他卻能給svn的使用和管理帶來很多多變的功能。

首先詳細的解釋一下外部定義這個功能吧。我們用一個用戶的使用場景來說明一下。說的盡量的詳細，所以比較啰嗦:)。
假設現在有兩個團隊，一個是開發組（dev-team），一個是文檔組（doc-team），共同開發一個產品。這兩個小組各自有各自的管理等等原因，所
以分開使用svn比較好，所以共有兩個svn版本庫，dev-svn和doc-svn。我們假設這兩個版本庫都使用標準的組織結構（詳細對組織結構的討論
請看以后的文章），現在的開發都是在trunk進行的。開發組，trunk下的目錄組織為src，lib，build等等。
對于兩個小組的開發，測試，管理，分開使用沒有任何問題，也不會相互的有影響。但是面對最終產品發布的時候，要做安裝程序，這時候就必須同時操作兩個項
目。而很明顯的一個普遍的組織結構就是doc-team開發的文檔作為dev-team開發的程序等等的一部分。那么在dev-svn的trunk下，就
應該有一個叫做doc的目錄，目錄的內容是doc-svn的trunk的內容。
此時，我們就可以利用svn的外部定義功能來完成這個任務。svn的外部定義，其實是給（父）目錄加上的一個 屬性（svn properties，詳情后文介紹），這個屬性定義了要引用哪個外部的版本庫并且放在（父）目錄下的哪個（子）目錄中。
給父目錄添加一個叫做svn:externals的屬性，屬性的內容是doc-name svn-url，svn-url表示要引用哪個svn的連接，doc-name表示這個引用放在哪個目錄下
在上面的場景中，我們要給dev-svn的trunk目錄設置一個屬性sv:externals，屬性的值是doc

http://doc-svn/trunk，這樣當你設置完之后，update一下本地工作區，biu的一下，doc就過來了，這時候從dev-svn的

trunk的角度看，就有了完整的內容，包括doc。
完整的命令是，在chechout下來的dev-svn的trunk目錄下
#svn propset svn:externals “doc http://doc-svn/trunk” .
propset，表示使用propset命令，添加屬性
svn:externals，表示要添加svn:externals屬性
“doc http://doc-svn/trunk”，表示要給這個屬性添加的值，因為這個屬性包含空格，所以要用雙引號括起來
之后的點，表示要把這個屬性添加在本目錄上

啰嗦了一通，想必大家看的也是云山霧罩的，自己做個試驗就可以了。

一些高級的外部定義的用法，我們對一個目錄不但可以定義一個外部定義，還可以定義多個。比如doc來自doc-svn，website來自web-svn等等。這時候我們需要把這些東西都作為svn:externals的屬性值。
doc http://doc-svn/trunk
website http://web-svn/trunk
注意！這里是需要換行的，這個對于命令行來說，是非常痛苦的，而且外部定義這種值里面還包含空格的需要用雙引號括起來的值來說，就是痛苦死了。好吧，我承認我到現在也沒有成功的設置過。怎么辦？好吧，我們可以用另外的方法來搞定。
svn propset這個命令可以使用一個外部文件的文件內容作為給屬性添加的值。命令如下
svn propset svn:externals -F filename .
所以，一般的，凡是需要用到這類用法的地方，我都會生成一個文件叫做LINKS，放到svn上管理。LINKS的內容如下
doc http://doc-svn/trunk
website http://web-svn/trunk
這樣我們就可以使用svn propset svn:externals -F LINKS . 這個命令來設置了。

對屬性的替換，直接set一個其他的值就好了?？墒?#xff0c;如果我們不想要這個外部定義了怎么辦？注意！這里千萬不能使用svn del命令（比如在dev-svn的trunk目錄下執行svn del doc），這樣你刪除的不是這個外部定義，而是你引用的svn版本庫的內容。如果很幸運的，你是在另外的項目有寫入的權限，好了，恭喜你，你已經把那個項目咔嚓掉了。
正確的做法是使用svn propdel命令來刪除掉svn:externals這個屬性
svn propdel svn:externals

最后還要提醒一點，這個屬性是放在這個目錄上的，對于svn來說，目錄也是受到管理的，目錄和目錄內的文件之類的是不同的。所以你如果只想對這個目
錄進行操作，而不像對它下面的文件進行操作，使用svn的時候，記得加上-N參數。比如類似svn:externals這樣的屬性就是針對目錄的。

其實外部定義，還有很多的高級的使用功能，具體的我就不詳述了，請參閱svn的幫助或者閱讀文檔，http://svndoc.iusesvn.com/svnbook/1.2/svn.advanced.externals.html。 最新的文檔（針對1.4，1.5的）是英文的，嘿嘿。

外部定義還有一些玩法，更多的還是在使用在基于svn管理的項目組織上，這個我會在以后的文章進行說明。

轉載于:https://www.cnblogs.com/chingliu/archive/2011/07/05/2223818.html

總結

以上是生活随笔為你收集整理的学会使用svn:externals的全部內容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網站內容還不錯，歡迎將生活随笔推薦給好友。