建構失敗排查
使用 local-mac-runner-action 時排查 xcodebuild 建構失敗的步驟。
第 1 步:核對日誌中的 action 輸入
local-mac-runner-action 會在建構前把輸入參數(scheme、project、configuration、sdk)打印到 workflow 日誌中。先從這裡確認參數是否符合預期:
- uses: macrunara/local-mac-runner-action@v1
with:
scheme: MyApp
project: MyApp.xcodeproj
configuration: Release
sdk: iphoneos
輸入寫錯是建構失敗最常見的原因。
第 2 步:確認 scheme 存在
scheme 為必填參數,會直接傳給 xcodebuild -scheme。如果 scheme 在工程 / workspace 中不存在(或未共享),建構會失敗。
檢查:日誌中輸出的 scheme 名稱必須與 Xcode 工程中定義的 scheme 完全一致。
第 3 步:檢查 project / workspace 路徑
project 為可選參數:
- 設定時,
build.sh會以-project <路徑>傳給xcodebuild。 - 為空時,
build.sh不會傳-project,由xcodebuild在工作目錄中自行發現工程。
如果倉庫根目錄存在多個 .xcodeproj / .xcworkspace,留空 project 可能會建構錯誤的目標。此時應明確設定 project。
第 4 步:檢查 configuration 和 sdk
configuration 預設為 Release,sdk 預設為 iphoneos。如果你的工程沒有定義 Release 配置,或需要建構 Mac 目標,請覆寫它們:
with:
scheme: MyApp
configuration: Debug
sdk: macosx
第 5 步:未產生 .xcarchive
匯出步驟(scripts/export-archive.sh)只有在建構目錄中存在 .xcarchive 時才會執行 xcodebuild -exportArchive(development 方式)。如果歸檔從未產生:
- 匯出步驟會被略過,不會產出 IPA。
- 如果匯出本身失 敗,僅輸出
::warning::——workflow 不會失敗。查看日誌中的 warning 行確認發生了甚麼。
仍然失敗?
重新執行 workflow,閱讀步驟日誌中的 xcodebuild 報錯——action 會把你的輸入原樣透傳給 xcodebuild,日誌中的錯誤訊息與你在本機執行同一指令得到的完全一致。