Zilmac 博客
← 返回技术实践

Claude Code 生成的 iOS 项目无法 Archive 怎么办?Xcode 归档按钮灰色、证书签名与 IPA 导出完整排查教程

iOS 打包 ·约 8 分钟阅读

桌上的 MacBook 正对使用者,用来检查 Xcode 运行目标,Archive 还不能点

你已经试过重启 Xcode、Clean Build Folder,菜单里的 Archive 还是灰的。Claude Code 把 Swift 文件和工程改完了,⌘B 也能编过。按钮是灰的,是因为当前运行目标还是一台模拟器,或者这个 scheme 根本没有 Archive 动作。签名错误要等按钮亮了才会出现。

2 处
先看目标,再看 scheme
1 个
共享 scheme 才进 Git
0 次
按钮灰着时先别重装证书

把运行目标改成任意 iOS 设备

工具栏目的地下拉现在多半停在某台 iPhone 模拟器。Archive 只对通用设备目标开放。Apple 在分发文档里把 Archive 当作生成上架用构建的步骤,这一步的目标不是模拟器。

  1. 点 Xcode 窗口顶部的运行目标。
  2. 选 Any iOS Device (arm64)。没有真机也可以,不要选模拟器。
  3. 再打开 Product 菜单。Archive 从灰色变成可点,这一步就过了。
一句判断

按钮是灰的,问题在目标和 scheme。证书要等 Archive 真的跑起来才参与。

确认 scheme 勾了 Archive,并且已共享

开发者在笔记本前核对工程,确认 scheme 是否包含可 Archive 的 App 目标
Claude Code 新建的 scheme 若只留在本机用户目录,另一台 Mac 打开工程时 Archive 仍然是灰的。

Product → Scheme → Manage Schemes。当前 scheme 要同时满足两件事:Edit 里的 Archive 一栏是勾上的,左侧列表里 Shared 也是勾上的。

Claude Code 在一台 Mac 上生成的 scheme,默认可能写进 xcuserdata。这个目录通常不进 Git。你把工程拷到用来出包的 Mac,scheme 列表里没有原来的 App,Product 菜单就没有可归档的动作。勾上 Shared 之后,文件会出现在 xcshareddata/xcschemes,把这个文件提交,再在出包的 Mac 上拉取。

若列表里只有测试目标或 Swift Package,而没有 iOS App 目标,Archive 也会保持灰色。先让 scheme 的 Archive 指向 .app 那个目标。

用命令行核对同一件事

按钮变亮之后,可以用和菜单相同的目标打一次包。目标写成通用 iOS 设备,不要写成某台模拟器的名字。

与 Product → Archive 等价
xcodebuild -scheme YourApp -showdestinations
xcodebuild archive \
  -scheme YourApp \
  -configuration Release \
  -destination 'generic/platform=iOS' \
  -archivePath build/YourApp.xcarchive

-showdestinations 里如果看不到这个 scheme,就是上一步的共享没提交。命令报 “scheme not found”,和菜单是灰的是同一件事。

改完仍然是灰的,先看哪个现象

你看到的先改什么
目标栏写着 iPhone 16 模拟器改成 Any iOS Device (arm64)
Manage Schemes 里没有 App 的名字在工程还完整的那台 Mac 上勾 Shared 并提交
scheme 的 Archive 一栏是空的把 Archive 指到 App 目标,不要指到测试目标
按钮已经可点,导出时报签名错误停止改目标。去看出包那台 Mac 的钥匙串

只打一个包时,把目标和 scheme 对齐就够。每周都要出包,再把共享 scheme 放进仓库,避免每次换机器重做一遍。

最短路径

  1. 运行目标改为 Any iOS Device (arm64)。
  2. Manage Schemes:Archive 指向 App,并勾选 Shared。
  3. 提交 xcshareddata/xcschemes,在出包的 Mac 上拉取。
  4. Product → Archive。按钮可点之后再处理签名。

下一步

编译和签名要在同一台装了 Xcode 的 Mac 上完成。按钮亮了仍导不出包,按这篇把交接走完:

Claude Code Windows 写 iOS:编译和签名分别要在哪台 Mac 完成

依据

常见问题

模拟器选中时,Archive 为什么是灰的?

Archive 只对通用 iOS 设备目标可用。运行目标停在某台模拟器或 My Mac 时,Product 菜单里的 Archive 保持灰色。改成 Any iOS Device (arm64) 后再看。

签名没配对,会把 Archive 按钮变灰吗?

通常不会。证书和描述文件的错误出现在按钮已经可点、Archive 开始之后。按钮本身是灰的,先查目标和 scheme,不要先重装证书。

Claude Code 新建的 scheme 为什么另一台 Mac 上看不到?

只放在 xcuserdata 里的 scheme 不会进 Git。要在 Manage Schemes 里勾选 Shared,让它写到 xcshareddata/xcschemes,再提交。

按钮亮了但导出失败,下一步看哪篇?

看编译和签名分别在哪台 Mac 上完成。Archive 必须在装了 Xcode、钥匙串里有私钥的那台机器上跑。

编译和签名

按钮亮了,还要在同一台 Mac 上签名

Archive 可点之后,出包仍要落在装了 Xcode 的那台机器。

看编译和签名交到哪台 Mac
下一篇 编译和签名