mcpField
M
macos-build

macos-build

github.com/fayazara开发685619 次安装22 周前更新
代码仓库

关于 macos-build

用于通过命令行构建原生 macOS Xcode 项目的操作指南，面向需要编译或验证应用的开发者。它说明如何查找项目与 scheme、运行 xcodebuild，并根据常见错误排查构建问题。

主要功能

  1. 01查找 Xcode 项目与工作区
  2. 02列出可用 scheme
  3. 03使用 xcodebuild 构建
  4. 04筛选和解读构建结果
  5. 05排查常见构建错误

适用场景

  1. 01修改代码后验证项目能否编译
  2. 02按指定 scheme 构建 macOS 应用
  3. 03诊断依赖、签名或 SDK 错误
  4. 04为 beta SDK 选择 Xcode 工具链

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/fayazara/macos-app-skills --skill macos-build

安装后在 Claude Code 中输入/macos-build确认已加载。

详细介绍

构建 macOS 应用

使用 xcodebuild 从命令行构建任何原生 macOS Xcode 项目。

查找项目

构建前，先找到 Xcode 项目或工作区：

find . -maxdepth 2 -name "*.xcodeproj" -o -name "*.xcworkspace" | head -5

然后列出可用方案：

xcodebuild -list -project "YourApp.xcodeproj" 2>/dev/null | grep -A 20 "Schemes:"

构建命令

使用以下命令模板，替换项目路径和方案：

DEVELOPER_DIR=/Applications/Xcode.app/Contents/Developer xcodebuild build \
  -project "YourApp.xcodeproj" \
  -scheme "YourApp" \
  -configuration Debug \
  -destination "platform=macOS" \
  2>&1 | grep -E "(BUILD SUCCEEDED|BUILD FAILED|error:)" | head -20

对于工作区（包含 SPM 依赖项或 CocoaPods 的项目）：

DEVELOPER_DIR=/Applications/Xcode.app/Contents/Developer xcodebuild build \
  -workspace "YourApp.xcworkspace" \
  -scheme "YourApp" \
  -configuration Debug \
  -destination "platform=macOS" \
  2>&1 | grep -E "(BUILD SUCCEEDED|BUILD FAILED|error:)" | head -20

解读结果

  • BUILD SUCCEEDED ——构建通过，向用户报告成功。
  • BUILD FAILED 且包含 error: 行——逐一阅读错误，找出源文件和行号，并帮助用户修复。修复后，重新运行构建以验证。
  • 如果输出为空或不清晰，请在不使用 grep 过滤器的情况下重新运行，以获取完整输出进行诊断。

何时构建

  • 修改代码后，如果用户要求验证代码能否编译
  • 用户明确要求“构建”“编译”或“检查能否构建”时
  • 修复构建错误后，确认修复有效

Xcode Beta 工具链

如果项目面向 Beta SDK（例如 macOS 26 Tahoe），可能需要指定 Beta 版 Xcode：

DEVELOPER_DIR=/Applications/Xcode-beta.app/Contents/Developer xcodebuild build ...

检查可用的 Xcode：

ls /Applications/ | grep -i xcode

常见构建失败

错误修复方法
no such module 'Sparkle'SPM 依赖项尚未解析。先尝试运行 xcodebuild -resolvePackageDependencies
no signing identity found对于命令行构建，设置 CODE_SIGN_IDENTITY="" 和 CODE_SIGNING_ALLOWED=NO
SDK "macosx" cannot be locatedDEVELOPER_DIR 错误。检查 Xcode 安装路径
scheme not found运行 xcodebuild -list 查看可用方案

评论

支持 Markdown