租賃無頭雲 Mac 上的 iOS 模擬器 xcodebuild test（2026）
在 香港、日本、韓國、新加坡、美國 租賃 裸金屬 Apple Silicon 雲 Mac 的團隊，常以 純 SSH 做自動化。理清 命令列工具 vs 完整 Xcode 與 並行構建紀律 之後，下一道常見關卡是不依賴真機農場的 iOS 模擬器 XCTest。本文說明無頭環境下 xcodebuild test 的行為：哪些 -destination 更穩、模擬器執行時期如何吃掉 NVMe（1 TB 與 2 TB 切片）、以及無人登入圖形工作階段時如何避免 UI 測試抖動。發布車道可搭配 遠端 Archive 與 依賴快取。
為何在專用雲 Mac 上做模擬器測試？
- 並行廣度 — 相對 USB 真機，更容易橫向鋪開以單元測試為主的大量案例。
- 可重現 OS 矩陣 — 固定
iOS 18.x與iOS 17.x執行時期，無需為每個版本單獨買機。 - 地域對齊 — 在 新加坡 或 美國 貼近 API mock 與合規邊界跑測試。
- 成本 — 模擬器分鐘不佔用稀缺真機槽位；但仍要誠實預算磁碟。
xcrun simctl list runtimes 輸出，共享機構建機剩餘空間低於 50 GB 時告警。
無頭現實（無 VNC 工作階段）
CoreSimulator 與 XCTest 多數場景無需 WindowServer，但隱患常見：依賴主螢幕幾何、SpringBoard 細節或相機/麥克風權限的案例，可能需要短時 VNC 排障——不必每晚建置都開 GUI。優先使用明確的無障礙識別碼、在測試啟動時關閉動畫，並避免綁定牆鐘渲染的 sleep。
xcodebuild test 前增加等待 simctl bootstatus 就緒的步驟。
選擇穩定的 -destination
CI 抖動常來自「最新 iPhone」在 Xcode 升級後解析變化。寫死所支援 OS 的主/次版本；若只需任意匹配模擬器，可優先通用平台 destination：
xcodebuild test -scheme MyApp -destination 'platform=iOS Simulator,name=iPhone 16,OS=18.2' -derivedDataPath /tmp/dd-$BUILD_ID
Xcode 升級後重新執行 xcrun simctl list devices available，把裝置名寫回流水線變數。日本、韓國 團隊仍使用英文裝置字串——在地化不改變模擬器識別碼。
CI 七步清單
- 若測試依賴 SwiftUI Previews 或特定模擬器套件，確保安裝完整 Xcode（非僅 CLT）。
- 主機存在多份 Xcode 時顯式匯出
DEVELOPER_DIR。 - 每個任務使用獨立
-derivedDataPath，避免與同帳號 Archive 任務串擾。 - 在準備指令碼中啟動目標模擬器，或交給
xcodebuild啟動——不要假設昨日仍處 boot 狀態。 - 按看板需要傳入
-resultBundlePath或-enableCodeCoverage YES。 - 上傳壓縮後的
.xcresult；至少保留 14 天 便於覆盤。 - 症狀為模擬器啟動而非斷言失敗時，附上
simctl diagnose輸出。
決策表：模擬器 vs 真機（雲 Mac）
| 需求 | 優先模擬器 | 優先真機 |
|---|---|---|
| 快速單元 / 邏輯測試 | ✓ 單機可承載大量並行 | 過重；UDID/線材摩擦 |
| Metal / 相機 / 推播權杖真實度 | 保真有限 | ✓ 裝置實驗室或本機硬體 |
| 描述檔 / 簽名迴歸 | 先做門禁 | ✓ 上架路徑前通常需要 |
NVMe 預算：1 TB 與 2 TB 建置機
| 佔用項 | 常見範圍 | 緩解 |
|---|---|---|
| 單套 iOS 執行時期映像 | 約 8–15 GB / 大版本 | 只保留矩陣需要的執行時期 |
| 每任務 DerivedData + ModuleCache | 約 3–25 GB / 流水線 ID | 刪除早於 7 天 的 /tmp/dd-* |
| 模擬器裝置資料波動 | 隨 UI 套件成長 | 每週 simctl delete unavailable |
當三套 iOS × 五個 scheme 共用一台 Mac mini M4 時，2 TB 往往比頻繁磁碟滿紅建置更划算；並行四份 Xcode 前先看 定價。
症狀與首要檢查
| 現象 | 檢查 | 方向 |
|---|---|---|
Unable to boot device |
磁碟空間；殭屍 CoreSimulatorService | 重啟或 killall -9 com.apple.CoreSimulator.CoreSimulatorService 後重試 |
| 找不到 destination | Xcode 修補後執行時期被刪 | 重裝平台；更新 YAML 裝置名 |
| 僅 SSH 主機 UI 逾時 | 動畫；SpringBoard 閒置 | 關閉動畫；謹慎加大啟動逾時 |
常見問題
| 問題 | 回答 |
|---|---|
| 同一使用者能混跑模擬器測試與 Archive 嗎？ | 可以，需隔離 -derivedDataPath 並遵守 並行構建 佇列規則。 |
| 每次失敗都要 VNC 嗎？ | 不必——日誌顯示僅 WindowServer 問題時再用 VNC。 |
| 如何不拖慢 CI 排錯？ | 在預發節點依 SSH 指南 互動重現，勿在生產建置機長時間試錯。 |
為何 MacXCode 的 Mac mini M4 適合模擬器 CI
模擬器負載混合 CPU、記憶體頻寬 與隨機 I/O：啟動執行時期、編譯 Swift 測試套件、推送 UI 事件。租賃 Mac mini M4 提供統一記憶體與快速 NVMe，且較超賣虛擬機更少鄰居抖動——矩陣橫跨 港 · 日 · 韓 · 新 · 美 時尤其明顯。自動化走 SSH，VNC 僅作視覺化排障。
磁碟檔位與模擬器保留策略對齊：1 TB 適合單產品線且積極清理；2 TB 更適合多團隊共享。若用雲端 CI 編排，可結合 GitHub Actions 自託管 Runner。
結論：在無頭租賃雲 Mac 上，釘死 destination、隔離 DerivedData、把模擬器磁碟當作一等預算，即可穩定執行 xcodebuild test。下一步：在推 TestFlight 前用 遠端簽名最佳化 收緊簽名鏈路。