Skip to Content

发布移动应用

移动应用目前仅支持 iOS,发布后用户从 App Store 下载安装。

填写应用配置

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

在移动应用客户端编辑器中,打开设置,选择应用配置,按下表填写。

配置项说明获取位置
App display name应用安装后显示在主屏幕图标下方的名称自行填写
Bundle ID应用的唯一标识,例如 com.example.myappApple Developer → Identifiers
Team IDApple 开发者团队的 10 位标识Apple Developer → 会员资格详细信息
Issuer IDApp Store Connect API 密钥的签发者 ID,格式为 UUIDApp Store Connect → 集成 → App Store Connect API
ASC keyApp Store Connect API 密钥的密钥 IDApp 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

  1. 注册 Bundle ID:登录 Apple Developer ,进入 Certificates, Identifiers & Profiles → Identifiers,点击 + 注册一个 App ID,选择 Explicit 类型并填写 Bundle ID。
  2. 创建 App 记录:登录 App Store Connect ,进入 App,点击 + → 新建 App,在 套装 ID 中选择上一步注册的 Bundle ID。
  3. 填写到应用配置:将 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 密钥,需要一起获取。

  1. 生成 API 密钥:登录 App Store Connect ,进入用户和访问 → 集成 → App Store Connect API → 团队密钥,点击 + 生成密钥。填写密钥名称,访问权限选择管理。
  2. 复制 Issuer ID:在团队密钥页面顶部复制 Issuer ID,填写到应用配置的 Issuer ID。Issuer ID 格式类似 57246542-96fe-1a63-e053-0824d011072a,格式不正确时无法保存。
  3. 复制密钥 ID:在密钥列表中找到刚生成的密钥,复制密钥 ID,填写到 ASC key。
  4. 下载并上传私钥:点击下载 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 分钟左右。生成成功后:

  1. 打开 App Store Connect,确认应用的构建版本已经处理完成。
  2. 在 TestFlight 中添加测试人员。
  3. 测试人员在手机上打开 TestFlight,安装或更新应用。

修改应用后,点击重新预览生成新的构建版本。

提交 App Store 审核

  1. 填写版本号并上传:在发布面板中点击发布,填写版本号并确认,系统会重新打包并上传到 App Store Connect。版本号至少两段,例如 1.0 或 1.0.0,并且必须大于 App Store 上的最新版本。如果最新版本尚未发布,可以沿用该版本号覆盖提交。版本号不能回退。
  2. 在 App Store Connect 中提交审核:等待构建版本处理完成后,选择该构建版本,填写本次更新内容,确认应用信息与截图后提交审核。
⚠️

首次提交时,还需要在 App Store Connect 中填写应用信息、截图和隐私问卷,审核才会受理。

常见问题

  1. 保存按钮无法点击:检查所有配置项是否已填写,App icon 和 Auth key 是否已上传,Issuer ID 格式是否正确。
  2. 发布时提示找不到 App:确认已在 App Store Connect 中创建 App 记录,且记录使用的 Bundle ID 与应用配置中的完全一致。
  3. 发布时提示密钥无效:确认 ASC key、Issuer ID 和 Auth key 来自同一个密钥,且该密钥未被撤销。
  4. 提示不能提交新版本:App Store 上已有版本正在审核,或已通过审核但尚未发布。等审核结束,或在 App Store Connect 中撤回提交、完成发布后,再重新提交。
Last updated on