跳至主要内容

建構失敗排查

使用 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,日誌中的錯誤訊息與你在本機執行同一指令得到的完全一致。