跳到主要内容

构建失败排查

使用 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,日志中的错误信息与你在本地执行同一命令得到的完全一致。