多人協作時,只要有人新增或刪除檔案,project.pbxproj 幾乎必然衝突,而這個檔案一旦衝突,專案往往連打開都有困難。xUnique 就是為了解決這個痛點而出現的第三方工具。
團隊成員往專案裡加了幾個檔案,Xcode 會重新生成專案檔,他們把變更提交到版本庫;你拉下更新之後,就迎來那個熟悉的「專案檔衝突」,而且往往無法在 Xcode 中正常開啟,非常惱人。
這其實是 Xcode 專案檔生成機制與版本控制之間的結構性矛盾。打開專案檔看一下內容:

每個檔案引用都由一長串 16 進位數字標識。問題在於,Xcode 的這套生成演算法在不同機器上對同一個檔案會算出不同的結果。同事提交時的專案檔是以他那台機器為基礎生成的,你更新後與自己機器上的版本比對,自然處處衝突。
xUnique 本質上就是一支 Python 腳本,它對 Xcode 生成的專案檔做一系列正規化處理。
流程大致是:先把專案檔轉成 JSON,把檔案引用改為路徑形式,接著對每個路徑做 MD5,用雜湊值替換掉 Xcode 原本生成的 16 進位 UUID。因為輸入是檔案路徑,任何機器算出來的值都相同,衝突問題也就隨之消失。
原理說完,來看怎麼用。
先用 pip 安裝:
$ pip install xUnique
安裝完成後開一個新的終端視窗,輸入 xunique 就能看到說明:

接上你的專案檔路徑即可處理:
$ xunique xxx.xcodeproj/project.pbxproj
執行後會看到類似輸出:
Uniquify and SortIgnore uniquify, no changes made to "/Users/Documents/samples/xUniqueTest/xUniqueTest.xcodeproj/project.pbxprojIgnore sort, no changes made to "/Users/Documents/samples/xUniqueTest/xUniqueTest.xcodeproj/project.pbxprojUniquify and Sort done
專案檔處理就完成了。但問題是:專案結構隨時可能變動,靠人工記得執行終究不可靠,一旦哪次忘了跑就提交上去,衝突照樣發生。所以最好讓它自動化。
如果你用 git,最直接的辦法是掛一個 pre-commit hook,每次提交前自動跑一次 xunique:
$ { echo '#!/bin/sh'; echo 'xunique path/to/MyProject.xcodeproj'; } > .git/hooks/pre-commit
記得把專案檔路徑換成你自己的,之後每次提交都會自動執行。
xUnique 算是解決 Xcode 專案檔衝突的一個折衷方案。前提是團隊每個人都正確安裝並設定好自動執行機制——只要有某台機器提交了未處理的專案檔,衝突依然會出現。但設定得當,它確實能明顯提升團隊協作效率。
覺得有幫助的話,可以關注微信公眾號 swift-cafe。
文章轉自 SwiftCafe