登入 | English

感謝您對「自由軟體鑄造場」的支持與愛護，十多年來「自由軟體鑄造場」受中央研究院支持，並在資訊科學研究所以及資訊科技創新研究中心執行，現已完成階段性的任務。原網站預計持續維運至 2021年底，網站內容基本上不會再更動。本網站由 Denny Huang 備份封存。
也紀念我們永遠的朋友李士傑先生（Shih-Chieh Ilya Li）。

版本控制

最近更新在 2010-11-24 18:30

本單元會簡介如何運用版本控制來進行專案協同開發。（是否積極利用版本控制進行專案開發，為國科會專案審核項目之一。）

在此簡單整理有關於版本控制的特定用語，方便讀者能夠了解手冊內容，相關資訊如下：

相關名詞	名詞說明
檔案庫（Repository）	開發團隊共用的集中式版本檔案資料庫。
工作複本（Working Copy）	開發者於本地端使用的檔案庫複本。
主幹（Trunk）	程式主要的共享開發版本。
分支（Branches）	程式的分支版本；主要用於釋出版本的功能添加、修補臭蟲。
標記（Tags）	程式的特別版本；主要用於釋出版本或需要特別標記時使用

OpenFoundry 專案平台提供多樣的版本控制系統，為了達到快速上手在此僅介紹較為常見的版本控制系統— Subversion ；並用簡易的方式說明，如有需要更詳細的資訊可參考如下連結。
Subversion 指令中文操作手冊：https://twpug.net/docs/Subversion/
OSSF 工作坊影片教學：https://www.openfoundry.org/workshop/details/77
TortposeSVN 教學： https://www.openfoundry.org/tw/help/2324-version-control#TortoiseSVN
操作流程步驟如下圖所示：

操作步驟指令

手冊會先以指令方式來介紹 Subversion 操作；在此以 Ubuntu 作業系統為操作環境，並針對 Subversion 這套版本控制系統進行說明，相關資訊如下：

作業環境系統命令模式操作版本控制系統文字編輯器

Ubuntu 10.04
終端機 Subversion 內建 gedit
前置作業－請先確認工作環境，操作步驟如下：
1. Ubuntu 左上方選單列中依序點選【應用程式 → 附屬應用程式 → 終端機】功能。
2. 指令：svn --version
  
  （註：檢查 Ubuntu 是否安裝 Subversion ）
於 Ubuntu 下安裝 Subversion。（如果已有安裝可省略此步驟）
1. 指令：sudo apt-get install subversion
2. 指令：輸入用戶密碼。
查詢檔案庫－至 OpenFoundry 查詢專案檔案庫的連結位置；在此以 testproject04 為說明範例，操作步驟如下：
1. 於右上方的搜尋項目中選擇專案輸入 testproject04 後，按下 Enter 尋找專案，會出現如下圖的搜尋結果。
  
  （註：亦可直接於網址列上輸入專案的網址；通則 https://www.openfoundry.org/projects/[專案名稱]，
  
  此例為 https://www.openfoundry.org/projects/testproject04 ）
2. 進入專案頁面後，於左側選單列中依序點選【版本控制 → 存取方式】功能，並記下專案檔案庫的位置。
建置工作複本－從 OpenFoundry 取出檔案庫並於本機端桌面建立 testproject04 資料夾來建置工作複本，操作步驟如下：
1. 指令：cd ~（注意存放的位置）
2. 指令：svn co https://svn.openfoundry.org/testproject04 testproject04
  
  通則：svn co https://svn.openfoundry.org/[專案名稱] [本機資料夾名稱或路徑]
  
  （利用 Subversion 指令集取得專案的版本控制檔案庫，並建立 [testproject04] 資料夾）
瀏覽檔案庫－至 OpenFoundry 瀏覽專案檔案庫的架構；在此以 testproject04 為說明範例，操作步驟如下：
1. 直接於網址列上輸入專案的 viewvc 網址，可以發現網頁呈現的架構與我們下載下來的檔案結構一樣。
  
  （通則：https://www.openfoundry.org/projects/[專案名稱]，此例為 https://www.openfoundry.org/projects/testproject04/viewvc）
