
作者:@webfrogs
CI(持續集成)是一種軟件開發實踐,核心思想是把集成與構建自動化,讓問題尽早暴露。
在 iOS 開發中,打包 ipa 的傳統做法是在 Xcode 裡點 Product › Archive,等待歸檔完成,再在自動彈出的 Organizer 中選擇導出 ad hoc 或 enterprise 包。GUI 屏蔽了大量細節,但對於「執行一條命令然後去泡杯茶」的訴求來說仍然不夠。xcodebuild 正是為此而生。
目前已有不少成熟的封裝工具,例如 AFNetworking 作者 mattt 的 Shenzhen,以及 gym。它們本質上都是對 xcodebuild 的再封裝。
xcodebuild 屬於 Xcode Command Line Tools 的一部分,可以完成 iOS 工程的編譯、打包與簽名。不同 Xcode 版本參數略有差異,先查看幫助:
xcodebuild --help
它雖然屏蔽了大量編譯器細節,直接用起來仍偏繁瑣,實踐中通常值得再封一層。本文示例環境為 Xcode 7.1。

archive 的本質是:編譯並簽名,產出一個 .xcarchive 文件。下面的命令會把產物放到工程根目錄的 build 文件夾中:
xcodebuild -scheme <SchemeName> -archivePath build/<SchemeName>.xcarchive archive
Scheme 名稱可以在 Xcode 中查到。

若工程使用 CocoaPods,由於此時是 workspace,命令需要多一個參數:
xcodebuild -workspace <AppName>.xcworkspace -scheme <SchemeName> -archivePath build/<SchemeName>.xcarchive archive
這兩條命令分別適配 workspace 與非 workspace 工程,其餘配置(例如編譯 release 環境、簽名證書)都沿用 Target 與 Scheme 中已有的設置。
若想在命令執行時覆蓋配置,可以追加參數。例如歸檔 Debug 包加 -configuration Debug;非 workspace 工程還可用 PROVISIONING_PROFILE=<profile-uuid> 指定簽名描述文件。
注意:若下一步要導出 enterprise 類型的 ipa,所用 profile 中指定的 identifier 必須與對應 target 的 Bundle Identifier 完全一致,不能使用帶通配符 * 的 profile。
小貼士:archive 命令失敗時,可以在 Xcode 中點 Product › Archive 查看具體原因。若 Xcode 圖形操作沒問題,命令通常也能順利執行。
接著用 xcodebuild -exportArchive 把 xcarchive 導成 ipa:
xcodebuild -exportArchive -exportFormat IPA -archivePath <AppName>.xcarchive -exportPath <AppName>.ipa
需要留意:Xcode 7 官方推薦使用 -exportOptionsPlist 參數(該形式支持 bitcode),但實測中我們的工程用這種方式無法正確導出,具體原因未查明,猜測與工程未啟用 bitcode 有關。因此這裡仍採用 Xcode 6 時代的 -exportFormat IPA。
如果要在導出階段更換簽名 profile,有兩種方式:
-exportProvisioningProfile <profile name>:直接指定新的 profile,適用於單 target 工程。-exportSigningIdentity <signing identity name>:適用於多 target 工程(例如包含 WatchKit 與 WatchKit Extension,各自需要不同 profile)。前提是相關 profile 已正確安裝,identity 可在鑰匙串中查到。
以名為 Tyrion 的工程為例,Scheme 同名,歸檔命令:
xcodebuild -scheme Tyrion -archivePath build/Tyrion.xcarchive archive
導出命令:
xcodebuild -exportArchive -exportFormat IPA -archivePath build/Tyrion.xcarchive -exportPath build/Tyrion.ipa
兩條命令依次執行後,build 文件夾內容如下。

拿到 ipa 後,可以用 iFunBox 之類的工具直接安裝到 iPhone,也可以通過 itms-services 協議做遠程分發。
就整個 CI 體系而言,命令行出包只是第一步,後續還需要解決自動分發與持續構建的問題,本文先到此為止。