
在 iOS 專案中,開發環境與正式環境的切換是常見需求。若僅依賴預編譯巨集,雖然可行,但維護成本較高。本文介紹如何透過 xcconfig 與 Build Settings,更優雅地管理 Debug 與 Release 設定。
許多團隊會在 PCH 或原始碼中定義 DEBUG 巨集,再依此切換 API 位址、測試資料或功能開關。這種方式直覺,但容易讓設定散落在程式碼中,難以統一管理。
若能把環境變數提取到 Build Settings 或 xcconfig 中,就能讓外部腳本、CI 流程與不同 Configuration 更容易控制。
在 Build Settings 中,可以設定 GCC_PREPROCESSOR_DEFINITIONS。這與在 PCH 中定義巨集的效果類似,但多了幾個好處。

首先,Build Settings 可由外部工具修改。其次,它可以依不同 Configuration 設定不同值。最後,搭配 xcconfig 後,管理會更集中且清楚。
xcconfig 可以用來集中管理 Build Settings。相比在 Xcode 介面中逐項修改,這種方式更適合版本控制與自動化流程。

不同 Configuration 可指定不同 xcconfig 檔,例如 Debug 與 Release 各自維護一份設定。這樣一來,環境切換就不再依賴手動改程式碼。
Swift 與 Objective-C 在預處理器支援上略有不同。Swift 只使用較安全的預處理器子集,因此若要讓條件式判斷生效,需透過 OTHER_SWIFT_FLAGS 設定相關旗標。
若團隊使用自動化打包,將環境變數放在 xcconfig 或 Build Settings 中會更方便。因為可以透過 xcodebuild 指定 Configuration,或在腳本中動態修改設定,而不必直接改動原始碼。
CocoaPods 也會使用 xcconfig 管理專案設定。若自訂 xcconfig,需注意與 Pods 產生的設定檔整合。常見做法是透過 include 方式引入 CocoaPods 設定,或在 Podfile 中撰寫 hook 進行調整。
需要注意的是,透過編譯期巨集設定的值,通常只能作為初始值。若希望在 App 執行時動態切換環境,則需將設定存入變數,例如使用者預設或單例物件,並提供設定介面。
良好的環境配置方式,能讓開發、測試與正式流程更清楚。將環境變數從程式碼中抽離,改用 xcconfig 或 Build Settings 管理,不僅提升可維護性,也讓自動化流程更容易整合。