AppScreenshots 文档获取 App Store Connect API 密钥
配置 Store Sync 所需的 Team Key、Issuer ID、Key ID 和 .p8 私钥。
插件的 Apple 表单使用 Team Key（团队密钥），不能按个人密钥教程配置。开始前确认当前开发者团队正确。
获取密钥
- 打开用户和访问 → 集成。
- 尚未启用 API 时，让 Account Holder 申请访问。
- Account Holder 或 Admin 进入 App Store Connect API → Team Keys，生成密钥。
- 填写名称，按实际需要编辑的资料选择最低适用角色，对照 Apple 角色权限核实，不为绕过错误直接选择管理员。
- 记录 Issuer ID、Key ID，下载并妥善保管私钥文件。
Team Key 可作用于团队内的应用。在插件里选择一个 App 并不会缩小密钥本身的权限。需要改变访问权限时，应撤销旧密钥并重新创建。Apple 官方说明。
填入插件
| 插件字段 | 获取位置 |
|---|---|
| Issuer ID | API 页面中的团队签发者标识 |
| Key ID | 选中 Team Key 的标识 |
| 私钥 | 下载的 .p8 文件 |
打开插件设置并选择 Apple，填写 Issuer ID，导入 .p8 文件。标准 AuthKey 文件名可自动填入 Key ID，核对后点击“验证并保存”。
不要填入签名证书、描述文件或 Apple 账号密码。
验证目标应用
凭证保存后，获取发布配置并预检 Apple ID、Bundle ID、版本号。目标版本必须允许修改相应字段。保存草稿不等于提交审核。
| 问题 | 处理方式 |
|---|---|
| 没有集成或创建密钥入口 | 请 Account Holder 核对团队和角色 |
| 认证失败 | 核对 Issuer ID 与 Key ID 是否同属该密钥，检查私钥、撤销状态及设备时间 |
| 找不到应用 | 核对团队、Apple ID 和 Bundle ID |
| 文案或截图写入失败 | 检查字段权限、版本可编辑状态，重试前核对已完成的修改 |
轮换与撤销
正常轮换时先验证新密钥，确认其他使用旧密钥的工具也已切换，再到 App Store Connect 撤销旧密钥。泄露时及时撤销。在插件中删除只清除本机副本。
2026-09-17 核对插件字段及 Apple API 官方说明；后台名称与角色要求可能更新。返回使用指南。