SVN的標準目錄結構:trunk、branches、tags

我們在一些著名開源項目的版本庫中,通常可以看到trunk, branches, tags等三個目錄。由於SVN固有的特點,目錄在SVN中並沒有特別的意義,但是這三個目錄卻在大多數開源項目中存在,這是因爲這三個目錄反映了軟件開發的通常模式。

trunk是主分支,是日常開發進行的地方。

branches是分支。一些階段性的release版本,這些版本是可以繼續進行開發和維護的,則放在branches目錄中。又比如爲不同用戶客製化的版本,也可以放在分支中進行開發。

tags目錄一般是隻讀的,這裏存儲階段性的發佈版本,只是作爲一個里程碑的版本進行存檔。

比如一個項目有main.cpp, common.h兩個文件,假設目前在開發的是最新的3.0版本,而且1.0/2.0版本也在進行維護,那麼項目樹將類似如下樣子:

project
  |
  +-- trunk
  +     |
  +     +----- main.cpp  (3.0版本的最新文件)
  +     +----- common.h
  +
  +-- branches
  +     |
  +     +-- r1.0
  +     +     |
  +     +     +---- main.cpp (1.x版本的最新文件)
  +     +     +---- common.h
  +     +
  +     +-- r2.0
  +           |
  +           +---- main.cpp (2.x版本的最新文件)
  +           +---- common.h
  +     
  +-- tags   (此目錄只讀)
        |
        +-- r1.0
        +     |
        +     +---- main.cpp (1.0版本的發佈文件)
        +     +---- common.h
        +
        +-- r1.1
        +     |
        +     +---- main.cpp (1.1版本的發佈文件)
        +     +---- common.h
        +
        +-- r1.2
        +     |
        +     +---- main.cpp (1.2版本的發佈文件)
        +     +---- common.h
        +
        +-- r1.3
        +     |
        +     +---- main.cpp (1.3版本的發佈文件)
        +     +---- common.h
        +
        +-- r2.0
        +     |
        +     +---- main.cpp (2.0版本的發佈文件)
        +     +---- common.h
        +
        +-- r2.1
              |
              +---- main.cpp (2.1版本的發佈文件)
              +---- common.h
要使用這樣的文件夾結構,在建立項目版本庫時,可首先建好項目文件夾,並在其中建立trunk, branches, tags三個空的子目錄,再將項目文件夾連同這三個子目錄一起導入版本庫。

這樣在trunk中開始進行開發,當需要建立branch或tag時,使用SVN的copy操作進行。

其中tags目錄需要只讀,可以使用SVN中的authz文件控制該目錄的訪問權限爲只讀。
本節主要講解一下SVN中tag branch trunk的用法,在SVN中Branch/tag在一個功能選項中,在使用中也往往產生混淆。這裏就向大家簡單介紹一下,歡迎大家能和我一起學習SVN中tag branch trunk的用法。
在實現上,branch和tag,對於svn都是使用copy實現的,所以他們在默認的權限上和一般的目錄沒有區別。至於何時用tag,何時用branch,完全由人主觀的根據規範和需要來選擇,而不是強制的(比如cvs)。一般情況下,tag,是用來做一個milestone的,不管是不是release,都是一個可用的版本。這裏,應該是隻讀的。更多的是一個顯示用的,給人一個可讀(readable)的標記。branch,是用來做並行開發的,這裏的並行是指和trunk進行比較。比如,3.0開發完成,這個時候要做一個tag,tag_release_3_0,然後基於這個tag做release,比如安裝程序等。trunk進入3.1的開發,但是3.0發現了bug,那麼就需要基於tag_release_3_0做一個branch,branch_bugfix_3_0,基於這個branch進行bugfix,等到bugfix結束,做一個tag,tag_release_3_0_1,然後,根據需要決定branch_bugfix_3_0是否併入trunk。對於svn還要注意的一點,就是它是全局版本號,其實這個就是一個tag的標記,所以我們經常可以看到,什麼什麼release,基於xxx項目的2xxxx版本。就是這個意思了。但是,它還明確的給出一個tag的概念,就是因爲這個更加的可讀,畢竟記住tag_release_1_0要比記住一個很大的版本號容易的多。

