返回顶部
X

XcodeXcode避坑指南

Avoid common Xcode mistakes — signing issues, build settings traps, and cache corruption fixes.

作者: admin | 来源: ClawHub
源自
ClawHub
版本
V 1.0.0
安全检测
已通过
1,335
下载量
免费
免费
4
收藏
概述
安装方式
版本历史

Xcode

签名问题

  • - 自动签名仍需选择团队 — 在签名与功能中设置
  • 配置文件不匹配 — Bundle ID 必须完全一致,包括大小写
  • 无签名证书 — 打开钥匙串,检查证书是否有效且未过期
  • 设备未注册 — 在开发者门户添加 UDID,重新生成配置文件
  • CI/CD 需要手动签名 — 无头构建中自动签名无效

派生数据损坏

  • - Xcode 更新后随机构建失败 — 删除 ~/Library/Developer/Xcode/DerivedData
  • 找不到模块但实际存在 — 清理派生数据,重启 Xcode
  • 缓存过时症状 — 构建成功、失败、再成功交替出现
  • xcodebuild clean 不够 — 有时必须手动删除 DerivedData

构建设置层级

  • - 项目 → 目标 → xcconfig → 命令行 — 后者覆盖前者
  • 使用 $(inherited) 追加而非替换 — 忘记使用会移除父级设置
  • Swift 标志用 SWIFTACTIVECOMPILATIONCONDITIONS — 而非 OTHERSWIFTFLAGS
  • Obj-C 用 GCCPREPROCESSOR_DEFINITIONS — 在现有基础上追加,不要替换

归档与构建

  • - 归档默认使用 Release 配置 — 构建使用 Debug
  • 模拟器正常,归档失败 — 检查 Release 构建设置
  • 归档需要有效签名 — 模拟器构建不需要
  • 框架需设置 SKIP_INSTALL = YES — 否则归档会错误包含它们

功能与授权

  • - Xcode 中的功能必须与授权文件匹配 — 不同步会导致崩溃
  • 推送通知需要两者兼备 — App ID 功能 AND 配置文件
  • 关联域名需要 apple-app-site-association 文件 — 托管在你的服务器上
  • 钥匙串共享需要显式指定群组 — 默认仅限你的应用

依赖管理

  • - SPM 和 CocoaPods 可能冲突 — 注意重复符号
  • Pod update 与 install 的区别 — install 使用 Podfile.lock,update 忽略它
  • 找不到框架 — 检查框架搜索路径,区分嵌入与链接
  • SPM 包解析失败 — 删除 Package.resolved,重置包缓存

常见修复

  • - 构建失败但无明显错误 — 查看报告导航器获取详情
  • 模拟器卡死 — xcrun simctl shutdown all,然后 xcrun simctl erase all
  • 索引卡住 — 删除 DerivedData 中的 Index 文件夹
  • 自动补全失效 — 重启 Xcode,若仍无效则删除 DerivedData

命令行构建

  • - 使用 xcodebuild -showBuildSettings 调试 — 查看解析后的值
  • CI 自动签名使用 -allowProvisioningUpdates — 需要钥匙串访问权限
  • -destination 必须精确 — 例如 platform=iOS Simulator,name=iPhone 15
  • xcrun altool 已弃用 — 公证请使用 xcrun notarytool

标签

skill ai

通过对话安装

该技能支持在以下平台通过对话安装:

OpenClaw WorkBuddy QClaw Kimi Claude

方式一:安装 SkillHub 和技能

帮我安装 SkillHub 和 xcode-1776328828 技能

方式二:设置 SkillHub 为优先技能安装源

设置 SkillHub 为我的优先技能安装源,然后帮我安装 xcode-1776328828 技能

通过命令行安装

skillhub install xcode-1776328828

下载

⬇ 下载 Xcode v1.0.0(免费)

文件大小: 2.01 KB | 发布时间: 2026-4-17 13:47

v1.0.0 最新 2026-4-17 13:47
Initial release

Archiver·手机版·闲社网·闲社论坛·智能体自动化市场· 多链控股集团有限公司 · 苏ICP备2025199260号-1

Powered by Discuz! X5.0   © 2024-2026 闲社网·AI智能体论坛·AI自动化解决方案·http://xianshe.com

p2p_official_large
返回顶部