看別人寫 iOS 自動化打包時,總覺得只是幾行指令;但真正自己設定時,才會發現簽名、證書、ipa 結構與 App Store 上傳限制處處是坑。本文整理 xcodebuild 與 xcrun 的常見用法,以及實務上容易踩到的問題。
常見的打包流程會用到兩個工具:xcodebuild 與 xcrun。前者可用來建立 Archive、導出 ipa,也能執行其他建置任務;後者則常用來把 app 打包成 ipa。兩者搭配使用,能覆蓋大多數自動化輸出需求。
第一步是透過 xcodebuild 建立 Archive。這階段需要指定 workspace、scheme、platform 與 archivePath,並確認專案簽名與證書設定正確。若簽名有問題,後續即使成功打包,也可能在上傳或安裝時失敗。
第二步可嘗試用 xcodebuild 從 archive 導出 ipa。此時需要指定 archivePath、exportPath 與發布證書名稱。這裡常見的誤解是填入證書的 id,實際上通常需要的是 Provisioning Profile 或發布證書的名稱。
另一種方式是使用 xcrun PackageApplication,把 app 直接打包成 ipa。這個方式在某些情況下更適合用來產生可上傳 App Store 的版本,但輸出路徑要避免使用相對路徑,因為執行環境的工作目錄可能與預期不同。
有些使用 xcrun 產生的 ipa 在 App Store Connect 顯示正在構建後,稍晚卻收到錯誤通知,原因可能是包內缺少 SwiftSupport。解決思路是將 ipa 解壓,從 archive 中找到 SwiftSupport 目錄並複製進去,再重新壓縮並改回 ipa 副檔名。這類處理較為手動,適合在自動化流程尚未完全穩定時作為應變。
如果不想自己處理所有細節,也可以參考開源工具,例如 nomad/shenzhen。這類工具把打包與發布流程封裝起來,能減少重複踩坑的成本。對於需要快速建立發布流程的團隊,直接使用成熟工具往往比自行摸索更有效率。
iOS 自動化打包看似只是命令列操作,實際上牽涉到簽名、證書、ipa 結構與 App Store 驗證規則。把常見坑點記錄下來,並逐步補齊流程,才能讓打包與上傳變得穩定、可重複。