對 iOS 開發者來說,project.pbxproj 可說是每天見面卻很少真正閱讀的檔案。它保存了專案的所有結構與設定,包含檔案引用、群組分類、Build Settings 與 Target 資訊。
雖然日常開發多半透過 Xcode 的 General、Build Settings 與 Info 面板修改設定,但在自動化或 CI 場景中,直接處理 pbxproj 往往更有效率。
大型專案常有 App、Today Widget、Watch App 等多個 Target。不同開發者的證書與描述檔可能不同,若交給 Jenkins 自動編譯,容易因簽名設定不一致而失敗。
在 pbxproj 中,每個 Target 的 XCBuildConfiguration 都有一段設定,其中包含 PROVISIONING_PROFILE。可透過 Target 的專屬編號找到對應區塊,再將描述檔替換為伺服器上的 mobileprovision。
這種方式適合用於 CI 編譯前自動修正簽名,也能延伸去修改 Bundle Identifier、整理專案結構或批次處理其他設定。