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