Archive 是 iOS 送交 App Store 審核或做企業分發前的必經程序。這個操作本身只要按一下按鈕,但前置設定如果沒配好,就會在匯出 IPA 時才發現簽章有問題,白跑一趟。以下把整個流程與容易忽略的細節整理出來。
進入專案設定的 Build Settings,找到 Code Signing Identity,為對應的應用程式選擇正確的 Provisioning Profile。這裡設的是專案層級的預設值。
切到 TARGETS 的 Build Settings,同樣找到 Code Signing Identity 並選擇 Profile。
為什麼兩層都要設?因為 Target 層級的設定會覆蓋 Project 層級。如果你的專案有多個 target(例如含測試 target 或多個 App 變體),只在其中一層設定,很容易出現「某個 target 簽不上去」的狀況。實務上建議兩層都明確指定,不要留著預設值靠猜。
在 Xcode 頂端的 scheme 選單中,把執行目標從模擬器改為 iOS Device。Archive 只能針對實體裝置進行,停在模擬器時 Product 選單裡的 Archive 是灰色的。
接著從 Xcode 選單進入 Product > Edit Scheme。
在 Edit Scheme 視窗中切到 Archive 分頁,把 Build Configuration 設為 Release,並勾選 Reveal Archive in Organizer。
Build Configuration 選 Release 是關鍵:Debug 設定不適合上線,可能帶著測試用的最佳化關閉、日誌輸出等行為。勾選 Reveal Archive in Organizer 則能讓封存完成後自動開啟 Organizer,省去手動翻找的時間。
最後從選單執行 Product > Archive,Xcode 會開始編譯並產生 Archive 檔案。完成後可在 Organizer 中查看歷史封存紀錄,並直接匯出 IPA 或上傳至 App Store Connect。
Archive 失敗最常見的原因不是程式碼,而是簽章:憑證過期、Profile 裡的裝置清單沒包含測試機、Bundle Identifier 與 Profile 不匹配,都會在這個階段才爆發。打包前先確認開發者帳號的憑證狀態,能省下不少時間。
另外,Archive 產出的是「特定時間點的程式快照」。每次送審前重新 Archive 一次,不要沿用舊的封存檔,才能確保上傳的位元組與你當下測試過的程式碼一致。