This documentation is available as Markdown for AI agents and LLMs. See the full Markdown index or append .md to any documentation URL.

手动将 iOS 应用提交到 Apple App Store

编辑页面

在 macOS 上使用 Xcode 将 iOS 应用归档并上传到 App Store Connect。


本指南将介绍如何使用 Xcode 归档 iOS 应用并将其上传到 App Store Connect。如果你不使用 EAS,或者 EAS Submit 暂时不可用,这会非常有用。

如果你已经有 .ipa 文件,请跳转到使用 Transporter 上传现有构建版本。对于大多数团队而言,EAS Submit 更简单,并且可以在任何操作系统上使用。

前提条件

Prerequisites

4 requirements

1.

注册 Apple Developer 帐户

要将应用提交到 Apple App Store,必须拥有付费的 Apple Developer 会员资格。请在 Apple Developer Portal 注册。

2.

安装 Xcode

必须在 Mac 上安装 Xcode。请参阅设置 Xcode 了解相关说明。

3.

生成 ios 目录

项目需要一个 ios 目录。如果使用 CNG,请运行 npx expo prebuild 生成该目录。

4.

在 App Store Connect 中创建应用记录

必须在 App Store Connect 中创建一个与应用匹配的 bundle 标识符的应用记录。如果尚未创建,请登录 App Store Connect,点击 Apps 旁边的蓝色 +,然后选择 New App

1

在 Xcode 中打开 iOS 工作区

在项目目录中,在 Xcode 中打开 iOS 工作区:

Terminal
xed ios

然后:

  1. 在左侧边栏中,选择应用的工作区。
  2. 前往 Signing & Capabilities,然后选择 AllRelease
  3. Signing > Team 下,选择 Apple Developer 团队。Xcode 将生成自动管理的配置描述文件和签名证书。

2

配置发布方案

  1. 在菜单栏中,打开 Product > Scheme > Edit Scheme
  2. 在边栏中选择 Run,并将 Build configuration 设置为 Release

3

构建发布版本的应用

在菜单栏中,打开 Product > Build。Xcode 将构建发布二进制文件。

4

归档并上传到 App Store Connect

  1. 在菜单栏中,打开 Product > Archive
  2. Archives 下,从右侧边栏中点击 Distribute App
  3. 点击 App Store Connect 并按照提示操作。Xcode 会将构建版本上传到 App Store Connect。若要获取 .ipa 文件并稍后上传,请在提示中选择 Export,然后使用 Transporter
  4. 登录 App Store Connect,选择应用,然后从 App Store Connect 控制面板提交到 TestFlight 或进行 App Review。

使用 Transporter 上传现有构建

如果你已经有一个 .ipa 文件,例如通过运行 eas build --platform ios --local 获取,或从 EAS 控制台 下载构建,则无需在 Xcode 中归档应用。请改用 Apple 的 Transporter 应用上传:

  1. 从 App Store 下载 Transporter
  2. 使用你的 Apple ID 登录。
  3. 通过将 .ipa 文件直接拖入 Transporter 窗口,或点击 +添加 App 按钮打开文件对话框并选择文件,来添加构建。
  4. 点击 交付 按钮提交。

此过程可能需要几分钟,之后还需要在 Apple 服务器上处理 10-15 分钟。完成后,你可以在 App Store Connect 中查看二进制文件的状态,并将其提交到 TestFlight 或进行 App 审核。

进一步阅读