跳至主要内容

產物匯出與發佈

匯出歸檔、上傳構建產物,以及管理 Action 版本標籤。

歸檔匯出​

macrunara/local-mac-runner-action 會自動偵測歸檔並匯出 IPA。構建步驟完成後,scripts/export-archive.sh 會檢查構建目錄:

  • 如果存在 .xcarchive,自動執行 xcodebuild -exportArchive,使用 development 方式匯出 IPA。
  • 如果匯出失敗,僅在日誌中輸出 ::warning::,不會中斷 workflow。

這使得匯出成為一個安全、盡力而為的步驟:匯出失敗絕不會阻塞流水線的其餘部分。

上傳產物​

設定 upload_artifact: true,即可透過 actions/upload-artifact@v4 上傳構建產物:

- 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
參數預設值說明
upload_artifactfalse是否上傳產物(true / false)。
artifact_namebuild-products上傳產物的名稱。
artifact_pathbuild/Release-iphoneos要上傳的產物路徑。

上傳後的產物可在 GitHub 的 workflow 執行頁面下載。

版本標籤​

引用 Action 時務必使用標籤,切勿直接使用 @main:

- uses: macrunara/local-mac-runner-action@v1

商業版本以標籤形式發佈。建立並推送 v1 標籤的指令如下(由發佈負責人手動執行):

git tag -a v1 -m "local-mac-runner-action v1"
git push origin v1

之後如需更新,可建立 v1.x 修補版本並移動 v1 標籤,或按語義化版本發佈新 major 標籤。