Skip to content

解决创建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 前

错误信息表明:

  1. 存在需要接受的 "程序许可协议"(Program License Agreement)更新
  2. 系统无法找到有效的 "iOS Distribution" 分发证书

关键提示

这两个错误通常是相互关联的:未接受的许可协议会导致分发证书状态异常,从而无法正常签名应用

根本原因

PLA Update available

  • 程序许可协议更新:Apple Developer 计划协议发生变更
  • Account Holder 要求必须由开发者账号持有人接受更新协议
  • 账户限制:未接受新协议会导致开发者账户功能受限

No signing certificate found

  • 派生错误:因协议未接受导致的证书失效或识别异常
  • 缓存问题:Xcode 未刷新开发者账户的最新状态

解决方案步骤

第一步:接受新的程序许可协议

  1. 登录 Apple Developer 账户控制台

  2. 在账户概览页查找 协议更新 通知 (通常显示为醒目横幅)

    导航路径

    前往 Membership → Agreements 部分查看待处理协议

  3. 点击 Review Agreement 仔细阅读协议内容

  4. 滚动到页面底部勾选同意框

  5. 点击 SubmitAgree 提交接受

第二步:重置 Xcode 开发者状态

  1. 完全关闭 Xcode
  2. 在终端执行缓存清理命令:
    zsh
    # 清理 Xcode 缓存
    rm -rf ~/Library/Developer/Xcode/DerivedData/*
    # 重置证书相关信息
    xcrun altool --list-providers -u [你的 Apple ID] -p [App 专用密码]
  3. 重新启动 Xcode
  4. 进入 Xcode → Settings → Accounts 重新登录开发者账户
  5. 在账户列表中选中你的账户,点击 Download Manual Profiles

第三步:重新生成 IPA

  1. 清理 Xcode 项目:
    zsh
    xcodebuild clean -workspace YourProject.xcworkspace -scheme YourScheme
  2. 重新执行归档操作:
    zsh
    xcodebuild archive -workspace YourProject.xcworkspace -scheme YourScheme
  3. 打开 Organizer 窗口导出 IPA

验证解决

  • 成功导出 IPA 文件
  • 在 App Store Connect 中正常提交应用
  • 无 "PLA Update available" 错误提示
  • Xcode 签名过程显示有效分发证书

常见错误排查

若完成上述步骤后问题仍在:

  • 确认操作账号是 Account Holder(非普通开发者账号)
  • 检查开发者账户年费是否已续订
  • 确保 Xcode 版本与 macOS 兼容(建议使用最新稳定版)
  • 在证书管理页(Certificates)确认分发证书状态有效

预防措施

  1. 定期检查协议更新:每月登录开发者账户查看协议状态
  2. 启用通知:为 Apple ID 启用开发者账户相关通知
  3. 多账号管理:使用主账号跟踪所有开发者账户状态
  4. Xcode 更新:及时升级以获取最新证书管理功能

遵循上述解决方案,可彻底解决 "Unable to process request - PLA Update available" 错误,确保应用顺利提交到 App Store。