2026 Mac mini M4 租賃:Xcode CI 歸檔產物怎樣留存?

CI 顯示上傳成功,租賃節點卻快要退租;如果 archive 和 dSYM 仍只在本機,之後可能無法還原已發布版本的除錯符號。
最快解法:勝出的做法是讓 Mac mini M4 租賃節點負責建置,團隊控制的持久化儲存負責留存;PR、測試版和正式發布採不同清理規則。
獨立開發者:需要在發布後追查崩潰,或重建特定版本。
行動端全端工程師:需要分清可重建的 CI 產物與必須追溯的發布產物。
App 團隊技術負責人:正在制定備份、節點清理與退租交接流程。
Mac mini M4 租賃的 Xcode CI 歸檔產物,先按用途分流
「建置完成」不等於「發布證據已保存」。Xcode archive、匯出的分發檔、建置日誌和 dSYM 用途不同,不應把它們混成一個可隨時清空的目錄。
Apple 說明,Xcode archive 是供後續分發使用的封存內容,並包含建置與除錯所需資訊;對已分發版本,Apple 要求保留相應的 archive。Apple 的 Xcode 分發與 archive 說明 因此,已發布版本的 archive 不應只依賴租賃節點本機硬碟。
| 產物 | 主要用途 | 建議處理方式 |
|---|---|---|
| Xcode archive | 留存建置與除錯資訊,支援後續分發及追查 | 已分發版本移至團隊控制的持久化儲存 |
| 匯出的分發檔 | 提供實際分發或交付使用 | 與版本、建置識別資訊一併留存;不要用它取代 archive |
| dSYM | 將崩潰堆疊中的位址轉成可讀的符號資訊 | 與對應建置核對後共同備份 |
| 建置日誌與測試結果 | 定位 CI 失敗、測試異常與環境問題 | 依用途保留;確認問題已結案後再按團隊規則清理 |
這張表的決策重點不是「每種檔案都永久保存」,而是先辨認哪些檔案支援已分發版本的診斷,哪些只服務一次性的建置。團隊可以按專案、版本與建置識別資訊整理目錄或索引,讓人不必靠檔名猜測內容。
PR 建置可以清理,但失敗證據要先結案
PR 和日常驗證通常是可重建流程:程式碼、依賴和建置設定仍可用時,通過驗證的臨時產物通常不需要像正式發布 archive 一樣長期保存。但「可重建」不代表所有檔案都能在工作結束時立即刪除。
測試失敗、簽署錯誤或依賴下載異常,往往需要日誌和測試結果才能定位。若只留最後的成功狀態,稍後就難以判斷問題是程式碼變更、CI 環境還是測試本身造成。相反地,對已通過且不會被分發的 PR 建置,若團隊已確認不需要追查或比較,archive、暫存匯出檔便可按內部規則清理。
PR 通過後,哪些資料仍值得留下?
至少先確認相關失敗已完成分析,且必要的日誌、測試結果或缺陷追蹤資料已移交。保留期限由團隊依除錯、審核和合規需求決定;Apple 的發布文件不能替每個團隊設定通用天數,這裡也不應自行編出固定期限。
測試版要讓 archive、dSYM 與上傳記錄互相對得上
TestFlight 測試版的重點,是日後能辨認測試者實際取得哪個建置。建議將測試版 archive、對應 dSYM、匯出產物,以及版本和建置識別資訊放在同一筆可追溯紀錄下。上傳成功的畫面或平台記錄,能證明某個建置有上傳狀態,卻不能據此假設團隊手上的 archive 和符號檔已完成備份。
Apple 的 App Store Connect 文件說明,團隊可以查看已上傳建置及其相關中繼資料;上傳狀態也能用來核對建置紀錄。查看建置與中繼資料及上傳建置與中繼資料說明可作為核對依據。這些平台記錄應與團隊自己的產物清單相互參照,而不是當作本地診斷檔案的替代品。
上傳 App Store Connect 後,還要不要留本地副本?
需要時,團隊應保留可供故障診斷的 archive 和對應 dSYM;是否另外留存匯出檔,則依分發、交付與復原需求決定。平台上的建置中繼資料有助辨識版本,但不能保證團隊已保存可供自己使用的完整診斷資料。
正式發布將產物移出節點,避免只剩應用程式檔
正式發布不宜沿用 PR 清理邏輯。將發布 archive 和 dSYM 存入團隊控制、可在租賃節點退租後存取的位置,並記錄專案、版本、建置識別資訊和分發狀態。若團隊另需保存匯出的分發檔,也應在索引中清楚標明用途,避免它與 archive 混淆。
dSYM 與應用程式二進位檔的對應不能只靠相似檔名判定。Apple 的文件指出,符號檔需要對應到相關建置;可按 UUID 核對 dSYM 與崩潰報告中的識別資訊。Apple 的 dSYM UUID 核對方法說明了這項核對方式,而缺少除錯符號檔時的識別資訊說明則可協助辨認建置與符號檔是否相符。這是比「檔名看起來一致」可靠得多的檢查依據。
崩潰排查要從備份恢復驗證,不只看檔案存在
只備份應用程式封裝檔,可能不足以符號化崩潰報告。沒有匹配的 dSYM,崩潰堆疊就可能無法轉成可讀的函式與位置資訊。Apple 對建置除錯資訊與 dSYM 的說明及分析崩潰報告的文件都將符號資訊納入診斷流程。
核驗時,先從團隊儲存位置取回某個已分發版本的 archive 和 dSYM,再以 UUID 等識別資訊比對建置。接著確認 archive 能被 Xcode 讀取,並檢視所需的崩潰報告能否使用匹配符號完成分析。這是流程要求,不應預先假設備份一定完整,也不應把檔案上傳成功當成恢復測試。
退租前完成清點與交接,再處理節點本機資料
租賃 Mac mini M4 退租後,Xcode archive 應該放在哪裡?
退租前先將必須留存的 archive、dSYM 和相關紀錄移至團隊控制的持久化位置,並由團隊成員確認可存取、可下載和可核對。租賃節點只承擔建置期間的工作副本,不應被當成發布檔案的唯一倉庫。
可將以下項目納入交接檢查:
- [ ] 列出已分發版本及需要追溯的測試版,逐一確認相應 archive 是否已遷出。
- [ ] 確認 dSYM 與對應建置的 UUID 等識別資訊相符,不只檢查檔名。
- [ ] 確認匯出產物、版本資訊、建置識別資訊與上傳紀錄能相互對照。
- [ ] 從團隊持久化儲存取回備份,實際核對 archive 可讀取、符號檔可用。
- [ ] 確認團隊有權存取保存位置,再清理節點上的暫存與工作副本。
- [ ] 將需保留及可清理的項目交接清楚,避免把團隊的歸檔責任誤當成租賃服務方的設備清理責任。
節點資料如何遷出、退租時由誰執行清理,取決於實際租用條款與可核實的服務說明,不能只憑「租賃」二字推定。若要確認相關流程,可先查閱ProxyMac 的說明頁面,並就未列明的資料遷出事項向服務方確認;在確認完成前,團隊仍應自行確保發布歸檔已保存。
如果現行做法是把 archive 留在單一 CI 節點,真實風險包括節點退租後本機資料不再可用、團隊成員無法自行存取,以及缺少 dSYM 時崩潰分析受阻。較穩妥的分工,是讓 Mac mini M4 租賃承擔建置算力,團隊儲存承擔發布留存;若工作負載長期穩定且需要固定實體設備,自購 Mac 也值得納入比較。若只是階段性增加 Xcode CI 建置能力,可依實際流程評估租用方案,再查看ProxyMac 的方案資訊;無論選擇哪種方式,正式產物都應先完成遷出與恢復核驗。