必须用Distribution证书和App Store描述文件生成.ipa,Bundle ID、版本号、图标等需严格匹配App Store Connect要求,上传后需等待Processing完成变为Ready to Submit才能提交审核。

不能直接提交 .ipa 文件到 App Store,必须先上传构建版本(Build)到 App Store Connect,再在后台关联元数据并提交审核。整个过程依赖 Apple 的签名体系和上传工具链,Windows 和 macOS 用户路径不同,但核心步骤一致。
云打包生成正式版 .ipa 必须用 Distribution 证书
HBuilderX 云打包时选错证书类型会导致后续上传失败或被拒。开发证书(Development)打包的 .ipa 只能装在已注册设备上,无法上传;只有 Distribution 类型的证书 + App Store 描述文件(.mobileprovision)才能生成可提交的包。
- 证书类型必须选
IOS Distribution (App Store and Ad Hoc),不是IOS App Development -
Bundle ID必须与 App Store Connect 中创建 App 时填写的完全一致(大小写、点号都不能错) -
manifest.json中的versionName和versionCode必须高于上一版,否则 App Store Connect 不会显示新构建版本 - 图标必须是直角 PNG,无 alpha 通道,尺寸符合 Apple 要求(如 1024×1024),否则 Transporter 会报
ERROR ITMS-90717
Windows 用户必须用 Appuploader 或 Transporter 上传
Apple 官方 Transporter 应用已支持 Windows(2023 年起),无需 Mac;Appuploader 是更轻量的替代方案,两者都绕过了 Xcode 依赖。关键不是“能不能传”,而是“传完能不能被识别为有效构建”。
- 上传前需在 Apple Developer Account 中生成「App-Specific Password」(专用密码),不是 Apple ID 登录密码
- Transporter 启动后点击
+→ 选择.ipa→ 点击Deliver,上传成功后邮件提示Processing completed - Appuploader 需在登录界面填 Apple ID + 专用密码,上传后等待约 5–15 分钟,App Store Connect 的
Builds列表才会出现新版本 - 若上传后始终不显示构建版本,检查
.ipa内嵌的embedded.mobileprovision是否为 App Store 类型(可用codesign -d --entitlements :- YourApp.app在 Mac 上验证,Windows 用户可重打一次包确认)
App Store Connect 中构建版本状态卡在 “Processing” 是常见陷阱
上传成功 ≠ 构建就绪。苹果后台会对 .ipa 进行二进制扫描、签名验证、权限声明校验等,耗时从几分钟到半小时不等。期间状态为 Processing,不可选、不可提交。
- 状态变为
Ready to Submit才代表通过了基础校验,此时才能在Version Release页面点击+添加该构建 - 如果长时间停留在
Processing,大概率是Info.plist缺少必要字段(如NSAppTransportSecurity配置错误)、隐私描述缺失(如未在manifest.json的ios > privacyDescription下配置相机/相册权限说明) - 上传后立即去
TestFlight标签页查看,能看见构建即说明签名基本正确;若 TestFlight 里也看不到,说明上传未被接收,需重新打包上传
真正容易被忽略的是:每次上传新构建前,必须确保 App Store Connect 中对应版本号(如 1.2.0)尚未提交审核。一旦版本进入 Waiting for Review,就不能再往里面添加新构建——只能新建一个版本(如 1.2.1)重新走流程。这不是技术限制,而是 Apple 的发布模型设计。