branches:分枝
SVN中tag branch trunk的用法,首先看一下branches的介紹。當多個人合作,可能有這樣的情況出現:John突然有個想法,跟原先的設計不太一致,可能是功能的添加或者日誌格式的改進等等,總而言之,這個想法可能需要花一段時間來完成,而這個過程中,John的一些操作可能會影響Sally的工作,John從現有的狀態單獨出一個project的話,又不能及時得到Sally對已有代碼做的修正,而且獨立出來的話,John的嘗試成功時,跟原來的合併也存在困難。這時最好的實踐方法是使用branches。John建立一個自己的branch,然後在裏面實驗,必要的時候從Sally的trunk裏取得更新,或者將自己的階段成果彙集到trunk中。
(svncopySourceURL/trunkDestinationURL/branchName-m"Creatingaprivatebranchofxxxx/trunk.")

trunk:主幹
主幹,一般來說就是開發的主要呆的地方,
tag:  圖標
在經過了一段時間的開發後,項目到達了一個里程碑階段,你可能想記錄這一階段的代碼的狀態,那麼你就需要給代碼打上標籤。
(svncpfile:///svnroot/mojavescripts/trunkfile:///svnroot/mojavescripts/tags/mirrorutils_rel_0_0_1-m"tagedmirrorutils_rel_0_0_1")另有一說,無所謂誰對誰錯。
trunk:表示開發時版本存放的目錄,即在開發階段的代碼都提交到該目錄上。
branches:表示發佈的版本存放的目錄,即項目上線時發佈的穩定版本存放在該目錄中。
tags:表示標籤存放的目錄。
在這需要說明下分三個目錄的原因,如果項目分爲一期、二期、三期等,那麼一期上線時的穩定版本就應該在一期完成時將代碼copy到branches上,這樣二期開發的代碼就對一期的代碼沒有影響,如新增的模塊就不會部署到生產環境上。而branches上的穩定的版本就是發佈到生產環境上的代碼,如果用戶使用的過程中發現有bug,則只要在branches上修改該bug,修改完bug後再編譯branches上最新的代碼發佈到生產環境即可。tags的作用是將在branches上修改的bug的代碼合併到trunk上時創建個版本標識,以後branches上修改的bug代碼再合併到trunk上時就從tags的version到branches最新的version合併到trunk,以保證前期修改的bug代碼不會再合併。
-------------------------------------------------------------------------------------------
介紹SVN中tag branch trunk用法時,一直以來用svn只是當作cvs,也從來沒有仔細看過文檔,直到今天用到,纔去翻看svnbook文檔,慚愧
需求一:
有一個客戶想對產品做定製,但是我們並不想修改原有的svn中trunk的代碼。
方法:
用svn建立一個新的branches,從這個branche做爲一個新的起點來開發
svncopysvn://server/trunksvn://server/branches/ep-m"initep"
Tip:
如果你的svn中以前沒有branches這個的目錄,只有trunk這個,你可以用
svnmkdirbranches新建個目錄

需求二:
產品開發已經基本完成,並且通過很嚴格的測試,這時候我們就想發佈給客戶使用,發佈我們的1.0版本
svncopysvn://server/trunksvn://server/tags/release-1.0-m"1.0released"咦,這個和branches有什麼區別,好像啥區別也沒有?
是的,branches和tags是一樣的,都是目錄,只是我們不會對這個release-1.0的tag做修改了,不再提交了,如果提交那麼就是branches

需求三:
有一天,突然在trunk下的core中發現一個致命的bug,那麼所有的branches一定也一樣了,該怎麼辦?
svn-r148:149mergesvn://server/trunkbranches/ep其中148和149是兩次修改的版本號。SVN中tag branch trunk用法介紹完畢。

本文主要講解一下SVN組成trunk,branches and tags,主要包括其概念的講解、用法的比較,相信看完本文你肯定有不少收穫,希望本文能教會你更多東西。
在本篇文章中,我將會詳細說明我是如何應用SVNtrunk(樹幹)、branches(分支)和tags(標記)。這種方法同樣被稱爲“branchalways”,兩者非常接近。可能我所介紹的並不是最好的方法,但是它會給新手一些解釋說明,告訴他們trunk、branches和tags是什麼,並且該如何去應用它們。

當然,如果本文有些要點需要澄清/確認,亦或者有一些錯誤的觀點,還請你評論,自由發表自己的觀點。
——簡單的對比
SVN的工作機制在某種程度上就像一顆正在生長的樹:
一顆有樹幹和許多分支的樹
分支從樹幹生長出來,並且細的分支從相對較粗的樹幹中長出
一棵樹可以只有樹幹沒有分支(但是這種情況不會持續很久,隨着樹的成長,肯定會有分支啦,^^)
一顆沒有樹幹但是有很多分支的樹看起來更像是地板上的一捆樹枝
如果樹幹患病了,最終分支也會受到影響,然後整棵樹就會死亡
如果分支患病了,你可以剪掉它,然後其他分支還會生長出來的哦!
如果分支生長太快了,對於樹幹它可能會非常沉重,最後整棵樹會垮塌掉
當你感覺你的樹、樹幹或者是分支看起來很漂亮的時候,你可以給它照張相,這樣就就可以記得它在那時是多麼的贊。
——Trunka
SVN組成Trunka,Trunk是放置穩定代碼的主要環境,就好像一個汽車工廠,負責將成品的汽車零件組裝在一起。
以下內容將告訴你如何使用SVNtrunk:
除非你必須處理一些容易且能迅速解決的BUG,或者你必須添加一些無關邏輯的文件(比如媒體文件:圖像,視頻,CSS等等),否則永遠不要在trunk直接做開發
不要因爲特殊的需求而去對先前的版本做太大的改變,如何相關的情況都意味着需要建立一個branch(如下所述)
不要提交一些可能破壞trunk的內容,例如從branch合併
如果你在某些時候偶然間破壞了trunk,bringsomecakethenextday(”withgreatresponsibilitiescome…hugecakes”)
——Branches
SVN組成branches,一個branch就是從一個SVN倉庫中的子樹所作的一份普通拷貝。通常情況它的工作類似與UNIX系統上的符號鏈接,但是你一旦在一個SVNbranch裏修改了一些文件,並且這些被修改的文件從拷貝過來的源文件獨立發展,就不能這麼認爲了。當一個branch完成了,並且認爲它足夠穩定的時候,它必須合併回它原來的拷貝的地方,也就是說:如果原來是從trunk中拷貝的,就應該回到trunk去,或者合併回它原來拷貝的父級branch。
以下內容將告訴你如何使用SVNbranches:
如果你需要修改你的應用程序,或者爲它開發一個新的特性,請從trunk中創建一個新的branch,然後基於這個新的分支進行開發
除非是因爲必須從一個branch中創建一個新的子branch,否則新的branch必須從trunk創建
當你創建了一個新branch,你應當立即切換過去。如果你沒有這麼做,那你爲什麼要在最初的地方創建這個分支呢?
——Tags
SVN組成Tags。從表面上看,SVNbranches和SVNtags沒有什麼差別,但是從概念上來說,它們有許多差別。其實一個SVNtags就是上文所述的“爲這棵樹照張相”:一個trunk或者一個branch修訂版的命名快照。
以下內容將告訴你如何使用SVNtags:
作爲一個開發者,永遠不要切換至、取出,或者向一個SVNtag提交任何內容:一個tag好比某種“照片”,並不是實實在在的東西,tags只可讀,不可寫。
在特殊或者需要特別注意的環境中,如:生產環境(production)、?(staging)、測試環境(testing)等等,只能從一個修復過的(fixed)tag中checkout和update,永遠不要commit至一個tag。
對於上述提及到的環境,可以創建如下的tags:“production”,“staging”,“testing”等等。你也可以根據軟件版本、項目的成熟程度來命名tag:“1.0.3”,“stable”,“latest”等等。
當trunk已經穩定,並且可以對外發布,也要相應地重新創建tags,然後再更新相關的環境(production,staging,etc)
——工作流樣例
假設你必須添加了一個特性至一個項目,且這個項目是受版本控制的,你差不多需要完成如下幾個步驟:
使用SVNcheckout或者SVNswitch從這個項目的trunk獲得一個新的工作拷貝(branch)
使用SVN切換至新的branch
完成新特性的開發(當然,要做足夠的測試,包括在開始編碼前)
一旦這個特性完成並且穩定(已提交),並經過你的同事們確認,切換至trunk
合併你的分支至你的工作拷貝(trunk),並且解決一系列的衝突
重新檢查合併後的代碼
如果可能的話,麻煩你的同事對你所編寫、更改的代碼進行一次複查(review)
提交合並後的工作拷貝至trunk
如果某些部署需要特殊的環境(生成環境等等),請更新相關的tag至你剛剛提交到trunk的修訂版本,使用SVNupdate部署至相關環境
Tags:svn,翻譯。SVN組成中trunk,branches and tags概念、功能和用法等介紹完畢。請關注本節的其他報道。

 

 

http://www.cnmiss.cn/?p=296

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章