雲端 Mac 工作流程：iOS 建置、CI 與 AI 推論

iOS 自動化打包

從 Git 提交到可封存的產物，每個步驟都留下可追蹤結果。

穩定的自動化打包不只是一個指令。你需要同時固定原始碼版本、依賴狀態、Xcode 選擇、簽署輸入、匯出參數與產物去向，任何一步失敗都應能從記錄中定位。

01 · 觸發
鎖定提交與任務輸入

輸入：儲存庫網址、分支、提交雜湊、建置設定與目標 Scheme。Webhook 或佇列任務只傳遞識別資訊，不在指令碼中臨時猜測分支。

失敗點：提交不存在、子模組尚未同步、權限不足，或同一任務讀取了正在變更的分支頂端。
02 · 依賴
還原快取並安裝依賴

輸入：Package.resolved、Podfile.lock 或其他鎖定檔。快取鍵至少應包含依賴鎖定摘要、Xcode 版本與目標架構。

失敗點：鎖定檔漂移、快取與工具鏈不相容、私有依賴憑證失效，或磁碟空間不足。
03 · 封存
執行 xcodebuild archive

輸入：Workspace 或 Project 路徑、Scheme、Configuration、Destination 與封存路徑。先輸出工具版本，再執行封存。

失敗點：編譯錯誤、測試失敗、目標版本不相容、衍生資料污染，或建置指令碼依賴本機絕對路徑。
04 · 簽署
依任務注入簽署材料

輸入：最小必要範圍的憑證、描述檔與必要環境變數。材料應在任務開始時注入，並於任務結束後移除。

失敗點：憑證與描述檔不相符、權限範圍錯誤、有效期限問題，或多個任務誤用同一個暫存鑰匙圈。
05 · 匯出
匯出並驗證檔案

輸入：封存檔與 ExportOptions 設定。匯出後記錄檔名、大小、驗證摘要與建立時間，而不是只判斷目錄是否存在。

失敗點：匯出方法與簽署設定衝突、輸出目錄沒有權限，或指令碼吞掉非零結束碼。
06 · 封存
彙整記錄與產物

輸出：建置產物、封存檔、測試報告、建置記錄、提交雜湊與任務編號。上傳成功後再清理工作目錄。

失敗點：上傳中斷、產物命名衝突、記錄含有敏感欄位，或清理動作早於結果確認。

建置農場編排

多個儲存庫共用佇列，但不共用未受控的工作目錄與簽署材料。

建置農場的核心不只是讓任務同時執行，而是讓佇列、節點標籤、快取邊界與結果回傳都可解釋。單台 MiniDebug M4 適合承載一條受控執行通道；更多並行任務應分配到不同訂單對應的實體節點。

建置農場佇列範例

儲存庫、任務與節點的分配順序

1 個任務 = 1 個工作目錄

mobile-app release / archive 分配 M4 節點

shared-sdk main / test 等待封存任務結束

demo-client feature / build 依優先順序排隊

入列：儲存庫、提交、優先順序、預估逾時與所需標籤。
配對：依 Xcode 版本、節點狀態、任務類型與使用情況選擇執行節點。
執行：建立獨立工作目錄，還原符合快取鍵的依賴，再注入本次任務所需材料。
收尾：回傳狀態、記錄、產物與耗時，確認上傳後刪除暫存目錄與暫存憑證。

快取邊界

重用下載結果，不重用未知狀態。

依賴快取可依鎖定檔摘要、Xcode 版本與架構重用。DerivedData、暫存鑰匙圈、匯出目錄與未提交變更不應跨儲存庫直接重用。

結果彙總

將佇列狀態與建置結果分開。

排隊、執行、上傳與完成是調度狀態；編譯通過、測試失敗、簽署失敗是任務結果。分開記錄後，才能判斷是容量問題還是專案問題。

GitHub Actions 自託管 Runner

先設計標籤與清理策略，再讓工作流程落到 Mac 節點。

Runner 註冊只是接入動作。真正決定穩定性的，是標籤是否精確、單機並行是否受控、任務結束後是否清理，以及失敗記錄能否回到對應的工作流程執行記錄。

