Flutter Android CI | 雲 Mac 真機 Gradle、NDK 快取與按週租用矩陣

短週期衝刺時，Flutter 團隊常把分析與單元測試丟到 Linux 自託管 Agent 換便宜 vCPU；一旦牽涉 Play 簽章、真機 ABI、JNI／NDK 或 ARM64 模擬器，Linux 就容易撞上驅動與映像邊界。把按天雲 Mac當「真機 Gradle 專線」、Linux 當「大量平行檢查」，是 2026 發版窗口較穩折衷——關鍵在快取鍵對齊與失敗十分鐘內可歸因。

2×

建議的 CI 分岔（Mac 真機／Linux 平行）

NDK

快取鍵最常踩的變因

按週

高頻發版時租用節點的計費粒度

流水線怎麼拆：模擬器能省多少、真機不能省什麼

Linux 上跑 flutter test 與靜態分析通常沒問題；整合測試多靠無頭模擬器或雲測。侷限是 ARM／x86 行為差、Play 服務與感測器覆蓋不全、JNI 崩潰難對齊實機。因此 AAB、簽章與 ABI 矩陣我們收口到按天雲 Mac；Linux 專心並行與快取。流水線取捨可對照2026年短週期衝刺：加開第二條 macOS CI 流水線還是把 Job 拆到 Linux 代理？排隊成本與金鑰隔離決策矩陣與 FAQ。

階段	Linux 自託管 Agent	按天雲 Mac（真機／Gradle）
分析／單元測試	成本低、易水平擴展	非必要；除非需 Xcode 同倉構建
`bundleRelease`、Play 簽章	可行但模擬器與驅動維運重	與本機發版環境最接近、易對齊
NDK／CMake 原生模組	快取命中高時極快	ABI 切換與 Xcode 同機除錯較直覺
整合測試（實機感測器）	需外接裝置農場或雲測	USB 真機或區網裝置池更直觀

NDK 與 Gradle：快取鍵請鎖「版本＋ABI＋編譯器」

假命中多半是映像升了 NDK／CMake，快取鍵卻只鎖 Gradle 字串。請把 compileSdk、ndkVersion、abiFilters、AGP／Gradle 版與是否 R8 全模式全寫進鍵或映像標籤；Flutter 再加 engine 提交雜湊，避免引擎升級仍重用舊 .so。

遠端快取鍵片段（概念示例）

# 以環境變數拼鍵，實務上可寫入 CI 的 cache key
AGP=8.7.2 GRADLE=8.11.1 NDK=27.0.12077973
FLUTTER_ENGINE=$(flutter --version | sed -n 's/.*• revision //p')
ABI=arm64-v8a;多 ABI 用「+」串接避免鍵爆炸
# ~/.gradle/caches、android/.gradle、build 目錄分層快取，失效時先刪最外層產物再刪依賴層

模擬器陷阱

Linux KVM 跑 x86_64 模擬器很吃主機 CPU；併行 R8 與原生編譯時尾延遲會讓綠燈在發版日轉紅。重 JNI 與最終 AAB 放在固定規格雲 Mac，通常比盲目加 vCPU 划算。

按週租用決策：什麼時候從「按天」升到「包週」

一週三次以上熱修且常清快取時，按天切換的冷啟動會貴過包週。紅線：單週 Mac 專線 >40 小時，或連兩個衝刺週鎖同一組 NDK／JDK。資源池買租與地域可讀2026年企業遠端 Mac Runner 資源池買還是租：M4 與 M4 Pro、六地域延遲與併發標籤維運決策矩陣。

維運備註

Job 開頭列印 java -version、flutter doctor -v、sdkmanager --list_installed 摘要，發版爭議時比長日誌更快對齊責任。

FAQ：三個「昨晚還過、今早全紅」場景

Q1：命中 Gradle 快取卻仍重編 JNI？

檢查子模組是否覆寫 ndkVersion／CMake，或 abiFilters 與上一個 MR 不同；把子專案 build.gradle 納入鍵，MR 範本勾「是否更動原生層」。

Q2：雲 Mac 要開模擬器跑整合測試嗎？

能免則免，優先實機＋錄影；必開模擬器則鎖映像／GPU，啟動 timeout 與 Gradle 分開計。

Q3：Web／桌面也要佔 Mac？

純 Web 與 Linux 桌面在 Linux Agent 即可；僅當同 MR 需 iOS＋Android 同倉簽章時，再收口同一台雲 Mac 降金鑰面。

一週沖刺 Checklist

週一凍結 wrapper 與 NDK 小版；週三無快取乾跑；週五熱修只走已命中快取的捷徑 Job。