macOS 本身其實就內建了 Subversion 的伺服端與客戶端程式,不必額外安裝任何第三方套件,幾分鐘之內就能擁有一台可供自己或團隊使用的 SVN 版本庫。本文以終端機操作為主線,示範從建立版本庫、設定帳號權限、啟動服務,到匯入專案與簽出工作副本的完整流程。
開啟「終端機」,用 svnadmin create 建立版本庫:
svnadmin create /Users/hutton2/Desktop/SVNserver
指令最後面的 SVNserver 就是版本庫名稱。偷懶一點的做法是先在桌面建立一個空資料夾,然後把這個資料夾直接拖進終端視窗,路徑會自動帶入,既不必手打,也不會打錯。
版本庫建立完成後,目錄裡會出現 conf、db、hooks、locks 等項目。權限相關的設定都集中在 conf 資料夾,我們只需要動到三個檔案:authz、passwd 與 svnserve.conf,用任何純文字編輯器開啟即可。
檔案預設內容大致如下,開頭有 # 的都是示範用的註解,實際上並未生效:
[groups]
# harry_and_sally = harry,sally
# harry_sally_and_joe = harry,sally,&joe
# [/foo/bar]
# harry = rw
# &joe = r
# * =
在 [groups] 底下補上自己的群組與成員,並針對路徑宣告權限:
[groups]
testGroup = zhuzhuxia,xiaofeifei
[/]
@testGroup = rw
zhuzhuxia = rw
xiaofeifei = rw
幾個重點:
testGroup 是群組名稱,可以自行命名。zhuzhuxia,xiaofeifei 是群組成員,以逗號分隔。[/] 代表版本庫的根路徑,等於涵蓋全部資源。@ 前綴代表「整個群組」,@testGroup = rw 就是該群組全體擁有讀寫(read & write)權。接著又把每位成員逐一列出一次(zhuzhuxia = rw 這種寫法),相當於直接對使用者授權,效果與群組授權重疊。兩種方式擇一即可,同時寫上也不會出錯,只是顯得囉嗦。
修改前:
[users]
# harry = harryssecret
# sally = sallyssecret
修改後,在 [users] 底下新增「帳號 = 密碼」的配對:
[users]
zhuzhuxia = 123456
xiaofeifei = 123456
要提醒的是,SVN 的密碼檔是明文儲存的,正式環境請務必改用較強的密碼,並限制整個 conf 目錄的讀取權限。
這個檔案裡有幾行關鍵設定被註解掉了,把每行開頭的空格與 # 移除,讓它們生效:
anon-access = none
auth-access = write
password-db = passwd
authz-db = authz
anon-access 決定匿名(未登入)使用者的待遇:read 表示任何人都能唯讀瀏覽,none 則必須提供帳號密碼才能存取。password-db 與 authz-db 分別指向剛才編輯的密碼檔與權限檔(原文範例寫成 author 是筆誤,實際檔名是 authz)。如此一來,權限就配置妥当了。
svnserve -d -r /Users/hutton2/Desktop/SVNserver
-d 讓 svnserve 以常駐背景服務的方式運行,-r 指定版本庫的根目錄。同樣建議把資料夾拖進終端,避免路徑打錯。
按下 Enter 後如果終端沒有任何提示,基本上就代表啟動成功。你也可以打開「活動監視器」搜尋 svn,看到對應的 process 即可確認。
svn import /Users/hutton2/Desktop/testDemo svn://localhost/SVNserver --username zhuzhuxia --password 123456 -m "首次匯入"
/Users/hutton2/Desktop/testDemo:要上傳的專案資料夾。svn://localhost/SVNserver:本機版本庫位址。服務啟動後可以直接用 svn:// 協定存取,這一步就不需要再拖路徑了。-m:提交說明。這段參數不可省略,如果懶得寫內容,至少給一個空白字元,千萬別整個不寫。想把專案放進子目錄(例如 hello)時,把位址改成 svn://localhost/SVNserver/hello 即可,後續 checkout 的位址也要一併對應調整。執行過程中 svn 會要求輸入帳號與密碼,照提示輸入即可。
別以為檔案是自己上傳的就不用 checkout。沒有簽出的目錄只是一般資料夾,並不具備 update、commit 等版本控制能力。
svn checkout svn://localhost/SVNserver --username zhuzhuxia --password 123456 /Users/hutton2/Desktop/project
指令結構為:svn checkout + 版本庫位址 + 帳號 + 密碼 + 本機存放路徑。若要簽出子目錄,把位址改為 svn://localhost/SVNserver/hello。執行後一樣會提示輸入密碼,輸入錯誤時會再次要求登入。
開啟 Xcode,在歡迎畫面點選 Check out an existing project。
接著在 or enter a repository location 欄位填入 SVN 位址。
位址的組成是 svn://伺服器IP/版本庫名稱,例如 svn://192.168.1.10/SVNserver;若要簽出子目錄則是 svn://192.168.1.10/SVNserver/hello。
正常情況下,進入簽出畫面後左下角不會出現錯誤訊息,依提示輸入 SVN 帳號密碼,按 Next 並選擇本機存放位置即可完成。