新增檔案 — 在本機端新增工作複本，並利用 testuser01 帳號上傳至 testproject04 專案檔案庫，操作步驟如下：

帳號密碼運用角色

testuser01 testuser01 專案參與者A
1. 指令：cd testproject04
  
  （切換至工作複本的目錄位置）
2. 指令：gedit test_01 通則：gedit [新增的檔案名稱]
  
  （新增檔案於工作複本目錄內）
  - 會開啟預設的文字編輯器 gedit，輸入內容後存檔，並關閉此視窗。
3. 指令：svn status
  
  （顯示目前版本控制狀態，出現 ? 代表有檔案沒有被 Subversion 控管）
4. 指令：svn add test_01 通則：svn add [未加入svn的檔案名稱]
  
  （將新增檔案加入至版本控制，檔案前出現 A 代表檔案已經被 Subversion 控管）
5. 指令：svn ci test_01 通則：svn ci [要提交的檔案名稱]
  
  （提交修訂的檔案至專案檔案庫中）
  - 進入文字編輯，在此輸入異動明細方便未來的紀錄追蹤。
  - 鍵盤輸入 ctrl+ o，寫入檔案於暫存檔。
  - 鍵盤輸入 ctrl+ x，離開文字編輯畫面。
  - 視窗會顯示傳送檔案資料的版本序號。
6. 至 OpenFoundry 瀏覽專案檔案庫的架構，於網址列上輸入 https://www.openfoundry.org/projects/testproject04/viewvc，確認 testproject04 架構是否變更。

作業環境系統	命令模式操作	版本控制系統	文字編輯器
Ubuntu 10.04	終端機	Subversion	內建 gedit

帳號	密碼	運用角色
testuser01	testuser01	專案參與者A

操作步驟視窗

接著我們介紹以 Windows XP 作業系統為操作環境，並針對 Subversion 這套版本控制系統進行說明，相關資訊如下：

作業系統環境視窗軟體版本控制系統備註

Windows XP
TortoiseSVN
Subversion
下載軟體－請至此網址 https://tortoisesvn.net/downloads 下載 TortoiseSVN，下載流程礙於篇幅在此不多加說明。
安裝軟體－依照一般安裝程序進行安裝，TortoiseSVN 安裝完成後，作業系統會要求重開機，請重新啟動您的電腦；安裝流程礙於篇幅在此不多加說明。
建置工作複本－從 OpenFoundry 取出 testproject04 檔案庫並於本機端建置工作複本，最後利用 testuser02 帳號 commit 變更至 testproject04 專案檔案庫，操作步驟如下：

帳號密碼運用角色

testuser02 testuser02 專案參與者B
1. 於桌面新增一個 TEST 資料夾用來存放工作複本，並於資料夾內按下右鍵並點選【SVN Checkout...】選項，準備從 OpenFoundry 取出 testproject04 檔案庫。
2. 於 URL of repository 欄位中輸入 testproject04 檔案庫的位置，確認其他設定無誤後點選【OK】按鈕。
3. 完成後會出現目前的版本序號。
新增檔案
1. 接下來於工作複本資料內新增檔案，並在此檔案上按右鍵依序點選【TortoiseSVN →Add】，將此檔案納入版本控制系統中。
2. 接下來提交修訂或新增的檔案至 testproject04 專案檔案庫中在此檔案上按右鍵點選【SVN Commit...】，準備提交至專案檔案庫中。
3. 使用者輸入版本更動明細（建議輸入修改的資訊方便日後進行控管），確認無誤後點選【OK】按鈕。
4. 輸入 testuser02 帳號及密碼，輸入完成後，請點選【OK】按鈕。
5. 視窗會顯示傳送檔案資料的版本序號，結果如下圖所示。
6. 至 OpenFoundry 瀏覽專案檔案庫的架構，於網址列上輸入 https://www.openfoundry.org/projects/testproject04/viewvc ，確認 testproject04 架構是否變更。