转SVN 歷險記 – Xcode + SVN 之 ignore

前幾天寫了 SVN 歷險記的第一篇「 SVN 歷險記 – Xcode + SVN 之 ignore 」，雖然順利解決怎麼為專案加上 svn ignore ，這幾天下來發現：

SVN 並沒有辦法 ignore unversioned 檔案及目錄及其子項目

之前在寫文章的時候不知道為什麼沒有碰到這個問題，於是馬上就朝了相關的方向尋找線索，這篇一樣會以 command line 為主，必要時 Versions 作為視覺輔助。

問題與解決方案

在建立一個新專案的時候，所有相關的檔案都會處於 “unversioned” 的狀態，在 svn 的符號就是 “ ? ” ，問號。在未加入版本控制（符號變為 “ A ” ）之前，並沒有辦法把檔案加上 svn:ignore 這個 property 。

解決方案

解決方案就是

先把所有檔案都加入 repository

設定 ignore property 之後

再將 ignore files/folders 從 repository 中移除即立刻無懸念

範例動手做

以下範例可以自行上 code.google.com 註冊一個免費的 svn project 來做練習。

開始前請記得把 repository checkout 到本機。

步驟 1 – 創建 .svnignore

首先在 trunk 目錄之下，創建一個 .svnignore 來設定 Xcode 專案哪些檔案需要 ignore 。詳細一樣可以看這篇文章。

.svnignore 檔案的內容則如下：

.DS_Store

build

*.pbxuser

*.mode1v3

*.mode2v3

*.perspectivev3

*.xcworkspace

xcuserdata

profile

*.moved-aside

DerivedData

.idea

步驟 2 – 創建 Xcode 專案並加入 SVN

在新增 Xcode 專案的時候記得將建立本地 git repo 的選項取消勾選，這時候 Xcode 會在 svn repo 的目錄底下再創建另外一個資料夾，如果想要把 repo 根目錄當成 project 的根目錄可以自行移動檔案。

這時候再 svn repo 的跟目錄下指令

$ svn status

就可以列出目前 svn 的狀態：

? demo-project

? demo-project.xcodeproj

? demo-projectTests

雖然一些需要 ignore 的檔案都是包含在裡面的，但是就先豪邁地把所有檔案加入 version control 中：

$ svn add demo-project*

這樣就可以把任何以 project name 開頭的所有檔案及目錄加入 svn repository 成為 A 的狀態：

A demo-project

A demo-project/AppDelegate.h

A demo-project/Images.xcassets

A demo-project/Images.xcassets/AppIcon.appiconset

A demo-project/Images.xcassets/AppIcon.appiconset/Contents.json

A demo-project/ViewController.h

A demo-project/Info.plist

A demo-project/AppDelegate.m

A demo-project/ViewController.m

A demo-project/Base.lproj

A demo-project/Base.lproj/LaunchScreen.xib

A demo-project/Base.lproj/Main.storyboard

A demo-project/main.m

A demo-project.xcodeproj

A demo-project.xcodeproj/xcuserdata

A demo-project.xcodeproj/xcuserdata/vincent.xcuserdatad

A demo-project.xcodeproj/xcuserdata/vincent.xcuserdatad/xcschemes

A demo-project.xcodeproj/xcuserdata/vincent.xcuserdatad/xcschemes/demo-project.xcscheme

A demo-project.xcodeproj/xcuserdata/vincent.xcuserdatad/xcschemes/xcschememanagement.plist

A demo-project.xcodeproj/project.pbxproj

A demo-project.xcodeproj/project.xcworkspace

A demo-project.xcodeproj/project.xcworkspace/xcshareddata

A demo-project.xcodeproj/project.xcworkspace/xcshareddata/demo-project.xccheckout

A demo-project.xcodeproj/project.xcworkspace/contents.xcworkspacedata

A demo-project.xcodeproj/project.xcworkspace/xcuserdata