標籤規劃

標籤只描述穩定能力。

建議保留系統標籤，並增加可長期維護的能力標籤，例如 macos、arm64、xcode-current 和 signing-ready。不要把暫時的專案名稱或短期分支寫入節點標籤。

runs-on:
  - self-hosted
  - macos
  - arm64
  - xcode-current

註冊與權限

使用專用執行帳戶承載任務。

註冊前確認 Runner 所屬範圍、儲存庫存取邊界與工作目錄。執行帳戶只取得執行建置所需的權限，不與日常遠端操作混用，也不將長期憑證直接寫入指令碼檔案。

記錄 Runner 名稱、節點與用途
限制可呼叫它的儲存庫或組織範圍
檢查工作目錄與快取目錄權限
註冊完成後執行最小建置驗證

清理與並行

單通道執行，任務之間明確清理。

同一工作目錄不要同時執行兩個寫入型任務。任務開始前檢查殘留程序與磁碟空間，任務結束後清理原始碼副本、暫存匯出檔、暫存鑰匙圈與專案層級環境變數。

需要並行時，將不同任務分配到不同實體節點，而不是讓簽署、封存與清理步驟在同一目錄互相覆蓋。

失敗回傳

即使建置失敗，也要上傳診斷材料。

記錄收集步驟應在失敗條件下繼續執行，至少回傳 xcodebuild 輸出、測試結果、磁碟剩餘空間、工具版本與任務識別資訊。上傳前移除權杖、私鑰內容、憑證密碼與儲存庫敏感變數。

區分 Runner 離線、任務逾時、指令碼結束與產物上傳失敗，避免所有問題都只顯示為「建置失敗」。

獨立開發者發佈流程

圖形介面處理少量人工確認，命令列負責可重複的建置與封存。

獨立開發者通常不需要一次將所有步驟自動化。更穩妥的做法是明確劃分圖形操作與命令列任務的交接點，讓修復、驗證、封存與 TestFlight 前的產物準備都能回溯。

本機開發環境

修復與提交

完成程式碼修改、基本測試與提交，推送固定分支，並記錄需要驗證的裝置條件與預期結果。

輸出：提交雜湊、變更說明、測試範圍

遠端圖形介面

Xcode 人工確認

檢查 Scheme、目標版本與專案設定，處理需要視覺判斷的警告，並確認簽署設定指向本次發佈所需範圍。

輸出：確認後的專案狀態與發佈參數

命令列任務

封存與匯出

執行指令碼化封存、匯出與驗證，保留完整記錄。出現問題時回到對應輸入，不要在失敗機器上反覆手動修改未知狀態。

輸出：封存檔、匯出套件、驗證摘要

建議的交接規則

圖形介面只負責必須人工判斷的設定與檢查；封存、匯出、重試與產物命名交給指令碼。每次人工調整後提交專案變更或記錄差異，避免下次建置無法重現。

AI 推論實驗

在 Apple Silicon 上比較模型版本，而不是只記錄一次執行結果。

MiniDebug M4 配備 M4、16GB RAM 與 256GB SSD。實驗設計應先確認模型與資料是否適合此資源範圍，再記錄載入、記憶體、持續推論與輸出品質，避免將不同參數的結果混在一起。

01 · 準備

固定模型與執行環境

記錄模型格式、量化版本、執行階段版本、提交雜湊、輸入樣本與隨機參數。模型檔案使用驗證摘要識別，避免同名檔案的實際內容不同。

必須記錄: 模型版本與量化方式
資源範圍: 16GB RAM / 256GB SSD

02 · 基準測試

分開測量冷啟動與持續推論

首次載入包含模型讀取與初始化，不可與穩定執行階段混合計算。每組測試使用相同的輸入長度、批次大小、重複次數與取樣參數。

時間指標: 載入耗時、首次輸出、總耗時
資源指標: 峰值記憶體與穩定記憶體

03 · 比較

比較速度、記憶體與結果差異

量化版本不應只比較速度。還應儲存相同輸入的輸出、任務品質判斷、錯誤樣本與環境資訊，最後匯出機器可讀結果及人工結論。

