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

手动提交 iOS 应用到苹果应用商店

在 macOS 上使用 Xcode 打包并上传 iOS 应用到 App Store Connect。


本指南讲解了如何使用 Xcode 对 iOS 应用进行归档并上传到 App Store Connect,如果你没有使用 EAS,或者当 EAS Submit 暂时不可用时,这会很有用。

🌐 This guide walks through archiving an iOS app with Xcode and uploading it to App Store Connect, which is useful if you aren't using EAS, or as a fallback if EAS Submit is temporarily unavailable.

如果你已经有一个 .ipa 文件,可以直接跳到 使用 Transporter 上传现有构建。对于大多数团队来说,EAS Submit 更简单,而且可以在任何操作系统上使用。

🌐 If you already have a .ipa file, skip to Upload an existing build with Transporter. For most teams, EAS Submit is simpler and works from any OS.

先决条件

🌐 Prerequisites

先决条件

4 要求

1.

注册 Apple 开发者账户

提交应用到 Apple App Store 需要付费的 Apple 开发者会员。请在 Apple 开发者门户 注册。

2.

安装 Xcode

必须在 Mac 上安装 Xcode。请参阅 设置 Xcode 获取说明。

3.

生成 iOS 目录

你的项目需要一个 ios 目录。如果你使用 CNG,运行 npx expo prebuild 来生成它。

4.

在 App Store Connect 创建一个应用记录

需要在 App Store Connect 创建一个与打包标识符匹配的应用记录。如果还没有创建,请登录 App Store Connect,点击 Apps 旁边的蓝色 +,然后选择 新建应用。

1

在 Xcode 中打开 iOS 工作区

🌐 Open the iOS workspace in Xcode

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

🌐 From your project directory, open the iOS workspace in Xcode:

Terminal
- xed ios

然后:

🌐 Then:

  1. 在左侧边栏,选择你应用的工作区。
  2. 转到 Signing & Capabilities(签名与功能) 并选择 All(全部) 或 Release(发布)。
  3. 在 Signing > Team 中,选择你的 Apple 开发者团队。Xcode 会自动生成托管的配置文件和签名证书。

2

配置发布方案

🌐 Configure a release scheme

  1. 从菜单栏中,打开 产品 > 方案 > 编辑方案。
  2. 在侧边栏选择运行,并将构建配置设置为发布。

3

为发布构建应用

🌐 Build the app for release

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

🌐 From the menu bar, open Product > Build. Xcode will build the release binary.

4

归档并上传到 App Store Connect

🌐 Archive and upload to App Store Connect

  1. 从菜单栏打开 产品 > 存档。
  2. 在 归档 下,从右侧边栏点击 分发应用。
  3. 点击 App Store Connect 并按照提示操作。Xcode 会将你的构建上传到 App Store Connect。如果想要获取 .ipa 文件并稍后上传,请在提示中选择 导出 并使用 Transporter。
  4. 登录 App Store Connect,选择你的应用,然后从 App Store Connect 仪表板提交到 TestFlight 或进行 App 审核。

用 Transporter 上传现有的构建

🌐 Upload an existing build with Transporter

如果你已经有一个 .ipa 文件,比如通过运行 eas build --platform ios --local 或从 EAS 控制台 下载构建生成的,你就不需要在 Xcode 中归档应用了。可以直接用 Apple 的 Transporter 应用上传:

🌐 If you already have a .ipa file, for example from running eas build --platform ios --local or downloading a build from the EAS dashboard, you don't need to archive the app in Xcode. Upload it with Apple's Transporter app instead:

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

这个过程可能需要几分钟,然后在苹果的服务器上还要再处理 10-15 分钟。之后,你可以在 App Store Connect 上查看你的二进制文件状态,并提交到 TestFlight 或者进行应用审核。

🌐 This process can take a few minutes, then another 10-15 minutes of processing on Apple's servers. Afterward, you can check the status of your binary in App Store Connect and submit it to TestFlight or for App Review.

进一步阅读

🌐 Further reading