
本文為投稿文章,作者為陳興Startry。
多數 App 都會面臨開發環境與正式環境切換的問題。常見做法是透過巨集判斷目前是否為 Debug 環境,但這種方式若散落在程式碼中,後續維護與自動化打包都會變得困難。
其中一種改善方式,是把環境標志放到 Build Settings 的 Preprocessor Macros 中。這樣可依照不同 Configuration 設定不同值,而不必每次修改程式碼。

xcconfig 可以用來集中管理 Build Settings。相較於直接在 Xcode 介面中逐項修改,xcconfig 更適合版本控制、自動化腳本與多專案共用。
在 Objective-C 中,可透過 xcconfig 設定 GCC_PREPROCESSOR_DEFINITIONS。若使用 Swift,則需要透過 OTHER_SWIFT_FLAGS,例如加上 -D DEBUG,讓條件式編譯能正確作用。

將環境設定抽到 xcconfig 或 Build Settings 後,就能用 xcodebuild 或腳本動態切換。這對 CI、自動化打包與多團隊協作都很重要。
若使用 CocoaPods,也要注意 Pods 會產生自己的 xcconfig。可透過 Podfile hook 修改參數,或在自己的 xcconfig 中 include CocoaPods 產生的檔案。
需要注意的是,巨集與編譯期設定只能提供初始值。若希望使用者在 App 執行時切換環境,就必須改用變數儲存設定,例如 NSUserDefaults 或 Singleton。
整體而言,將環境設定從程式碼中抽離,交給 xcconfig、腳本或外部設定管理,是提升 iOS 專案維護效率的重要做法。