跳至主要内容

快速上手

歡迎使用 Macrunara —— 高性能 macOS CI 平台。本指南將幫助你在 5 分鐘內完成設定並運行起來。

先決條件​

  • 一個 GitHub 帳戶
  • 一個包含 macOS 工作流程(iOS、macOS、watchOS、tvOS)的存放庫

快速開始​

1. 安裝 GitHub App​

瀏覽 GitHub Marketplace,將 Macrunara 應用程式安裝到你的機構或帳戶。

2. 選擇存放庫​

選擇要連接到 Macrunara 的存放庫。之後你可以在應用程式設定中更改。

3. 更新你的工作流程​

開啟你的 .github/workflows/*.yml 檔案,修改 runs-on 標籤,標準寫法:[macos, arm64, macrunara],同時引入 macrunara/setup-action@v1,配置 MACRUNARA_INSTALLATION_ID:

jobs:
build:
runs-on: [macos, arm64, macrunara]
steps:
- uses: actions/checkout@v4

- uses: macrunara/setup-action@v1
with:
installation-id: ${{ secrets.MACRUNARA_INSTALLATION_ID }}
region: auto

- run: xcodebuild -scheme MyApp build

就是這樣!推送你的更改,下一次構建將在 Macrunara 的 M4 Runner Fleet 集群上運行。

注意

請勿使用 self-hosted、macos-latest、macrunara-m4-base,會造成任務排隊異常,詳見 runs-on 標籤約定文件。

後續步驟​