发布移动应用
移动应用目前仅支持 iOS,发布后用户从 App Store 下载安装。
填写应用配置
发布前,需要先在编辑器中填写 iOS 应用配置。系统使用这些信息为应用签名、打包,并上传到 App Store Connect;配置不完整时,发布面板会提示先完成配置。填写前,需要先加入 Apple Developer Program 。
在移动应用客户端编辑器中,打开设置,选择应用配置,按下表填写。
| 配置项 | 说明 | 获取位置 |
|---|---|---|
| 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 |
| Auth key | 生成 API 密钥时下载的 .p8 私钥文件 | 生成 API 密钥时下载 |
| App icon | 应用图标,尺寸必须为 1024×1024 | 自行准备 |
所有配置项都填写完成后,保存按钮才可以点击。
App display name
填写用户在手机主屏幕上看到的应用名称。App Store 中展示的应用名称在 App Store Connect 的 App 信息中单独设置,两者可以不同。
Bundle ID
- 注册 Bundle ID:登录 Apple Developer ,进入 Certificates, Identifiers & Profiles → Identifiers,点击 + 注册一个 App ID,选择 Explicit 类型并填写 Bundle ID。
- 创建 App 记录:登录 App Store Connect ,进入 App,点击 + → 新建 App,在 套装 ID 中选择上一步注册的 Bundle ID。
- 填写到应用配置:将 Bundle ID 原样填写到 Bundle ID,区分大小写。
系统按 Bundle ID 在 App Store Connect 中查找 App,App 记录不存在或 Bundle ID 不一致时,发布会失败。应用发布后,不要再修改 Bundle ID,修改后系统会将其视为另一个 App,需要重新创建 App 记录。
Team ID
登录 Apple Developer ,进入账户 → 会员资格详细信息,复制团队 ID。Team ID 由 10 位字母和数字组成。
Team ID 必须与注册 Bundle ID 的开发者团队一致。系统使用 Team ID 为应用自动管理签名证书和描述文件,无需手动上传证书。
Issuer ID、ASC key 和 Auth key
这三项来自同一个 App Store Connect API 密钥,需要一起获取。
- 生成 API 密钥:登录 App Store Connect ,进入用户和访问 → 集成 → App Store Connect API → 团队密钥,点击 + 生成密钥。填写密钥名称,访问权限选择管理。
- 复制 Issuer ID:在团队密钥页面顶部复制 Issuer ID,填写到应用配置的 Issuer ID。Issuer ID 格式类似
57246542-96fe-1a63-e053-0824d011072a,格式不正确时无法保存。 - 复制密钥 ID:在密钥列表中找到刚生成的密钥,复制密钥 ID,填写到 ASC key。
- 下载并上传私钥:点击下载 API 密钥,得到
AuthKey_<密钥 ID>.p8文件,在应用配置的 Auth key 中上传该文件。
.p8
私钥文件只能下载一次,请妥善保存。丢失后需要撤销原密钥并重新生成,同时更新 ASC
key 和 Auth key。
ASC key 与 Auth key 必须属于同一个密钥。上传的私钥会加密存储,仅在打包发布时使用。
App icon
上传 1024×1024 像素的 PNG 图片,尺寸不符时无法上传。系统会根据该图片生成各尺寸的应用图标。
建议使用不含透明区域的方形图片,无需自行添加圆角,iOS 会自动裁切。
生成预览
在发布面板中点击预览。系统会打包 iOS 应用并上传到 App Store Connect,通常需要 30 分钟左右。生成成功后:
- 打开 App Store Connect,确认应用的构建版本已经处理完成。
- 在 TestFlight 中添加测试人员。
- 测试人员在手机上打开 TestFlight,安装或更新应用。
修改应用后,点击重新预览生成新的构建版本。
提交 App Store 审核
- 填写版本号并上传:在发布面板中点击发布,填写版本号并确认,系统会重新打包并上传到 App Store Connect。版本号至少两段,例如
1.0或1.0.0,并且必须大于 App Store 上的最新版本。如果最新版本尚未发布,可以沿用该版本号覆盖提交。版本号不能回退。 - 在 App Store Connect 中提交审核:等待构建版本处理完成后,选择该构建版本,填写本次更新内容,确认应用信息与截图后提交审核。
首次提交时,还需要在 App Store Connect 中填写应用信息、截图和隐私问卷,审核才会受理。
常见问题
- 保存按钮无法点击:检查所有配置项是否已填写,App icon 和 Auth key 是否已上传,Issuer ID 格式是否正确。
- 发布时提示找不到 App:确认已在 App Store Connect 中创建 App 记录,且记录使用的 Bundle ID 与应用配置中的完全一致。
- 发布时提示密钥无效:确认 ASC key、Issuer ID 和 Auth key 来自同一个密钥,且该密钥未被撤销。
- 提示不能提交新版本:App Store 上已有版本正在审核,或已通过审核但尚未发布。等审核结束,或在 App Store Connect 中撤回提交、完成发布后,再重新提交。