比較維度: 延遲、吞吐量、記憶體、輸出品質
實驗輸出: CSV、記錄、設定與結論

benchmark-run.json

{
  "machine": "MiniDebug M4 / M4 / 16GB / 256GB",
  "model_variant": "project-defined",
  "input_set": "fixed-evaluation-set",
  "measurements": [
    "load_time",
    "first_output_time",
    "total_time",
    "peak_memory"
  ],
  "artifacts": ["result.csv", "runtime.log", "notes.md"]
}

影音工作流程

將大檔案同步、遠端編輯與批次匯出拆成獨立階段。

影音任務的瓶頸可能來自素材傳輸、外掛相容性、遠端畫面、磁碟容量或匯出參數。將這些環節分開，可以避免把連線卡頓誤判為主機運算問題。

階段 A

同步專案與素材

先產生素材清單，記錄檔案數量、總大小、目錄結構與驗證摘要。只同步目前階段需要的代理檔或原始素材，完成後驗證缺漏項目。

檢查點：專案路徑不依賴本機磁碟代號，媒體參照可重新定位，256GB 基礎 SSD 預留工程快取與匯出空間。

階段 B

遠端開啟並檢查專案

透過圖形連線開啟專案，檢查字型、外掛、媒體連結、取樣設定與輸出目標。網路品質較差時優先降低遠端畫質與解析度，不要變更專案輸出參數。

檢查點：區分遠端預覽品質與最終檔案品質；缺少外掛時先停止批次任務，避免產生不完整結果。

階段 C

執行批次匯出

固定匯出預設、檔案命名與目標目錄，再依任務清單執行。每個任務儲存結束狀態、持續時間、輸出大小與錯誤資訊。

檢查點：長時間任務開始前確認磁碟剩餘空間；並行數量應依據記憶體、素材讀取與編碼負載逐步驗證。

階段 D

驗收並回傳產物

抽查畫面、音軌、時長、解析度與檔案標頭資訊，再產生驗證摘要。確認本機已完整接收後，清理雲端暫存檔案。

輸出：最終檔案、匯出記錄、失敗清單、驗證摘要與本機接收記錄。

節點選擇建議

在新加坡、日本（東京）、韓國（首爾）、香港與美國東部之間，依資料路徑選擇。

節點不應只看團隊所在地，還要同時考慮程式碼儲存庫、依賴來源、遠端操作者與最終交付目標。以下是選擇方向，不代表固定網路結果；實際連線表現取決於使用者本機網路與跨地區鏈路。

MiniDebug M4 五個可選節點的工作流程選擇建議
節點	優先考慮的團隊所在地	儲存庫與依賴所在地	典型交付方向	下單前驗證
新加坡	東南亞團隊或跨東南亞協作成員	儲存庫、產物或依賴服務主要位於東南亞時優先測試	面向東南亞團隊的日常建置、遠端開發與結果回傳	測試儲存庫擷取、依賴下載與遠端圖形連線
日本（東京）	日本及鄰近東亞團隊	程式碼與依賴存取路徑主要靠近日本時優先測試	日本團隊的 iOS 建置、簽署檢查與遠端 Xcode 操作	驗證本機到節點的互動穩定性與大檔案上傳
韓國（首爾）	韓國及東北亞協作團隊	儲存庫與內部資源從韓國方向存取更直接時考慮	持續整合、自託管 Runner 與區域內產物分發	驗證 Runner 回連、依賴取得與記錄上傳
香港	華南與東南亞之間協作的團隊	程式碼、素材與操作者分布在華南及東南亞時可優先比較	跨地區開發協作、遠端圖形任務與素材處理	分別測試辦公室網路與家用網路的連線路徑
美國東部	北美東部及與西歐協作的團隊	儲存庫、CI 控制平面或交付系統主要位於北美東部時考慮	北美工作時區內的建置佇列、結果回傳與協作檢查	測試儲存庫、產物儲存與遠端操作者三條路徑

工作流程範本

從最小結構開始，再替換專案版本、憑證與路徑。

