您现在的位置: IOS教程網 >> IOS系統 >  >> iOS 程式開發 >> iOS 開發綜合

在 Xcode 中設定與使用 Git:.gitignore 配置指南

編輯:iOS 開發綜合

Git 指令大多在終端機下執行,效能與彈性都最好,缺點是需要記住指令。因此不少開發者偏好圖形介面,而 Xcode 作為整合開發環境也內建了一定程度的 Git 圖形功能——但使用前必須先做好設定,否則版本庫會被一堆不該追蹤的檔案塞滿。

問題:Xcode 專案提交時出現一堆雜訊

用 Xcode 4 建立的 iOS 專案,在終端機提交時常看到類似下面的訊息:

create mode 100644 HelloWorld.xcodeproj/project.xcworkspace/contents.xcworkspacedata
create mode 100644 HelloWorld.xcodeproj/project.xcworkspace/xcuserdata/tonyguan.xcuserdatad/UserInterfaceState.xcuserstate
create mode 100644 HelloWorld.xcodeproj/xcuserdata/tonyguan.xcuserdatad/xcschemes/HelloWorld.xcscheme
create mode 100644 HelloWorld.xcodeproj/xcuserdata/tonyguan.xcuserdatad/xcschemes/xcschememanagement.plist
rewrite HelloWorld.xcodeproj/project.xcworkspace/xcuserdata/tonyguan.xcuserdatad/UserInterfaceState.xcuserstate (83%)

這些檔案絕大部分不該進入版本控制。原則很簡單:能列入版本控制的只有原始碼與專案設定,二進位產物、臨時檔、使用者專屬設定都不該追蹤。

看過專案結構就明白了

HelloWorld
├── HelloWorld
│   ├── AppDelegate.h / AppDelegate.m
│   ├── ViewController.h / ViewController.m
│   ├── HelloWorld-Info.plist
│   ├── HelloWorld-Prefix.pch
│   ├── main.m
│   └── en.lproj
│       ├── InfoPlist.strings
│       └── ViewController.xib
└── HelloWorld.xcodeproj
    ├── project.pbxproj                        ← 必須追蹤
    ├── project.xcworkspace                    ← 不該追蹤
    │   ├── contents.xcworkspacedata
    │   └── xcuserdata/…/UserInterfaceState.xcuserstate
    └── xcuserdata/…                           ← 不該追蹤
        ├── xcdebugger/Breakpoints.xcbkptlist
        └── xcschemes/

HelloWorld.xcodeproj 其實是一個套件(package)。其中 project.pbxproj 記錄了專案結構與編譯設定,是團隊共享的關鍵檔案,必須提交;但 project.xcworkspace 與 xcuserdata 屬於「使用者專屬」,記錄的是某台機器上某個人的視窗佈局、中斷點與 scheme 偏好,對其他人毫無意義,只會製造無謂的衝突。

用 .gitignore 排除該忽略的檔案

# 排除編譯輸出目錄
build/*

# 排除臨時 nib 與 swap 檔
*~.nib
*.swp

# 排除 OS X 的資料夾屬性檔
.DS_Store

# 排除 Xcode 3 與 4 的使用者專屬檔案
*.mode1
*.mode1v3
*.mode2v3
*.perspective
*.perspectivev3
*.pbxuser
*.xcworkspace
xcuserdata

檔案中的 # 是註解,其餘每行是一條規則,支援 glob 樣式。上面這份設定同時考慮了 Xcode 3 與 4 的差異,所以兩代的雜項都涵蓋了。

檔案該放在哪裡

只對單一專案生效:把 .gitignore 放在程式碼庫(repository)根目錄,也就是與 .git 資料夾同層的位置。

<程式碼庫目錄>/
├── .git/
├── .gitignore          ← 放在這裡
└── HelloWorld/
    ├── HelloWorld/
    └── HelloWorld.xcodeproj/

對所有 Xcode 專案生效:用 git config 設定全域忽略檔。

git config --global core.excludesfile ~/.gitignore

這條指令會把設定寫入 ~/.gitconfig。--global 表示套用於目前使用者的所有專案,~/.gitignore 則指定忽略規則檔放在使用者家目錄下。

一個常見的救火情境

如果檔案已經被追蹤了,單純加進 .gitignore 並不會生效——Git 只對「尚未追蹤」的檔案套用忽略規則。此時要先把檔案從索引中移除:

git rm -r --cached HelloWorld.xcodeproj/xcuserdata

--cached 參數的意義是只從 Git 索引移除、保留本機實體檔案,避免誤刪自己的設定。

團隊協作建議

.gitignore 本身應該要提交進版本庫,這樣所有成員 clone 下來就自動套用同一套規則。另外提醒,忽略規則只影響 Git 的追蹤行為,它並不是安全機制——想排除的是「機密檔案」的話,那些檔案一旦進過歷史紀錄就已經洩漏了,必須改用 filter-branch 或 BFG 重寫歷史。

  1. 上一篇文章:
  2. 下一篇文章:
蘋果刷機越獄教程| IOS教程問題解答| IOS技巧綜合| IOS7技巧| IOS8教程
Copyright © IOS教程網 All Rights Reserved