解决创建IPA时“PLA Update available”错误
问题描述
当使用 Xcode 尝试生成 iOS 应用的 IPA 文件以提交到 App Store 审核时,常常会遇到以下关键错误:
error: exportArchive: Unable to process request - PLA Update available
error: exportArchive: No signing certificate "iOS Distribution" found
该问题通常发生在以下情况:
- 使用 Xcode 进行存档(Archive)操作时
- 导出 IPA 文件的过程中
- 提交应用到 App Store Connect 前
错误信息表明:
- 存在需要接受的 "程序许可协议"(Program License Agreement)更新
- 系统无法找到有效的 "iOS Distribution" 分发证书
关键提示
这两个错误通常是相互关联的:未接受的许可协议会导致分发证书状态异常,从而无法正常签名应用
根本原因
PLA Update available
- 程序许可协议更新:Apple Developer 计划协议发生变更
- Account Holder 要求:必须由开发者账号持有人接受更新协议
- 账户限制:未接受新协议会导致开发者账户功能受限
No signing certificate found
- 派生错误:因协议未接受导致的证书失效或识别异常
- 缓存问题:Xcode 未刷新开发者账户的最新状态
解决方案步骤
第一步:接受新的程序许可协议
在账户概览页查找 协议更新 通知 (通常显示为醒目横幅)
导航路径
前往 Membership → Agreements 部分查看待处理协议
点击 Review Agreement 仔细阅读协议内容
滚动到页面底部勾选同意框
点击 Submit 或 Agree 提交接受
第二步:重置 Xcode 开发者状态
- 完全关闭 Xcode
- 在终端执行缓存清理命令:zsh
# 清理 Xcode 缓存 rm -rf ~/Library/Developer/Xcode/DerivedData/* # 重置证书相关信息 xcrun altool --list-providers -u [你的 Apple ID] -p [App 专用密码]
- 重新启动 Xcode
- 进入 Xcode → Settings → Accounts 重新登录开发者账户
- 在账户列表中选中你的账户,点击 Download Manual Profiles
第三步:重新生成 IPA
- 清理 Xcode 项目:zsh
xcodebuild clean -workspace YourProject.xcworkspace -scheme YourScheme
- 重新执行归档操作:zsh
xcodebuild archive -workspace YourProject.xcworkspace -scheme YourScheme
- 打开 Organizer 窗口导出 IPA
验证解决
- 成功导出 IPA 文件
- 在 App Store Connect 中正常提交应用
- 无 "PLA Update available" 错误提示
- Xcode 签名过程显示有效分发证书
常见错误排查
若完成上述步骤后问题仍在:
- 确认操作账号是 Account Holder(非普通开发者账号)
- 检查开发者账户年费是否已续订
- 确保 Xcode 版本与 macOS 兼容(建议使用最新稳定版)
- 在证书管理页(Certificates)确认分发证书状态有效
预防措施
- 定期检查协议更新:每月登录开发者账户查看协议状态
- 启用通知:为 Apple ID 启用开发者账户相关通知
- 多账号管理:使用主账号跟踪所有开发者账户状态
- Xcode 更新:及时升级以获取最新证书管理功能
遵循上述解决方案,可彻底解决 "Unable to process request - PLA Update available" 错误,确保应用顺利提交到 App Store。