SVN倉庫目錄結(jié)構(gòu)規(guī)劃

SVN 倉庫目錄結(jié)構(gòu)規(guī)劃倉庫目錄結(jié)構(gòu)規(guī)劃 服務(wù)器 2010 06 10 16 08 31 閱讀 109 評論 0 字號 大中小 訂閱 SVN 倉庫的負(fù)責(zé)人規(guī)劃好倉庫的目錄結(jié)構(gòu) 推薦的目錄結(jié)構(gòu)如下圖所示 倉庫的一級目錄只有兩個 分別為 code 和 doc 其中 doc 主要用來放置先期的文檔 code 主要用來放置工程的代碼 也可以包含后期的文檔 倉庫的二級目錄只可以是 branch 與 trunk 兩個目錄 分別存放主干與分支 trunk 目錄下直接 存放工程文件 branch 目錄下包括一些子目錄分別對應(yīng)各個分支 圖 2 4 從 SVN 倉庫中取出代碼時 一定不要把整個倉庫取出來 而應(yīng)該只取出 trunk 目錄 或只取 出 branch 下的某個分支目錄 比如上圖中的 svn codebranchxw 051206 一個項目會有多個人共同合作開發(fā)完成 基本流程是 各開發(fā)成員建立自己的分支 并在此分支上開發(fā) 各開發(fā)成員把分支合并到主干上并形成較為穩(wěn)定的版本 各個成員重新從主干上建立新的分支 在此分支上開發(fā) 即回到第一步 循環(huán)往復(fù) 直到工程結(jié)束 下面我用一個例子來說明合作開發(fā)的基本流程 現(xiàn)在 xb 與 lzj 兩個開發(fā)人員要共同開發(fā)一個工程 onlytest 其這個工程的主干的 SVN 倉庫地 址如下圖 圖 2 5 xb 與 lzj 分別在 onlytest 這個工程中建立兩個分支 分別為 xb 051115 和 lz 051115 在這里分支命名要采用 姓名縮寫 6 個數(shù)的日期 后綴 可選 的形式 比如 xb 051208 1 xb 051212 之類的 創(chuàng)建完分支后我們可以看到這個工程的目錄結(jié)構(gòu)如下圖所示 圖 2 6 分支目錄 建完之后 xb 和 lzj 分別在本地取出對應(yīng)的分支進行開發(fā) 當(dāng)程序到達一個比較穩(wěn)定的階段 就需要把分支合并到主干上 下面講述一下合并的流程 在本節(jié)中繼續(xù)使用上一節(jié)中所示的工程與 SVN 倉庫講解 1 2 3 1 xb 與 lzj 分別修改自己分支上的代碼 現(xiàn)在 主干上的 test SVN txt 是空文檔 由 xb 與 lzj 修改提交后 兩個分支中 test SVN txt 分別如下兩圖所示 圖 2 7 xb 051129 分支下的 test SVN txt 圖 2 8 lzj 051129 分支下的 test SVN txt 1 2 3 2 xb 將 xb 051129 分支合并到主干 xb 先把主干 check out 到本地 然后在主干的目錄上右鍵選擇 svn merge 彈出如下窗口 圖 2 9 合并對話框 此對話框的含義是把 From 指定的分支版本到 To 指定的分支版本之間的差異合并到主干上 在這里分支選的是 xb 051129 版本號的選定方法是點擊 From 中的 Show Log 在 Log 窗口 中按住 Ctrl 鍵 點擊選擇 made a copy 之上的那個版本 以及最頂上的那個版本 如圖 2 11 所示 然后點擊確定回到上圖中的對話框 會自動填寫 From 與 To 中的 Revision 號 2 10 選擇需要合并的版本 然后直接點擊 merge 進行合并 你也可以通過 dry run 來看是不是兩者之間有差異 由于沒有 其它人修改主干 所以合并的很順利 下圖是 xb 051115 與主干合并后的結(jié)果 合并完畢之后 由 xb 對主干進行提交 圖 2 11 合并后 主干上的 test SVN txt 1 2 3 3 lzj 將 lzj 051129 分支合并到主干 解決沖突 xb 合并完畢之后 lzj 要將他的分支合并到主干上去 方法同上 但是由于 xb 已經(jīng)修改過主干 所以產(chǎn)生了沖突 會彈出一個沖突對話框 雙擊對話框中的產(chǎn)生沖突的文件名 就可以調(diào)出工具對 此文件進行合并 下圖是我們用 merge 工具顯示的界面 圖 2 12 首先比較第一個窗口與第二個窗口 把結(jié)果修改合并到第二個窗口 然后確保光標(biāo)處于第二個窗口時 點擊上圖中紅色圈圈所示的按鈕 這樣會把第二個窗 口的內(nèi)容全部復(fù)制到第三個容口 之后保存 退出 然后在工程目錄上點右鍵 進行 SVN Resolved 這樣會刪除無用的臨時文件 最后提交所作的修改 并添加詳細(xì)的注釋 中的標(biāo)簽 與 CVS 不同 使用 SVN 時不用專門為目錄添加標(biāo)簽 因為 SVN 也對目錄進行版本管理 我們在提交時寫好注釋 比如重要的版本提交時使用 051201 之類的日期作為開頭 就可以 通過注釋來查找比較重要的目錄版本號 相當(dāng)于 CVS 或 VSS 中的標(biāo)簽 另外 每個工程都會有一個版本說明文件 通過此文件可以查找關(guān)鍵版本 你可以重命名 移動或刪除你的文件或文件夾 但請使用 SVN 進行這些操作 否則之前的版 本信息會丟失 使用 SVN 刪除 移動與重命名文件夾的方法是在文件 文件夾上點右鍵進行 SVN 操作 或直 接在資源瀏覽器中使用右鍵拖放 會彈出 SVN 選項 文件的刪除 移動與重命名之前 必須保證工作目錄是最新的版本 進行這些操作之后 需要 進行提交 1 3 3 版本的回退 在代碼的編寫過程中 難免會有不盡人意的地方 你也許需要回退到某一個版本 但是在這個 過程中可能有一些文件你想保留 也有一些文件你不想保留 這就牽扯到很復(fù)雜的版本管理過程 在這里給大家推薦幾種方法 1 若是你編輯了工程 在沒有提交的前提下 你想放棄這些修改 你可以直接選擇 revert 就可以更新到工程的最新的版本 2 若是你想退回到某一個版本 你就可以直接選擇 update to reversion 如圖 這樣我們就可 以把我們的版本回退到你選中的版本去 這種情況下 SVN 并沒有顯示出有什么沖突 并 且新建立的文件也還在 但是在這種情況下你并不能直接在你回退后的版本上進行編輯 因為 SVN 的版本控制還是在最新的主干上 我們需要 update 并解決沖突 3 你可以直接選擇 revert changes from this revision 如圖 這樣的話你可以直接解決沖突 并提交 不過這種方法的不足是 你新建的文件都沒有了 整個工程都回退到之前的版 本了 4 我推薦的一種方法是 直接 export 一個你需要的版本 然后用你 export 的版本覆蓋你的 最新的版本 這樣你就可以不丟失你新建的文件 同時獲得 head 的 SVN 控制文件 圖 13 每個工程會有很多個小模塊 當(dāng)某個模塊達到穩(wěn)定的時候 你就需要提交一次 以免寫下個模 塊代碼的時候出現(xiàn)不可恢復(fù)的錯誤 每一次提交需要前 需要通過 pclint 檢查 保證是一個編譯沒有錯誤的版本 當(dāng)提交比較穩(wěn)定 的版本的時候 同時要修改你的版本號 1 3 5 版本說明文件 版本說明文件為 xml 表格 可用 excel 編輯 它會記錄下關(guān)鍵的版本信息 版本說明文件內(nèi)容如下表 發(fā)布版本是指用戶對外公布的版本號 后文中有詳細(xì)描述 Revision 是 SVN 內(nèi)