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

告別 pbxproj 衝突:用 xUnique 讓 Xcode 專案檔能被版本控制正確合併

編輯:iOS 開發基礎

多人協作時,只要有人新增或刪除檔案,project.pbxproj 幾乎必然衝突,而這個檔案一旦衝突,專案往往連打開都有困難。xUnique 就是為了解決這個痛點而出現的第三方工具。

問題背景

團隊成員往專案裡加了幾個檔案,Xcode 會重新生成專案檔,他們把變更提交到版本庫;你拉下更新之後,就迎來那個熟悉的「專案檔衝突」,而且往往無法在 Xcode 中正常開啟,非常惱人。

這其實是 Xcode 專案檔生成機制與版本控制之間的結構性矛盾。打開專案檔看一下內容:

每個檔案引用都由一長串 16 進位數字標識。問題在於,Xcode 的這套生成演算法在不同機器上對同一個檔案會算出不同的結果。同事提交時的專案檔是以他那台機器為基礎生成的,你更新後與自己機器上的版本比對,自然處處衝突。

xUnique 的原理

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 hook 自動化

如果你用 git,最直接的辦法是掛一個 pre-commit hook,每次提交前自動跑一次 xunique:

$ { echo '#!/bin/sh'; echo 'xunique path/to/MyProject.xcodeproj'; } > .git/hooks/pre-commit

記得把專案檔路徑換成你自己的,之後每次提交都會自動執行。

結語

xUnique 算是解決 Xcode 專案檔衝突的一個折衷方案。前提是團隊每個人都正確安裝並設定好自動執行機制——只要有某台機器提交了未處理的專案檔,衝突依然會出現。但設定得當,它確實能明顯提升團隊協作效率。

覺得有幫助的話,可以關注微信公眾號 swift-cafe。

文章轉自 SwiftCafe

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