您的 Apple 账号
登录、双重认证验证码、Apple Developer Program 会员注册（每年 99 美元）以及接受新的协议。只有账户持有人才能接受计划许可协议；注册指南介绍了账号方面的事项。
把真实的日志交给 Claude Code
Xcode 的红色横幅只是一个摘要；真正的原因通常藏在几百行之前。把真实日志交给 Claude Code 有两种方法。在 Xcode 中打开报告导航器（Report navigator，Cmd + 9），选中失败的构建或归档，复制或导出完整记录。或者更简单：让 Claude Code 自己运行构建。在 Mac 的“终端”中进入 iOS 项目文件夹并启动它，它就能调用 xcodebuild、保存输出并在其中搜索。
有两个细节能为您节省好几个小时。始终打开并构建 WebViewGold.xcworkspace，而不是 WebView.xcodeproj；iOS 设置文档特别强调这一点，因为只有 workspace 才包含依赖项。另外，Claude Code 网页版运行在 Linux 上：云端会话可以编辑您仓库中的 Info.plist 或项目设置，但无法运行 Xcode。iOS 构建要在 Mac、租用的 Mac 或 Cloud Builder 中完成。
Claude Code 会运行的命令
您可以自己运行，也可以交给代理运行。第 1 步会告诉您真实的 scheme 名称；请在其他命令中使用这个名称。
bash
mkdir -p build
# 1. List schemes and targets (always use the workspace, not the .xcodeproj)
xcodebuild -list -workspace WebViewGold.xcworkspace
# 2. Archive for the App Store and keep the complete log
# (replace WebViewGold with the app scheme from step 1 if it differs)
xcodebuild -workspace WebViewGold.xcworkspace \
-scheme WebViewGold \
-configuration Release \
-destination 'generic/platform=iOS' \
-archivePath build/App.xcarchive \
archive 2>&1 | tee build/archive.log
# 3. The lines that usually matter
grep -nE "error:|Provisioning|provisioning profile|Signing for|entitlement" build/archive.log | head -40
# 4. What Xcode actually used for each target
xcodebuild -workspace WebViewGold.xcworkspace -scheme WebViewGold -showBuildSettings \
| grep -E "TARGET_NAME|PRODUCT_BUNDLE_IDENTIFIER|DEVELOPMENT_TEAM|CODE_SIGN_STYLE|MARKETING_VERSION|CURRENT_PROJECT_VERSION"您会遇到的错误，以及由谁来修复
| 错误（摘录） | WebViewGold 项目中的常见原因 | 修复方法 | 由谁处理 |
|---|---|---|---|
No such module '…'，或 Pods 中出现数百个错误 | 打开的是 .xcodeproj 而不是 workspace | 退出 Xcode（Cmd + Q），然后打开 WebViewGold.xcworkspace | 您 |
Signing for "WebViewGold" requires a development team | 某个 target 没有选择 Team | 在 Signing & Capabilities 中为 app target 和每个扩展 target 选择您的 Team | 您，在 Xcode 中 |
No profiles for 'com.example.app' were found | Xcode 没有登录您的开发者账号，或者 App ID 尚不存在 | 在 Xcode 设置的 Accounts 中添加您的 Apple 账号，保持自动签名开启，让 Xcode 创建描述文件 | 您 |
Provisioning profile … doesn't include the Push Notifications capability（或 App Groups，或 aps-environment entitlement） | App ID 缺少项目用到的 capability | 按照发布文档的说明，在 Apple Developer 门户中为 App ID 启用 Push Notifications 和 App Groups，然后重启 Xcode | 您 |
Embedded binary's bundle identifier is not prefixed with the parent app's bundle identifier | OneSignalNotificationServiceExtension 等扩展仍在使用模板中的 Bundle ID | 使用您的主 ID 加后缀，例如 com.example.app.OneSignalNotificationServiceExtension | Claude 找出所有不一致之处，您在 Xcode 中确认 |
“Embed Pods Frameworks”阶段出现 Sandbox: rsync(…) deny(1) file-write-create | 较新 Xcode 版本中的用户脚本沙盒阻止了 CocoaPods 构建脚本 | 为 app target 把 User Script Sandboxing（ENABLE_USER_SCRIPT_SANDBOXING）设为 No | Claude |
Command PhaseScriptExecution failed with a nonzero exit code | 某个构建脚本失败了；这一行只是结果 | 在日志中向上查找该脚本的第一个 error: | Claude |
| Archive 显示为灰色，或者没有任何产物 | 选中的运行目标是模拟器 | 选择“Any iOS Device (arm64)”，然后依次选择 Product、Archive | 您 |
| Xcode 设置的 Accounts 中，证书旁显示“Missing private key” | 分发证书是在另一台 Mac 上创建的 | 在那台 Mac 上把它导出为 .p12，或者吊销它，让 Xcode 创建一个新证书 | 您 |
ITMS-90189: Redundant Binary Upload，或“bundle version must be higher” | 该构建号已经用过了 | 每次上传都提高 CURRENT_PROJECT_VERSION（Build），每个新版本都提高 MARKETING_VERSION（Version） | Claude |
| 上传时出现 SDK 版本错误 | 使用了 App Store Connect 已不再接受的 Xcode 进行构建；自 2026 年 4 月起，上传需要 Xcode 26 和 iOS 26 SDK 或更高版本 | 更新 Xcode（必要时一并更新 macOS），并下载最新的 WebViewGold 版本，许可证持有者可免费获取 | 您 |
ITMS-90683: Missing purpose string in Info.plist | 某条用途说明被删除了，但二进制文件仍在引用对应的 API | 恢复该键，并写上诚实、具体的用途说明 | Claude |
Unable to process request - PLA Update available | Apple 发布了新的计划许可协议（Program License Agreement） | 由账户持有人（Account Holder）在开发者账号中接受 | 您（账户持有人） |
只要有一个优化良好的Web应用版本，几分钟内您就能拥有一个出色的移动应用。除此之外，客户服务非常友好且乐于助人！我只能说：推荐WebViewGold :-)
修复循环
先诊断，再修改，密钥始终留在自己手里。
在 iOS 项目文件夹中打开 Claude Code
在“终端”中
cd到包含WebViewGold.xcworkspace的文件夹，然后启动claude。事先至少打开一次 Xcode 本身，让命令行工具和您的账号完成设置。让它复现失败
粘贴下面的诊断提示词。代理会列出 scheme、运行归档，并把完整日志保存到
build/archive.log，这样您和它看的是同一份文本。把文件修复和账号修复分开
提示词会让 Claude 把每项修复归入“我可以修改这个文件”（Info.plist、构建号、某项构建设置、扩展的 Bundle ID）或“您必须在 Xcode 或开发者门户中完成”。批准第一类；第二类则按照它给出的点击路径由您亲自完成。
再次归档
重新运行同样的归档命令。出现新的错误也是进展：签名错误往往是一层一层出现的，先是 Team，然后是描述文件，再然后是某个 capability。
用新的构建号上传
通过 Xcode Organizer 或 Transporter 分发归档。每次上传都需要新的构建号，所以每次归档前都让 Claude 先把它提高。
提交前先测试
通过 TestFlight 在真实的 iPhone 上安装构建版本，检查推送、Face ID 和离线页面，然后再提交给 App Review。
诊断提示词
它告诉代理哪些可以改，哪些必须交还给您。第 5 点中的规则，正是防止一个错误变成三个错误的关键。
在 Mac 上的 iOS 项目文件夹中粘贴到 Claude Code
这个文件夹包含一个 WebViewGold iOS 项目。App Store 归档失败了，我希望在做任何修改之前先得到诊断。 1. 运行 xcodebuild -list -workspace WebViewGold.xcworkspace，并选出 app scheme。 2. 使用 -configuration Release -destination 'generic/platform=iOS' 进行归档，并把完整输出保存到 build/archive.log。 3. 找出第一个真正的错误，而不是后续连带出现的错误。引用相关的日志行，并用通俗易懂的语言解释它们的含义。 4. 把修复归入以下两组之一： (a) 可以直接修改的文件：Info.plist、版本号或构建号、某项构建设置、app target 与其扩展 target 之间的 Bundle ID 不一致； (b) 必须由我自己在 Xcode 设置 > Accounts、Signing & Capabilities 标签页或 Apple Developer 门户中完成的事项。对于 (b)，请给出确切的点击路径。 5. 规则：不要更改 Team、签名方式、证书或描述文件；不要运行 pod update，也不要更改依赖版本；不要重命名 Xcode 项目；绝不访问钥匙串，也不要打印证书。 先把拟议的文件改动给我看，等我确认后再应用。
Claude Code 无法替您完成的事
这些都不是缺失的功能。它们与您的身份和您的密钥绑定在一起，而且理应如此。
证书和私钥
创建或吊销分发证书、从持有私钥的 Mac 导出 .p12、响应钥匙串提示。永远不要把证书密码粘贴到聊天中。
App ID 和 capability
注册 Bundle ID、启用 Push Notifications 和 App Groups、在 App Store Connect 中创建应用记录。Xcode 的自动签名会完成其中一部分，但动手点击的是您。
设备与信任
注册测试设备、在 iPhone 上打开开发者模式、信任这台电脑。代理可以列出步骤，但完成它们的是您的双手和您的手机。
提交决策
在 App Store Connect 中选择构建版本、回答出口合规问题、撰写审核备注并点击提交。Claude 可以起草文字；答案由您负责。
选择标识符
Bundle ID 在应用上线后就无法更改。由您自己决定，而且只决定一次；Bundle ID 指南解释了原因。
常见陷阱
- 让代理去“修复”签名。切换到手动签名、把 Team ID 粘贴进 project.pbxproj，或者删除描述文件设置，通常会把一个错误变成三个。签名相关的改动应该在 Signing & Capabilities 标签页中完成。
- 重命名 Xcode 项目。项目名为 WebViewGold，并且应该保持不变；需要修改的只有 Product Name 和 Bundle Display Name。
- 为了消除警告而更新依赖。在发布过程中执行
pod update或换用新的 SDK 版本，是把一个只需要新构建号的构建搞坏的经典方式。 - 删除追踪用途说明。WebViewGold 文档要求保留 Privacy - Tracking Usage Description 键；删除它会导致应用崩溃。
- 照搬旧论坛帖子里的通用建议。针对 Apple Silicon Mac，设置文档为部分配置介绍了 Rosetta 模拟器运行目标。如果模拟器构建因架构错误而失败，请先阅读那一节，再去修改与架构相关的构建设置。
- 重复使用构建号。每次上传都需要更高的构建号，即使版本号保持不变。
每次归档前的检查清单
- 在 Xcode 26 或更高版本中打开了
WebViewGold.xcworkspace。 - app target 和每个扩展 target 都已选择 Team。
- 扩展的 Bundle ID 都以主 Bundle ID 开头。
- 如果使用推送，App ID 已启用 Push Notifications 和 App Groups。
- 新版本已提高版本号，每次上传都已提高构建号。
- Config.swift 指向生产 URL，而不是开发服务器。
- 用途说明具体且诚实，追踪相关的键依然存在。
常见问题
Claude Code 能构建并归档我的 iOS 应用吗？
在 Mac 上可以：它能在终端中运行 xcodebuild 进行构建和归档，并读取结果。它无法在 Xcode 界面中点击操作、登录您的 Apple 账号或批准钥匙串提示，所以签名需要由您先设置一次。
我能用 Claude Code 网页版修复 Xcode 错误吗？
只能部分修复。云端会话运行在没有 Xcode 的 Linux 上，所以代理可以编辑您仓库中的 Info.plist 或项目文件，却无法通过构建来验证修复。请在 Mac 上或用 Cloud Builder 构建。
我应该把证书或 Apple 账号密码交给代理吗？
不应该。正常的构建修复都不需要它们。如果某个建议的修复需要您的凭据，请自己在 Xcode 或开发者门户中完成那一步。
为什么归档成功了，上传却失败？
App Store Connect 在归档之后还会运行自己的检查：SDK 版本、构建号、Bundle ID 注册、用途说明和 capability。把确切的上传错误粘贴到 Claude Code 中；其中大部分只需改一行。
当 Apple 提高 Xcode 要求时，我需要新的 WebViewGold 版本吗？
这通常是最省事的办法。许可证持有者可免费更新：下载最新的项目，让 Claude Code 把您旧 Config.swift 中的设置复制到新文件中。
让您的应用上架商店的三种方式
结果相同，只是您需要投入的工作量不同。三种方式都附带审核通过保证和 7×24 小时人工支持。
自己动手
$109 每个平台，一次性付费
WebViewGold 许可证：一个现成的 Xcode 或 Android Studio 项目。粘贴您的 URL，设置名称和图标，开启所需功能，构建并提交。永久免费更新。
在主页查看方案Cloud Builder
$349 每个许可证，一次性附加购买
无需 Mac、Xcode 或 Android Studio：在浏览器中完成配置，我们在云端构建两个应用，并将其交付到 App Store Connect 和 Play Console。
Cloud Builder 如何运作 试用免费演示Full Service
$698 每个平台 $798
把您的 URL 和图标发给我们。我们的团队在 72 小时内完成配置、构建并交付您的应用，白标，附源码项目。两个平台共 $1,158。
Full Service 详情 服务提供方：
冬季特惠价格有效期至 2026年12月31日。