2009-03-13 作者：Aaron Wong 來(lái)源：Aaron Wong的blog
0 前言
Subversion是一個(gè)免費的開(kāi)源的版本管理系統，它是作為CVS(Concurrent Versions System)的取代品出現的。本文簡(jiǎn)單介紹了Subversion在Fedora上的安裝過(guò)程及其基本概念和使用方法。您可以到O'Reilly出版的開(kāi)源書(shū)籍
Version Control with Subversion的主頁(yè)在線(xiàn)閱讀(中、英文版本都有)，以獲取更多信息。
1 在Fedora上安裝Subversion
[aaronwong@localhost ~]$ sudo yum -y install subversion
[aaronwong@localhost ~]$ rpm -ql subversion
//上面的命令可查詢(xún)subversion軟件包在系統上所安裝的文件列表
[aaronwong@localhost ~]$ sudo yum -y install mod_dav_svn
//mod_dav_svn不是必須安裝的，它是Apache HTTP Server的一個(gè)插件，你本地倉庫(repository)的文件必須通過(guò)它才能在網(wǎng)絡(luò )上與別人共享。
//subversion的組件列表點(diǎn)此查看。
[aaronwong@localhost ~]$ svn --version
svn，版本 1.4.3 (r23084)
編譯于 Mar 23 2007，09:29:55
版權所有 (C) 2000-2007 CollabNet。
Subversion 是開(kāi)放源代碼軟件，請參閱 http://subversion.tigris.org/
此產(chǎn)品包含由 CollabNet (http://www.Collab.Net/)開(kāi)發(fā)的軟件。
可使用以下的倉庫存取 (RA) 模塊:
* ra_dav : 通過(guò)WebDAV(DeltaV)協(xié)議訪(fǎng)問(wèn)倉庫的模塊。
- 處理“http”方案
- 處理“https”方案
* ra_svn : 使用svn網(wǎng)絡(luò )協(xié)議訪(fǎng)問(wèn)倉庫的模塊。
- 處理“svn”方案
* ra_local : 訪(fǎng)問(wèn)本地磁盤(pán)的倉庫模塊。
- 處理“file”方案
2 使用Subversion管理本地project
作為程序開(kāi)發(fā)人員，我們沒(méi)有必要了解Subversion的所有特性的方方面面，我們的目的是使用它來(lái)對我們的project進(jìn)行方便的簡(jiǎn)單的版本管理，因此，強烈推薦閱讀
Subversion Quick-Start Guid和
Basic Usage。
以下是筆者參照上述Guide進(jìn)行一個(gè)簡(jiǎn)單的本地project的版本管理的示例。假定工程名為hello。
(1)建立本地工程hello的subversion倉庫
Subversion把工程的各個(gè)版本的數據集中放在一個(gè)倉庫(repository)中。假定我們要建立一個(gè)本地工程，叫做hello，為了使用subversion對它進(jìn)行版本管理，首先要為該工程建立一個(gè)倉庫。
[aaronwong@localhost ~]$ svnadmin create .subversion/repos/hello
//subversion安裝后會(huì )生成一個(gè)~/.subversion目錄，這里，我們將工程hello的數據倉庫建立在~/.subversion/repos/hello目錄。
[aaronwong@localhost ~]$ ls -p .subversion/repos/hello/
conf/ dav/ db/ format hooks/ locks/ README.txt
(2)按照subversion的要求組建本地工程hello的工作目錄
假定工程hello的頂層目錄為~/projects/hello(這里~代表/home/aaronwong/)，則應如下組建工程的工作目錄：
~/projects/hello/branches
~/projects/hello/tags
~/projects/hello/trunk/
hello.c
//trunk目錄是實(shí)際上的工程頂層目錄，工程中的所有文件和文件夾都在該目錄下組織。
[aaronwong@localhost ~]$ cd projects/hello/
[aaronwong@localhost hello]$ ls -p
branches/ tags/ trunk/
[aaronwong@localhost hello]$ cat trunk/hello.c
//This is a original version.
#include <stdio.h>
int main()
{
printf("Hello world!\n");
}
(3)將本地工程hello導入本地的Subversion的工程倉庫
由于是首次導入，因此要加信息-m "initial import"。
[aaronwong@localhost trunk]$ svn import ~/projects/hello/ file:///home/aaronwong/.subversion/repos/hello/ -m "initial improt"
新增 /home/aaronwong/projects/hello/trunk
新增 /home/aaronwong/projects/hello/trunk/hello.c
新增 /home/aaronwong/projects/hello/branches
新增 /home/aaronwong/projects/hello/tags
提交后的版本為 1。
注意，完成導入后，原目錄~/projects/hello并不轉換為“工作副本(working copy)”，而且該項目已經(jīng)轉由該倉庫接管，即該倉庫中已經(jīng)包含了首次導入的工程的所有信息，與源目錄~/project/hello再無(wú)任何關(guān)系，我們完全可以刪除這一目錄而不必擔心丟失工程項目數據。注意，如果源目錄并不是一個(gè)“工作副本”，那么就無(wú)法用svn進(jìn)行管理，在其中所作的任何變動(dòng)都無(wú)法提交到倉庫。
要用subversion對工程進(jìn)行版本管理，那么工程項目的開(kāi)發(fā)必須在一個(gè)“工作副本”中進(jìn)行，即首先要從倉庫獲取一個(gè)“工作副本”。
(4)工程開(kāi)發(fā)過(guò)程中的版本管理與控制
使用subversion對工程進(jìn)行版本管理的一般流程如下：
a)建立工程的數據倉庫，并導入工程的最初版本(前面已經(jīng)完成);
b)從倉庫獲取一個(gè)“工作副本”(svn checkout,可以獲取最新版本也可以獲取以前的某個(gè)版本)，在這個(gè)“工作副本”中進(jìn)行工程開(kāi)發(fā)，修改完畢將變動(dòng)提交到倉庫。
下面簡(jiǎn)單介紹b)步驟。
由于工程hello已經(jīng)導入到倉庫，因此原目錄可以刪除。我們刪除原目錄，并從倉庫獲取工程hello的一個(gè)“工作副本”(working copy)；當然，如果你當心這樣做會(huì )造成數據丟失，完全可以重新建立一個(gè)目錄，將“工作副本”保存到那里。
[aaronwong@localhost projects]$ rm -rf hello/
[aaronwong@localhost projects]$ svn checkout file:///home/aaronwong/.subversion/repos/hello/trunk hello
A hello/hello.c
取出版本 1。
//注意，我們用紅色標出了"trunk"，如果不指定這一目錄，則會(huì )取出除工程源文件外的其他不必要的目錄如branches和tags。
[aaronwong@localhost projects]$ ls -a hello/
. .. hello.c .svn
//可以看到“工作副本”下有一個(gè).svn隱藏目錄，其中就包含了subversion用來(lái)進(jìn)行版本管理的信息。
下面可以對工程hello的內容進(jìn)行編輯和修改。注意，如果要在工程中增加或刪除某一文件或目錄(包括復制和移動(dòng))，必須使用svn add/delete/mkdir/copy/move等相關(guān)命令進(jìn)行標記。
[aaronwong@localhost hello]$ pwd
/home/aaronwong/projects/hello
[aaronwong@localhost hello]$ vim hello.c
[aaronwong@localhost hello]$ cat hello.c
//This is the second version.
#include <stdio.h>
int main()
{
printf("Hello world!\n");
return;
}
[aaronwong@localhost hello]$ mkdir doc
[aaronwong@localhost hello]$ vim doc/readme.txt
[aaronwong@localhost hello]$ svn add doc
A doc
A doc/readme.txt
//說(shuō)明：如果svn add的對象是一個(gè)目錄，則該目錄及其子目錄和其下的文件都會(huì )被添加到工程。
對工程編輯完畢，你可以檢查一下該次編輯對工程(實(shí)際上是對你的"工作副本")做了哪些改動(dòng)。
[aaronwong@localhost hello]$ svn status
M hello.c
A doc
A doc/readme.txt
[aaronwong@localhost hello]$ svn diff
Index: hello.c
===================================================================
--- hello.c （版本 1）
+++ hello.c （工作副本）
@@ -1,10 +1,10 @@
-//This is a original version.
+//This is the second version.
#include <stdio.h>
int main()
{
printf("Hello world!\n");
-
+ return;
}
Index: doc/readme.txt
===================================================================
--- doc/readme.txt （版本 0）
+++ doc/readme.txt （版本 0）
@@ -0,0 +1,2 @@
+This is an example for subversion tutorial.
+
//可以看到，svn diff提供了更詳細的改動(dòng)信息，并且很容易的將該命令的輸出重定向為一個(gè)patch補丁。
檢查確認無(wú)誤后，便可提交此次更改，同時(shí)要附加此次更改的說(shuō)明注釋信息。
[aaronwong@localhost hello]$ svn commit -m "documents added."
新增 doc
新增 doc/readme.txt
正在發(fā)送 hello.c
傳輸文件數據..
提交后的版本為 2。
現在工程倉庫中已經(jīng)保存了上面所提交的版本2的工程的所有信息，因此，上面的“工作副本”也可以被刪除：當然，如果下次你還要繼續使用這個(gè)“工作副本”進(jìn)行工作，則可以保留這個(gè)副本，不過(guò)需要注意的是，如果你是在一個(gè)開(kāi)發(fā)團隊中，開(kāi)發(fā)團隊的任一成員都可能在你不知情的情況下更新了工程版本，因此，在團隊開(kāi)發(fā)中，進(jìn)入已有的“工作副本”進(jìn)行編輯前，應該先使用"svn update"命令將當前“工作副本”更新到倉庫中的最新版本。
3 使用svn獲取開(kāi)源項目源代碼
這實(shí)際上是獲取一個(gè)“工作副本”的過(guò)程。例如我需要下載ffmpeg的最新源代碼，就可以使用svn checkout命令來(lái)完成：
[aaronwong@localhost ~]$ svn checkout svn://svn.mplayerhq.hu/ffmpeg/trunk ffmpeg
A ffmpeg/configure
A ffmpeg/Doxyfile
A ffmpeg/ffmpeg.c
A ffmpeg/vhook
A ffmpeg/vhook/imlib2.c
A ffmpeg/vhook/drawtext.c
A ffmpeg/vhook/fish.c
A ffmpeg/vhook/null.c
......
