在本篇文章中, 我將會詳細說明我是如何應用SVN trunk(樹干)、branches(分支)和tags(標記)。這種方法同樣被稱為“branch always”,兩者非常接近。可能我所介紹的並不是最好的方法,但是它會給新手一些解釋說明,告訴他們trunk、branches和tags是什么,並且該如何去應用它們。
當然,如果本文有些要點需要澄清/確認,亦或者有一些錯誤的觀點,還請你評論,自由發表自己的觀點。
——簡單的對比
SVN的工作機制在某種程度上就像一顆正在生長的樹:
- 一顆有樹干和許多分支的樹
- 分支從樹干生長出來,並且細的分支從相對較粗的樹干中長出
- 一棵樹可以只有樹干沒有分支(但是這種情況不會持續很久,隨着樹的成長,肯定會有分支啦,^^)
- 一顆沒有樹干但是有很多分支的樹看起來更像是地板上的一捆樹枝
- 如果樹干患病了,最終分支也會受到影響,然后整棵樹就會死亡
- 如果分支患病了,你可以剪掉它,然后其他分支還會生長出來的哦!
- 如果分支生長太快了,對於樹干它可能會非常沉重,最后整棵樹會垮塌掉
- 當你感覺你的樹、樹干或者是分支看起來很漂亮的時候,你可以給它照張相,這樣就就可以記得它在那時是多么的贊。
——Trunk
Trunk是放置穩定代碼的主要環境,就好像一個汽車工廠,負責將成品的汽車零件組裝在一起。
以下內容將告訴你如何使用SVN trunk:
-
除非你必須處理一些容易且能迅速解決的BUG,或者你必須添加一些無關邏輯的文件(比如媒體文件:圖像,視頻,CSS等等),否則永遠不要在trunk直接做開發
-
不要因為特殊的需求而去對先前的版本做太大的改變,如何相關的情況都意味着需要建立一個branch(如下所述)
-
不要提交一些可能破壞trunk的內容,例如從branch合並
-
如果你在某些時候偶然間破壞了trunk,bring some cake the next day (”with great responsibilities come… huge cakes”)
——Branches
一個branch就是從一個SVN倉庫中的子樹所作的一份普通拷貝。通常情況它的工作類似與UNIX系統上的符號鏈接,但是你一旦在一個SVN branch里修改了一些文件,並且這些被修改的文件從拷貝過來的源文件獨立發展,就不能這么認為了。當一個branch完成了,並且認為它足夠穩定的時候,它必須合並回它原來的拷貝的地方,也就是說:如果原來是從trunk中拷貝的,就應該回到trunk去,或者合並回它原來拷貝的父級branch。
以下內容將告訴你如何使用SVN branches:
-
如果你需要修改你的應用程序,或者為它開發一個新的特性,請從trunk中創建一個新的branch,然后基於這個新的分支進行開發
-
除非是因為必須從一個branch中創建一個新的子branch,否則新的branch必須從trunk創建
-
當你創建了一個新branch,你應當立即切換過去。如果你沒有這么做,那你為什么要在最初的地方創建這個分支呢?
——Tags
從表面上看,SVN branches和SVN tags沒有什么差別,但是從概念上來說,它們有許多差別。其實一個SVN tags就是上文所述的“為這棵樹照張相”:一個trunk或者一個branch修訂版的命名快照。
以下內容將告訴你如何使用SVN tags:
-
作為一個開發者,永遠不要切換至、取出,或者向一個SVN tag提交任何內容:一個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)
——工作流樣例
假設你必須添加了一個特性至一個項目,且這個項目是受版本控制的,你差不多需要完成如下幾個步驟:
-
使用SVN checkout或者SVN switch從這個項目的trunk獲得一個新的工作拷貝(branch)
-
使用SVN切換至新的branch
-
完成新特性的開發(當然,要做足夠的測試,包括在開始編碼前)
-
一旦這個特性完成並且穩定(已提交),並經過你的同事們確認,切換至trunk
-
合並你的分支至你的工作拷貝(trunk),並且解決一系列的沖突
-
重新檢查合並后的代碼
-
如果可能的話,麻煩你的同事對你所編寫、更改的代碼進行一次復查(review)
-
提交合並后的工作拷貝至trunk
-
如果某些部署需要特殊的環境(生成環境等等),請更新相關的tag至你剛剛提交到trunk的修訂版本
-
使用SVN update部署至相關環境