文森說技術

因為工作上需要，所以必須了解怎麼使用 svn 怎麼和 Xcode 相處得宜。因為 Xcode 有些檔案是不需要被 commit 進 repository 的，於是就來看看怎麼在 svn 達到和 gitignore 一樣的效果。一探究竟之後，也發現和 git 的做法截然不同。

Property 和 Subversion Properties

Property

Subversion 對於 每個檔案 、 每個資料夾 ，甚至是 unversioned files 都可以加上 property 加以設定。相關指令如下：

1
2
3
4
5

$ svn propset  # 初始化一個 property
$ svn propget  # 取得一個 property
$ svn propedit # 編輯一個 property
$ svn propdel  # 刪除一個 property
$ svn proplist # 列出指定 item 的 properties

Subversion Properties

而 SVN 也有自己內建的 Subversion properties 可以使用，都是以 svn: 作為開頭，再接著需要操作的 property name 。

今天會用到的 ignore 就是隸屬於 Subversion properties ： svn:ignore 。把需要忽略的檔案或資料夾設定在這個 property 裡後，就可以達到目的了。

svn:ignore

在這裡做點記錄，看看要怎麼設定這個屬性。

初始化

如前一個段落提到的，使用 propset 這個 subcommand 就可以達成了：

1
2
3

# 首先需要先進入你的 svn 的專案資料夾
# svn propset [property] [target] [location]
$ svn propset svn:ignore bin .

這個指令做的事情是

把目前目錄（.）中的 bin 資料夾設定為需要 ignore 的對象

影響範圍與遞迴設定 -R

svn:ignore 這個參數只能對指定對象的資料夾中做處理，並沒有辦法直接遞迴到所有的子目錄的子目錄的子目錄 … 。所以若是在 ignore 的對象中有 / 有資料夾層級的斜線，將不會找到正確的目標。

因此若是需要把所有的子目錄的層級，全部設定一樣的 ignore 條件，則可以在指令加上 -R 這個 flag ：

1

$ svn propset svn:ignore -R bin .

這樣一來，所有在自己目錄項下的所有子目錄及他們所有的子目錄，會全部加上 ignore bin 這個資料夾的 svn:ignore property

集中管理 Ignore File Settings ： -F 與 .svnignore

但是如果照上述的做法，我必須要下 propedit 這個副指令才有辦法看到我到底 ignore 了哪些檔案，而 svn 也不像 git 有 .gitignore 會自動讀取，非常不方便。

不過其實這個也是有對應的作法可以做，因此我們就來仿照 .gitignore 就來造個 .svnignore 檔案來列出需要 ignore 的項目吧！

而 propset 也有 flag 可以讓大家可以直接讀取使用者自定義的檔案，並根據檔案內容來覺得什麼檔案要被 ignore 。

因此，在 .svnignore 中可以長這樣，每一個新的一行就是一個需要忽略的檔案或是資料夾：

1
2

bin
photo

在執行初始化的時候，到目前為止則變化成如下：

1

$ svn propset svn:ignore -R -F .svnignore .

就可以以此把 .svnignore 裡面的設定指定到所有子目錄及子檔案中。

注意事項

svn 會善盡職責好好管理任何已經被版本控制的檔案，因此當設定 ignore 之前，有些檔案已經受到版本控制，事後就算把那些檔案設定進 svn:ignore 也 絕對、絕對、絕對不會 將那些檔案解除 version control 。

和 Xcode 合作

由於已經被 commit 過加入 version control 的檔案在事後並沒有辦法被移除，因此在專案生成之後先不要做任何的 commit ，先對專案所有的資料夾遞迴設定 svn:ignore ，再來 commit 專案的資料夾。

.svnignore Template

由於設定 ignore 條件的方式和 git 有所不同，因此貼出平常使用的 .svnignore 檔案供參考：

1
2
3
4
5
6
7
8
9
10
11
12

.DS_Store
xcuserdata
build
*.mode1v3
*.pbxuser
*.xcworkspace
*.moved-aside
DerivedData

# If you are using CocoaPods
Pods
Podfile.lock

這時候再執行設定 svn:ignore ，也就會發現他真的會走過所有的檔案以及資料夾全部設定好。

結語

和我自己之前學習 git 一樣，目前為止都是盡量用 command line 直接操作 svn ，避免工具幫我在背後做掉很多事情和學習工具的一些成本。在公司用 Versions 嘗試時也沒有找到該怎麼遞迴跑所有子目錄，不過也是可以透過它來輔助快速驗證是否設定成功。

現在多看一陣子 svn 、多瞭解一下發現似乎也沒有當初想的那麼麻煩和恐怖，還是有許多需要看就對了。