標籤: Tips

自動排序 Xcode 專案檔以減少合併衝突

Xcode 的 project.pbxproj 檔案採用文字格式儲存專案結構,但 Xcode 在新增檔案或修改設定時,不保證項目的插入順序一致。多人協作時,即使修改不同的檔案或 target,也可能因為項目順序差異而產生 merge conflict。這些衝突往往與實際變更無關,純粹是格式問題。

我的解決方案

project.pbxproj 中的各個區塊按固定規則排序,確保相同內容產生相同的檔案結構。配合 git pre-commit hook,每次提交前自動排序,團隊成員的專案檔就能維持一致的順序,大幅降低無意義的衝突。

我開發了一個腳本工具來執行這個任務,也已經在多個專案上跑了好幾年,GitHub repo 放在這裡:https://github.com/chiahsien/sort-Xcode-project-file

雖然目前推崇使用 Swift Package Manager 進行模組化,Xcode 16 也引入了 buildable folders 功能來減少專案檔變更,甚至也有 Tuist 或 Xcode Gen 這類的工具來生成專案檔,但這些新技術主要針對新專案或願意大幅重構的專案。對於已經開發多年、結構複雜的舊專案,貿然改用 SPM 模組化或轉換成 folder references 風險過高。此時,這個排序工具仍是最務實的選擇,能以最小成本解決 merge conflict 問題。

繼續閱讀 ➜

macOS 的「公用」與「投遞箱」目錄的用途

在每個 macOS 使用者的根目錄底下都有一個「公用 (Public)」目錄,而且這個目錄裡頭還有一個「投遞箱 (Drop Box)」目錄,身為 Mac 使用者這麼多年一直不知道它們的真正用途,直到最近...

最近因應疫情,很多人必須使用自己的電腦在家工作,然而我家只有一台電腦,所以我就幫家人建立一個新的使用者帳號方便工作用。建立好新的使用者帳號之後,該怎麼讓不同帳號之間共享檔案呢?這時候就需要「公用」跟「投遞箱」了:

  • 你要給別人:你放在「公用」目錄裡頭的檔案可以讓其他帳號存取,但是其他人無法修改或刪除檔案。
  • 別人要給你:其他帳號可以把檔案拖移到你的「投遞箱」目錄,但是只有你看得到「投遞箱」的內容,其他帳號看不到。

更詳細的說明可以參考蘋果官方說明文件