配置 iOS 应用

发布 iOS 应用前，需要先在编辑器中填写 iOS 应用配置。系统使用这些信息为应用签名、打包，并上传到 App Store Connect。配置不完整时，发布面板会提示先完成配置。

打开应用配置

在移动应用客户端编辑器中，打开设置，选择应用配置。

填写配置前，确认以下内容已经完成：

⚠️

系统会按 Bundle ID 在 App Store Connect 中查找 App。如果 App 记录不存在，或 Bundle ID 与 App 记录不一致，发布会失败。

配置项	说明	获取位置
App display name	应用安装后显示在主屏幕图标下方的名称	自行填写
Bundle ID	应用的唯一标识，例如 `com.example.myapp`	Apple Developer → Identifiers
Team ID	Apple 开发者团队的 10 位标识	Apple Developer → 会员资格详细信息
Issuer ID	App Store Connect API 密钥的签发者 ID，格式为 UUID	App Store Connect → 集成 → App Store Connect API
ASC key	App Store Connect API 密钥的密钥 ID	App Store Connect → 集成 → App Store Connect API
App icon	应用图标，尺寸必须为 1024×1024	自行准备
Auth key	生成 API 密钥时下载的 `.p8` 私钥文件	生成 API 密钥时下载

所有配置项都填写完成后，保存按钮才可以点击。

填写用户在手机主屏幕上看到的应用名称。App Store 中展示的应用名称在 App Store Connect 的 App 信息中单独设置，两者可以不同。

登录 Apple Developer ，进入 Certificates, Identifiers & Profiles → Identifiers，点击 + 注册一个 App ID，选择 Explicit 类型并填写 Bundle ID。

将 Bundle ID 原样填写到 Bundle ID，区分大小写。

⚠️

应用发布后，不要再修改 Bundle ID。修改后系统会将其视为另一个 App，需要重新创建 App 记录。

Team ID 必须与注册 Bundle ID 的开发者团队一致。系统使用 Team ID 为应用自动管理签名证书和描述文件，无需手动上传证书。

这三项来自同一个 App Store Connect API 密钥，需要一起获取。

在团队密钥页面顶部复制 Issuer ID，填写到应用配置的 Issuer ID。Issuer ID 格式类似 57246542-96fe-1a63-e053-0824d011072a，格式不正确时无法保存。

在密钥列表中找到刚生成的密钥，复制密钥 ID，填写到 ASC key。

点击下载 API 密钥，得到 AuthKey_<密钥 ID>.p8 文件，在应用配置的 Auth key 中上传该文件。

⚠️

.p8 私钥文件只能下载一次，请妥善保存。丢失后需要撤销原密钥并重新生成，同时更新 ASC key 和 Auth key。

ASC key 与 Auth key 必须属于同一个密钥。上传的私钥会加密存储，仅在打包发布时使用。

上传 1024×1024 像素的 PNG 图片，尺寸不符时无法上传。系统会根据该图片生成各尺寸的应用图标。

建议使用不含透明区域的方形图片，无需自行添加圆角，iOS 会自动裁切。

保存配置后，即可在发布面板中发布 iOS 应用。预发布版本会上传到 TestFlight 供测试；正式发布到 App Store 时，填写的版本号必须高于 App Store 中已有的最新版本。发布流程参阅发布应用。

保存按钮无法点击

检查所有配置项是否已填写，App icon 和 Auth key 是否已上传，Issuer ID 格式是否正确。

发布时提示找不到 App

确认已在 App Store Connect 中创建 App 记录，且记录使用的 Bundle ID 与应用配置中的 Bundle ID 完全一致。

发布时提示密钥无效

确认 ASC key、Issuer ID 和 Auth key 来自同一个密钥，且该密钥未被撤销。