Flutter 3.47 iOS CI 哪些任務必須放在 Mac?2026 指南
Flutter 官方已列出 Flutter 3.47.0 的發布說明;這個版本號本身不代表整條流水線都必須搬家。Flutter 3.47.0 發布說明可核對版本資訊,而官方 iOS 設定要求與平台文件表明,iOS 工具鏈工作需要 macOS。建議保留通用 Dart 檢查在現有環境,把 iOS 建置、模擬器驗證及簽名發布分派給 macOS 節點;先拆任務,再評估是否需要常駐的遠端 Mac。
適合維護 Flutter iOS 專案、希望保留現有開發環境的行動開發者。
適合需要按平台拆分工作並驗證任務路由的 CI 工程師。
適合正在評估新增或租用 macOS 建置節點的平台負責人。
最後更新於 2026 年 10 月 2 日;版本與平台要求依 Flutter 支援平台頁面、Flutter iOS 設定指南及官方 iOS 發布指南核對。
Flutter 3.47 iOS CI 任務邊界
判斷重點不是「專案有沒有 iOS 目標」,而是某項工作是否實際調用 Apple 平台工具鏈。Flutter 官方將 iOS 列為支援平台,並在 iOS 設定說明中列出 macOS 與 Xcode 的前置條件;因此 iOS 編譯、模擬器相關工作,以及依賴 Xcode 的發布環節,應使用 macOS 節點。這是官方工具鏈邊界,不等於所有 Dart 程式碼檢查都必須遷移。
可留在現有節點的通用檢查
格式檢查、靜態分析、依賴解析,以及不涉及 iOS 原生工具的 Dart 單元測試,通常可以先留在現有 Linux 或其他節點。Flutter 的測試類型說明區分單元、Widget 與整合測試;實際能否在特定節點執行,仍要看測試是否觸及平台通道、外掛或原生元件。
路由前可在既有節點跑同一組檢查,並記錄套件解析、測試輸出與失敗原因。若錯誤來自缺少 iOS SDK、Xcode 或模擬器,才應把相應工作交給 Mac;若錯誤是 Dart 程式本身或套件相容性問題,換節點不會自動修復。
必須安排 macOS 的 iOS 建置與模擬器驗證
Flutter iOS 建置需使用 macOS 與 Xcode,官方的iOS 設定指南可用來核對工具鏈前置條件。因此,針對 iOS 目標的編譯、需要 iOS Simulator 的建置及執行,都應排入 macOS 工作,而不是要求 Linux 節點模擬 Apple 工具鏈。
驗收時須分清三種結果:模擬器建置證明相應目標可以編譯;模擬器執行可檢查部分安裝與執行流程;真實裝置測試則用於驗證裝置上的行為。前兩者不能直接代替真機驗收。若產品依賴相機、推播、藍牙或其他裝置能力,CI 記錄就應明確標示測試覆蓋範圍,而非將「建置成功」當作完整裝置測試。
原生外掛與整合測試的分流
外掛存在,不代表每一項檢查都要搬到 Mac。若測試只驗證 Dart 層的資料處理或業務邏輯,且不呼叫原生實作,可先留在通用節點;如果修改涉及 Swift、Objective-C、Xcode 專案設定、平台通道或外掛原生端,就需要在 macOS 上做相應的整合驗證。
Flutter 的外掛測試指南說明外掛測試的考量;整合測試文件則可協助確認測試所需的執行環境。團隊可按變更範圍安排工作:Dart 層測試在現有節點先行,原生依賴的整合測試再交由 Mac。這種拆分既能保留通用工作,也不會漏掉平台專屬錯誤。
簽名、歸檔與發布權限
簽名、歸檔與發布應視為受權限控制的 macOS 工作,而不是一般測試的附帶步驟。Flutter 的iOS 發布指南說明 iOS 發布流程;Apple 的應用程式測試與發布文件則提供分發相關資訊。流水線設計應以需要的工具鏈、憑據存取權與可核對的產物為依據,不預設某種 CI 服務或發布結果。
實務上,先將不需要簽名的程式碼檢查與測試,和需要簽名身分、歸檔或發布權限的工作分開。限制敏感憑據只對必要工作可用,並保存建置記錄與歸檔產物,以便檢查本次執行實際使用的提交與結果。若只是在驗證編譯,便不必為該工作開放發布憑據;若要發布,則應另行確認憑據管理、授權範圍與人工核准責任。
FAQ:跨平台任務與 iOS 工作
Linux 上的 Dart 測試
可以把不依賴 Apple 工具鏈的 Dart 檢查與測試留在 Linux,但要先確認套件與測試不要求 iOS 原生實作、模擬器或平台通道。Flutter 測試文件將測試類型分開說明;團隊應依測試實際使用的功能判斷執行位置,而不是只看專案是否包含 iOS 目標。
iOS Simulator 驗證
凡是需要 iOS Simulator 的建置或執行,都應安排在具備 macOS 與 Xcode 工具鏈的節點。模擬器可提供 iOS 目標的建置與部分執行證據,但不等於真實裝置驗收;測試報告應標明執行環境及覆蓋範圍,避免把模擬器結果誤寫成真機測試結論。
Flutter iOS 簽名與歸檔
將簽名與歸檔安排為獨立的 macOS 工作,讓一般測試不必取得發布憑據。發布工作只在需要時讀取相應憑據,並保存可核對的建置資訊與歸檔產物;這樣能明確界定發布權限,也方便確認某次流水線究竟執行了哪些步驟。
跨平台工作流的節點配置
Android、Web 與 iOS 的工具鏈需求不同,不應把整個多平台流水線綁在單一節點上。只要某項 Android 或 Web 工作在目前環境可執行,就可留在現有節點;Flutter iOS CI 則把需要 macOS、Xcode 或 iOS Simulator 的工作路由至 Mac。若專案有共用的 Dart 檢查,可讓各平台工作先共享檢查結果,再各自執行平台建置與驗證。
任務路由檢查清單:
- [ ] 把格式檢查、靜態分析、依賴校驗與一般 Dart 測試列為通用工作,逐項確認是否碰觸原生功能。
- [ ] 將 iOS 目標建置及 iOS Simulator 建置、執行標記為 macOS 工作,並在工作記錄中保留目標平台。
- [ ] 若變更包含 Swift、Objective-C、Xcode 專案設定或外掛原生端,安排 macOS 整合驗證。
- [ ] 將簽名、歸檔與發布工作分開,逐項檢查憑據存取範圍及必要核准。
- [ ] 用代表性提交驗證每條路由:確認通用測試仍在既有節點執行,iOS 工作確實調用所需工具鏈。
- [ ] 記錄模擬器與真機測試的不同驗收範圍;若未執行真機測試,不把模擬器結果標成裝置驗收。
首次接入遠端 Mac 時,驗收證據應包含 Xcode 與 Flutter iOS 工具鏈可用性、代表性 iOS 任務的輸出,以及簽名憑據僅能由必要工作存取的檢查結果。這些證據用來判斷節點是否符合專案要求,不能代替團隊自行確認的安全政策或真機驗收。若需要先核對遠端操作方式,可參考KuzCloud 使用說明;實際環境與連線入口則應以KuzCloud 控制台可查資料為準。本文未提供本站可用 Xcode 版本、主機配置或實測任務結果,因此不據此宣稱特定環境已通過專案驗收。
路由決策與節點選擇
下表按工作依賴判斷執行位置,不是指定 CI 平台的配置範本。遇到混合型工作,應依其最終調用的工具與測試目標拆分,而不要只看工作名稱。
| 工作情境 | 建議執行位置 | 路由依據與驗收證據 |
|---|---|---|
| Dart 格式、靜態分析、一般單元測試 | 現有節點,視依賴而定 | 確認不需 Apple 工具鏈,並保存分析與測試結果 |
| Android 或 Web 工作 | 可支援相應工具鏈的既有節點 | 以專案實際依賴和目標平台驗證,不強制搬到 Mac |
| iOS 目標建置 | macOS | 核對 Xcode 可用性與 iOS 建置結果 |
| iOS Simulator 建置或執行 | macOS | 保存模擬器目標與執行結果,不視為真機測試 |
| Swift、Objective-C 或原生外掛整合 | macOS | 以原生編譯及整合測試結果驗證 |
| 簽名、歸檔與發布 | macOS,並限制權限 | 確認必要憑據存取範圍及可核對的歸檔結果 |
如果 iOS 工作只在部分提交或發布階段出現,先拆分路由,再評估是否需要持續在線的 Mac;不必為了幾項平台專屬工作,把整套 Android、Web 與 Dart 流水線一併遷移。相反地,若 iOS 建置與整合驗證是穩定、長期且持續負載的工作,團隊應比較自購設備、其他可行節點與遠端 Mac 的成本及管理責任;需要長期固定使用或實體裝置介面的情況,不一定適合租用。
相較於現有 Linux 節點,單靠它處理 iOS 工作會缺少必要的 Apple 工具鏈、無法直接執行 iOS Simulator 驗證,也難以承擔 Xcode 簽名與歸檔工作。若你的流水線只有這些特定階段需要 macOS,而又不想為偶發或階段性工作購置實機,可評估租用 KuzCloud 遠端 Mac 作為獨立建置節點;決策前先按上表核對工具鏈、任務結果與憑據邊界,再確認實際環境資訊是否符合專案要求。
為 iOS CI 配置專屬 Mac 建置節點
程式碼檢查可留在現有節點,模擬器驗證、原生整合與簽名發布則交由 KuzCloud 專屬實體 Mac 處理。
獨享 Apple Silicon 算力與完整系統管理權限,可安裝所需工具鏈,按團隊工作流程彈性配置 CI 環境。