標籤: Development

自動排序 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 問題。

繼續閱讀 ➜

如何建立 iOS Share Extension

在網路上已經有很多關於 iOS Share Extension 的教學,例如這裡就有一篇。有需要的人可以自行在網路上搜尋,這邊就不多作著墨。我這次想要分享的主要是在開發 share extension 的過程遇到一些要注意的事項,以及踩到的一些坑。

我的開發環境是 macOS Sonoma + Xcode 15,使用 Swift 開發。

要建立一個 share extension 很簡單,就是在你的專案新增一個 target 然後選擇 Share Extension 即可。Xcode 會自動幫忙產生必要的檔案,以及做好基本設定。

繼續閱讀 ➜

必備的 Visual Studio Code 套件

Visual Studio Code 是我預設的文字編輯器,它跨平台、執行速度快、開啟大檔案沒問題、擴充套件眾多,是我選擇用它的主要原因。底下列出一些對我幫助很大的擴充套件:

繼續閱讀 ➜

如何下載、安裝、管理 Xcode

下載

不要透過 AppStore,因為速度太慢太不穩定了,要去官方網站下載才快。但是我們還有更快的方法,可以透過下載軟體同時開啟多條連線下載,我推薦使用 XcodesAppDownloader-for-Apple-Developers,前者比較漂亮,後者還可以下載 WWDC 的影片。

安裝

不要直接解壓縮 xip 檔,這樣會花很長的時間。下指令去解會快很多:

xip -x Xcode.xip

管理

可以放多個不同版本的 Xcode 在 Applications 資料夾,只要名稱不一樣就好了,記得要下指令來指定要使用哪個版本。

sudo xcode-select -s /Applications/Xcode.app

時間久了之後,會產生很多沒再用的檔案佔用空間,我們可以使用 DevCleaner for XcodeXcodeCleaner-SwiftUI 來幫忙清理,效果非常的好!

參考資料

安裝 Xcode 的正確姿勢

如何在 Debug mode 自動停用 ATS

蘋果在 WWDC 2015 上發表了 App Transport Security (ATS),大力推廣網路安全連線。對於這樣的發展,我個人是樂見其成的,也相信在蘋果的影響力之下,安全連線也會進一步的普及。

不過對工程師來說,這代表你又要修改程式,以便符合蘋果規範了。在修改的過程中,我就遇到了一個問題:Release 版的 app 是會走安全連線的,但在 Debug 的時候它是連到本機(localhost),這不是安全連線。該怎麼讓它在 Release / Debug 都能正常連線呢?

繼續閱讀 ➜