A demo-project.xcodeproj/project.xcworkspace/xcuserdata/vincent.xcuserdatad

A (bin) demo-project.xcodeproj/project.xcworkspace/xcuserdata/vincent.xcuserdatad/UserInterfaceState.xcuserstate

A demo-projectTests

A demo-projectTests/externals_uiTests.m

A demo-projectTests/Info.plist

這時候只是將檔案加入 repository 中，尚未 commit 。這時候可以發現上方回應的訊息 Line 15~19 的資料夾 xcuserdata 和 Line 21~27 的 *.xcworkspace 都是要 ignore 的資料夾。

步驟 3 – 設定 Ignore Property

這時候就先把 svn:ignore 設定好（詳細還是看這篇文章吧 :D）：

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

這時候 console 的目錄還是要在 repo 的根目錄之下，接著可以在 terminal 看到以下的處理結果訊息：

property 'svn:ignore' set on '.'

property 'svn:ignore' set on 'demo-project.xcodeproj'

property 'svn:ignore' set on 'demo-project.xcodeproj/xcuserdata'

property 'svn:ignore' set on 'demo-project.xcodeproj/xcuserdata/vincent.xcuserdatad'

property 'svn:ignore' set on 'demo-project.xcodeproj/xcuserdata/vincent.xcuserdatad/xcschemes'

property 'svn:ignore' set on 'demo-project.xcodeproj/project.xcworkspace'

property 'svn:ignore' set on 'demo-project.xcodeproj/project.xcworkspace/xcuserdata'

property 'svn:ignore' set on 'demo-project.xcodeproj/project.xcworkspace/xcuserdata/vincent.xcuserdatad'

property 'svn:ignore' set on 'demo-project.xcodeproj/project.xcworkspace/xcshareddata'

property 'svn:ignore' set on 'demo-project'

property 'svn:ignore' set on 'demo-project/Base.lproj'

property 'svn:ignore' set on 'demo-project/Images.xcassets'

property 'svn:ignore' set on 'demo-project/Images.xcassets/AppIcon.appiconset'

property 'svn:ignore' set on 'demo-projectTests'

因為有加上 -R ，接著很豪邁的洗了一圈，所有檔案都設定好 svn:ignore 了。

步驟 4 – 移除不要的檔案及目錄

這時候就可以用 svn 的 delete 指令來將指定的目錄解除 svn 對他們的控制。

由於只是要移出 repository ，檔案並不需要刪除，因此可以加上 —keep-local 就可以把本地的檔案留下來。

$ svn delete --keep-local demo-project.xcodeproj/project.xcworkspace/

$ svn delete --keep-local demo-project.xcodeproj/xcuserdata/

這兩個指令分別會得到以下的回應訊息：

D demo-project.xcodeproj/project.xcworkspace

D demo-project.xcodeproj/project.xcworkspace/contents.xcworkspacedata

D demo-project.xcodeproj/project.xcworkspace/xcshareddata

D demo-project.xcodeproj/project.xcworkspace/xcshareddata/demo-project.xccheckout

D demo-project.xcodeproj/project.xcworkspace/xcuserdata

D demo-project.xcodeproj/project.xcworkspace/xcuserdata/vincent.xcuserdatad

D demo-project.xcodeproj/project.xcworkspace/xcuserdata/vincent.xcuserdatad/UserInterfaceState.xcuserstate

以及

D demo-project.xcodeproj/xcuserdata

D demo-project.xcodeproj/xcuserdata/vincent.xcuserdatad

D demo-project.xcodeproj/xcuserdata/vincent.xcuserdatad/xcschemes

D demo-project.xcodeproj/xcuserdata/vincent.xcuserdatad/xcschemes/demo-project.xcscheme

D demo-project.xcodeproj/xcuserdata/vincent.xcuserdatad/xcschemes/xcschememanagement.plist

在 commit 之前在來執行 svn status 來看結果如何：

M .