2026年獨佔遠端 Mac CI:Swift Testing(巨集)與 XCTest 混跑怎麼裁?——編譯耗時、並行度、Simulator 配額與 SSH 無頭 flaky 決策矩陣 + FAQ
在獨佔一台遠端 Mac 跑 CI 時,Swift Testing(依賴編譯期巨集展開的新測試框架)與既有 XCTest 往往長期並存。「裁」的不是二選一宣言,而是編譯分區、並行上限、Simulator 啟動配額、以及 SSH 無頭環境下的復現紀律。以下把可執行判斷收成矩陣與 FAQ;Runner 池與帳戶隔離可對照 GitLab Runner(macOS)與 GitHub Actions 自託管 Runner 在獨佔遠端 Mac 上的決策矩陣; checkout/快取鍵與 SSH 拉取策略可對照 獨佔遠端 Mac CI:Git blobless/淺克隆與 SSH checkout 決策矩陣 + FAQ。
1. 混跑時「編譯耗時」最先爆炸:巨集與 XCTest 的分區
Swift Testing 的斷言與套件組織大量依賴巨集(例如 #expect、@Suite 等寫法,視工具鏈版本而定)。巨集展開會增加前端工作量與增量編譯的重編面;與 XCTest 混在同一個 test target 時,一次小改動也可能觸發「XCTest 橋接 + Swift Testing 產生程式碼」的雙重編譯路徑。
- 建議預設:為 Swift Testing 單獨劃分
*.xctest/SwiftPM test target,與既有 XCTest target 實體隔離;主工程 Scheme 以 Test Plan 控制「PR 門禁跑哪幾組」。 - CI 裁剪:在「僅改 UI/僅改 ObjC 橋」類 PR 上跳過 Swift Testing target,需要明確的檔案路徑或
CODEOWNERS規則,避免誤跳過。 - 工具鏈釘死:將
xcodebuild -version與 Swift 語言模式寫入 Runbook;巨集行為隨編譯器升級變化,比 XCTest 更敏感。
2. 編譯耗時裁切:決策矩陣
| 症狀 | 優先動作 | 代價 |
|---|---|---|
| Clean build 測試階段占比過高 | 拆分 Swift Testing target;開啟模組穩定化與 DerivedData 快取鍵規範化 |
Scheme/Test Plan 維護成本上升 |
| 增量編譯仍慢、巨集相關檔案頻繁重編 | 縮小「巨型共用 fixture」被巨集檔案遞迴 import 的面積;審查 @testable import 範圍 |
需要程式碼層解耦 |
| 僅夜間全量、PR 要極快 | PR 跑 Swift Testing 冒煙子集 + main 合併前跑全 XCTest/全量 | 分層門禁要防「子集綠、全量紅」 |
3. 並行度:混跑不是「執行緒加倍」
xcodebuild test 的並行測試會放大Simulator 行程數、磁碟 IO 與編譯子行程。Swift Testing 與 XCTest 同一次 invocation 內並行,往往比「兩次順序單框架」更爭用記憶體——因為連結產物與執行時中繼資料都在同一使用者空間。
- 基線做法:先以
-parallel-testing-enabled NO或限制-maximum-parallel-testing-workers建立穩定基線,再階梯加壓記錄失敗率。 - 分拆 Job:Swift Testing target 與 XCTest target 分到兩個 CI Job(仍是一台獨佔機時循序執行),換取更清楚的
xcresult歸因。 - 與 UI 測試隔離:UI 測試與單元/Swift Testing 不要共享尖峰並行度;否則 Simulator 啟動風暴會掩蓋真實的編譯問題。
4. Simulator 配額:獨佔機也有硬上限
獨佔消除租戶間爭搶,不消除 CoreSimulatorService 與記憶體分頁壓力。經驗上,併發 boot 的模擬器數量與可用 RAM、SSD 餘量、以及是否同時跑 watch/tv 目的地高度相關。
| 機型記憶體檔 | 建議併發 Simulator 上限(起點) | 備註 |
|---|---|---|
| 16GB | 1–2 個重度 UI/混合測試;純邏輯可略高但仍需壓測 | Swift Testing + XCTest 同跑時偏保守 |
| 24–32GB | 2–4 視 destination 與截圖/螢幕錄影開關 | 監控 memory_pressure 與 SSD 延遲 |
| 64GB+ | 可更高,但仍受 Xcode/系統缺陷與 IO 尾延遲約束 | 「高記憶體 ≠ 無限並行」 |
Runbook 應寫明:每次 Job 前銷毀/復用 booted 裝置策略、是否 xcrun simctl shutdown all、以及是否與鑰匙圈/登入工作階段相關(見下一節)。
5. SSH 無頭 flaky:裁「環境」而不是裁案例
透過 SSH 觸發 xcodebuild 時,常見 flaky 來自圖形工作階段、鑰匙圈解鎖、Simulator 首次啟動競態、以及無外接螢幕時的 GPU 路徑差異。與 Swift Testing/XCTest 本身無直接因果,但會在「並行提高」後集中暴露。
- 工作階段類型:區分
launchdAgent、ssh 非互動 shell、與螢幕登入使用者;同一測試在三種環境下權限邊界不同。 - 鑰匙圈:簽章/嵌入式 provisioning 若依賴互動式解鎖,CI 會間歇失敗;以專用 CI 使用者 + 預置描述檔/非互動憑證注入,並在 Runbook 記錄輪換。
- 復現門檻:對「僅 CI 紅」以同一 SSH 命令重播 + 固定
SIMCTL_CHILD/亂數種子;連續 N 次一致再改測試或產品程式碼。
6. 總覽決策矩陣(怎麼裁)
| 你的約束 | 傾向裁法 |
|---|---|
| PR 延遲敏感、巨集編譯重 | Swift Testing 獨立 target + PR 子集;全量夜間 |
| 穩定性優先、偶發逾時 | 降低並行 worker;拆分 Job;Simulator 依序 boot |
| SSH 無頭、無登入 GUI | 先修工作階段/鑰匙圈/啟動競態;再談加並行 |
| 報告要單一真相來源 | 每 Job 單一 xcresult 路徑;避免多階段互相覆寫 |
7. FAQ
Q1:能不能把所有測試都遷到 Swift Testing 再關掉 XCTest?
可以作方向,但 CI 裁切應分階段:先並行共存、依模組遷移、以 Test Plan 控制門禁集合;一次性切換會讓編譯圖與 flaky 歸因同時失控。
Q2:Swift Testing 巨集導致編譯慢,能否只靠加大 -j 或更多 Runner?
橫向擴容掩蓋不了單一 target 巨集扇出;若瓶頸在 Swift 前端,增加並行 Job 可能放大 IO 與 Simulator 爭用。優先 target 拆分與快取鍵。
Q3:獨佔 Mac 上仍然 flaky,是不是測試寫壞了?
不一定。先對照本節 SSH/鑰匙圈/Simulator 配額清單做二分:同一提交在本機 GUI 使用者綠、僅 SSH 紅,優先判定為環境類 flaky。
在 Mac mini 上固化這套裁切策略
Swift Testing 與 XCTest 混跑對 CI 的真實要求是可預測的編譯圖、穩定的使用者工作階段與足夠的記憶體頻寬。Apple Silicon Mac mini 在長時間 xcodebuild 與多 Simulator 混合負載下仍具較佳能效比,適合作為獨佔自託管節點;macOS 上 SSH、指令稿與鑰匙圈自動化路徑成熟,比異質雲 Mac「黑箱」更易寫進 Runbook。安全面向上,Gatekeeper、SIP 與 FileVault 便於為 CI 專用帳戶做最小暴露面;總持有成本上,小體積、低待機功耗與靜音運行對 7×24 流水線更友善。
若你希望把上述矩陣落到一台可長期獨佔的機器上,Mac mini M4 仍是 2026 年高性價比的起點——從首頁了解方案,把並行度基線與 Test Plan 一起固化即可。