跳至主要内容

構建流水線

使用標準的 GitHub Actions workflow,在 Macrunara 的 Mac mini M4 CI 叢集上構建你的 Xcode 專案。

完整 Workflow 範例​

一個在 push 和 pull request 時觸發的完整 macOS CI 流水線:

name: macOS CI

on:
push:
branches: [main]
pull_request:
branches: [main]

jobs:
build:
# 標準三標籤寫法:AND 匹配,必須是節點上報標籤的子集
runs-on: [macos, arm64, macrunara]

steps:
- uses: actions/checkout@v4

# 可選步驟:品牌橫幅 + 參數校驗 + 環境資訊匯出
- uses: macrunara/setup-action@v1
with:
installation-id: ${{ secrets.MACRUNARA_INSTALLATION_ID }}
region: auto

- name: Build
run: xcodebuild -scheme MyApp -destination 'platform=macOS'

- name: Test
run: swift test

setup-action 步驟需要設定 MACRUNARA_INSTALLATION_ID secret。region 參數可選 zhuji / fuyang / yuhang / xiasha / auto(自動選擇最佳機房,預設值)。

Runner 標籤在註冊時即固定,job 內無法動態修改。請始終透過 runs-on: [macos, arm64, macrunara] 選擇 Macrunara 節點。寫 self-hosted 或 macos-latest 會導致任務永遠排隊且無錯誤提示。

local-mac-runner-action​

macrunara/local-mac-runner-action 是一個 Composite Action,用於在 Macrunara 本地 Mac CI 叢集上執行 Xcode 構建、歸檔匯出與產物上傳。

- uses: macrunara/local-mac-runner-action@v1
with:
scheme: MyApp
project: MyApp.xcodeproj
configuration: Release
sdk: iphoneos
upload_artifact: true
artifact_name: build-products
artifact_path: build/Release-iphoneos

本動作是一個 GitHub Composite Action,不依賴 Docker 或 Node.js 運行時,所有步驟直接在 workflow 的 Runner 上執行。

輸入參數​

參數必填預設值說明
scheme是—要構建的 Xcode scheme。
project否—Xcode 專案或 workspace 路徑。
configuration否Release構建設定,例如 Release、Debug。
sdk否iphoneosSDK,例如 iphoneos、macosx。
upload_artifact否false是否上傳產物(true / false)。
artifact_name否build-products上傳產物的名稱。
artifact_path否build/Release-iphoneos要上傳的產物路徑。

功能說明​

  1. 在日誌中顯示 action 輸入資訊。
  2. 呼叫 scripts/build.sh 執行 xcodebuild,按指定 scheme、設定、SDK 構建專案(project 為空時不傳 -project)。
  3. 呼叫 scripts/export-archive.sh:如果構建目錄中存在 .xcarchive,自動執行 xcodebuild -exportArchive(使用 development 方式);若匯出失敗,僅輸出 warning,不中斷 workflow。
  4. 當 upload_artifact 為 true 時,透過 actions/upload-artifact@v4 上傳產物。

原始碼與更多範本:https://github.com/macrunara/local-mac-runner-action