以下片段用於建立指令碼結構，不是可直接套用於所有專案的完整設定。儲存至儲存庫前，應依工程類型核對 Workspace、Scheme、Xcode 版本、匯出設定、簽署材料、Runner 標籤與產物目錄。

Shell

xcodebuild 封存結構

archive.sh

set -euo pipefail

PROJECT_ROOT="/path/to/project"
WORKSPACE="$PROJECT_ROOT/Example.xcworkspace"
SCHEME="Example"
ARCHIVE_PATH="$PROJECT_ROOT/output/Example.xcarchive"

xcodebuild -version
xcodebuild \
  -workspace "$WORKSPACE" \
  -scheme "$SCHEME" \
  -configuration Release \
  -destination "generic/platform=iOS" \
  -archivePath "$ARCHIVE_PATH" \
  clean archive

修改項目

替換專案路徑、Workspace、Scheme、Configuration、Destination 與封存目錄。指令碼應保留非零結束碼，並在執行前確認所需的 Xcode 版本。

Fastlane

建置與產物記錄結構

Fastfile

lane :build_release do
  setup_ci

  build_app(
    workspace: "Example.xcworkspace",
    scheme: "Example",
    configuration: "Release",
    output_directory: "output"
  )

  sh("shasum -a 256 output/*")
end

修改項目

依專案替換 Workspace、Scheme、輸出目錄與匯出設定。簽署材料應透過受控變數或任務層級注入提供，不要直接寫入 Fastfile。

CI

自託管 Runner 任務結構

build.yml

name: ios-build

on:
  workflow_dispatch:

jobs:
  archive:
    runs-on:
      - self-hosted
      - macos
      - arm64
      - xcode-current
    steps:
      - name: Checkout
        uses: actions/checkout@v4

      - name: Build
        run: ./scripts/archive.sh

      - name: Collect diagnostics
        if: always()
        run: ./scripts/collect-diagnostics.sh

修改項目

依 Runner 實際標籤、儲存庫策略與指令碼路徑調整。固定所使用的動作版本，設定任務逾時，並讓診斷收集在建置失敗時繼續執行。

查看建置排查路徑諮詢工作流程適配

開始驗證現有流程

選擇一台 MiniDebug M4，先跑通最小建置閉環。

從固定提交、單一任務執行、記錄封存與產物驗證開始，再逐步加入快取、簽署注入與佇列調度。支援按日、週、月、季租用，訂單以美元（USD）結算。

付款僅支援 USDT-TRC20 與 Visa / Mastercard / Amex（經 Stripe），實際可用的付款閘道以後台回傳為準。

立即租用雲端 Mac 查看完整價格

從 Git 提交到可封存的產物，每個步驟都留下可追蹤結果。

鎖定提交與任務輸入

還原快取並安裝依賴

執行 xcodebuild archive

依任務注入簽署材料

匯出並驗證檔案

彙整記錄與產物

多個儲存庫共用佇列，但不共用未受控的工作目錄與簽署材料。

儲存庫、任務與節點的分配順序

重用下載結果，不重用未知狀態。

將佇列狀態與建置結果分開。

先設計標籤與清理策略，再讓工作流程落到 Mac 節點。

標籤只描述穩定能力。

使用專用執行帳戶承載任務。

單通道執行，任務之間明確清理。

即使建置失敗，也要上傳診斷材料。

圖形介面處理少量人工確認，命令列負責可重複的建置與封存。

修復與提交

Xcode 人工確認

封存與匯出

在 Apple Silicon 上比較模型版本，而不是只記錄一次執行結果。

固定模型與執行環境

分開測量冷啟動與持續推論

比較速度、記憶體與結果差異

將大檔案同步、遠端編輯與批次匯出拆成獨立階段。

同步專案與素材

遠端開啟並檢查專案

執行批次匯出

驗收並回傳產物

在新加坡、日本（東京）、韓國（首爾）、香港與美國東部之間，依資料路徑選擇。

從最小結構開始，再替換專案版本、憑證與路徑。

xcodebuild 封存結構

建置與產物記錄結構

自託管 Runner 任務結構

選擇一台 MiniDebug M4，先跑通最小建置閉環。