跳至主要内容

歸檔匯出 Action

macrunara/local-mac-runner-action 是一個 Composite Action,用於在 Macrunara Mac CI 集群上執行 Xcode 建構,並能從你的封存自動匯出 .ipa。

用法​

- 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要上傳的產物路徑

封存匯出的運作方式​

該 action 依次執行以下步驟:

  1. 在日誌中展示 action 輸入資訊。
  2. 呼叫 xcodebuild,按指定的 scheme、設定與 SDK 建構工程(project 為空時不傳 -project 參數)。
  3. 自動封存匯出:如果建構目錄中存在 .xcarchive,自動執行 xcodebuild -exportArchive(使用 development 方式)產生 .ipa。
  4. 當 upload_artifact 為 true 時,透過 actions/upload-artifact@v4 上傳產物。

如果匯出失敗,action 僅輸出 ::warning::,不會中斷 workflow。建構目錄中沒有 .xcarchive 的任務會直接跳過匯出步驟並正常結束。

注意事項​

  • 匯出使用 development 方式,請確保建構機的簽署上下文支援該方式。
  • 腳本透過 bash 加 ${{ github.action_path }} 顯式呼叫(例如 bash "$ACTION_PATH/scripts/build.sh"),不依賴執行位;如需直接執行腳本,請用 git update-index --chmod=+x scripts/*.sh 保留 +x 權限。
  • 引用本 action 請使用 tag(如 @v1),不要直接使用 @main。