App Store Connect 帮助

支持 / App Store Connect / 管理构建版本 / 上传构建版本

管理构建版本

上传构建版本

必要职能:“账户持有人”职能、“管理”职能、“App 管理”职能或“开发者”职能。请参见职能权限

在将 App 添加到你的账户后,你可以使用 Xcode、Swift Playground、altool 或 Transporter 上传构建版本。若使用 App Store Connect API,则建议通过命令行工具 Transporter 和 JSON 网络令牌(JWTs)验证来上传二进制文件。用于 API 的 JWT 也可用于上传二进制文件。如果你的 App 之后有所更改,你可以上传更多构建版本、分发构建版本进行测试,或者提交 App 至审核

你首次为 App 上传构建版本时,系统会在你的账户中创建一个该 App 的 Beta 版本。但请注意,该构建版本需要经过 Apple 系统处理后才能显示在 App Store Connect 中。处理完成后,你将收到电子邮件提醒。

当你上传一个构建版本时,系统会根据套装 ID 和版本号(位于 App 的数据包中)将该构建版本与 App Store Connect 中的 App 和版本记录关联。构建版本字符串具有唯一性,用于在系统中标识构建版本。

你还可以使用 Xcode Cloud 来创建和上传构建版本,通过持续集成和持续交付(CI/CD)的软件开发方法,跟踪和改进软件质量,同时确保你的 App 及其架构一直处于可发布状态。进一步了解 Xcode Cloud

你也可以通过 Apple-Hosted Background Assets(Apple 托管背景素材)来上传与构建版本分开管理的素材。进一步了解。

了解即将实行的上传要求。

通过 Xcode 上传 App 的二进制文件

Xcode 是 Apple 推出的集成开发环境(IDE)。开发者可使用 Xcode 为 Apple 产品(包括 iPhone、iPad、Mac、Apple TV、Apple Vision Pro 和 Apple Watch)构建 App。Xcode 提供诸多工具,能帮助你管理整个开发工作流程,包括创建、测试、优化 App 并将其提交审核。

如需了解如何通过 Xcode 上传 App 的二进制文件,请参阅“Distributing your app for beta testing and releases(分发 App 以供 Beta 版测试与发布)”,或者在 Xcode 中选择“Help(帮助)”>“Xcode Help(Xcode 帮助)”并搜索“Distributing your app for beta testing and releases(分发 App 以供 Beta 版测试与发布)”。

请在 Mac App Store 中下载 Xcode

支持的 Xcode 版本

请使用以下版本的 Xcode 上传 App 至 App Store Connect,以便分发 App 或通过 TestFlight 将 App 发送给测试员。你可以查看交付进度(包括警告、错误和交付日志)和交付历史。

【注】自 2026 年起,你将需要使用 Xcode 14 或更高版本才能向 App Store Connect 上传 App。

目标类型

使用 Xcode 构建

使用 Xcode 上传

iOS App

iOS App 扩展

watchOS App 扩展

Xcode 16 或更高版本

Xcode 6 或更高版本

macOS App

Xcode 6 或更高版本

Xcode 6 或更高版本

Apple tvOS App

Xcode 16 或更高版本

Xcode 7.1 或更高版本

visionOS App

Xcode 16 或更高版本

Xcode 15 或更高版本

所有目标类型均可通过 Transporter 和 altool 上传。

通过 altool 上传 App 的二进制文件

你可以使用 xcrun(包含在 Xcode 中)来调用 altool,该命令行工具用于验证并上传 App 的二进制文件至 App Store。在“终端”的命令行中指定以下命令之一:

$ xcrun altool --validate-app -f file -t platform -u username [-p password] [--output-format xml]
$ xcrun altool --upload-app -f file -t platform -u username [-p password] [--output-format xml]

进一步了解如何使用 altool。

通过 Transporter 上传 App 的二进制文件

Transporter 是一款 macOS App,可以让你轻松将 App 上传至 App Store Connect 以便后续分发。你还可以查看交付进度(包括警告、错误和交付日志)和交付历史。

【注】自 2026 年起,你需要使用将于今年晚些时候发布的 Transporter 版本,才能继续通过 Aspera 和 Signiant 传输协议上传 App。若使用默认的 HTTPS 传输协议上传,则不会受到影响。

你可以在 Mac App Store 中下载最新版本的 Transporter。

更多信息请参见《Transporter 帮助》。