構建流水線
使用標準的 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 | 否 | iphoneos | SDK,例如 iphoneos、macosx。 |
upload_artifact | 否 | false | 是否上傳產物(true / false)。 |
artifact_name | 否 | build-products | 上傳產物的名稱。 |
artifact_path | 否 | build/Release-iphoneos | 要上傳的產物路徑。 |
功能說明
- 在日誌中顯 示 action 輸入資訊。
- 呼叫
scripts/build.sh執行xcodebuild,按指定 scheme、設定、SDK 構建專案(project為空時不傳-project)。 - 呼叫
scripts/export-archive.sh:如果構建目錄中存在.xcarchive,自動執行xcodebuild -exportArchive(使用 development 方式);若匯出失敗,僅輸出 warning,不中斷 workflow。 - 當
upload_artifact為true時,透過actions/upload-artifact@v4上傳產物。
原始碼與更多範本:https://github.com/macrunara/local-mac-runner-action