4.4 iOS 打包：TestFlight 与 App Store 上架

核心结论

iOS 打包流程：UE 生成 Xcode 工程 → Xcode 用分发证书签名 → Archive 生成 ipa → 上传。TestFlight 是苹果官方的"测试轨道"，也是上架前的必经验收。官方打包指南（https://www.wanxiangyundang.top/read/unreal-engine-5-8-docs/packaging-ios-projects-in-unre-ccfe）是这一篇的主线。

打包方式：UE 直接出 ipa vs Xcode 工程

我的建议：日常用 UE 直接打包；遇到要改 Info.plist（如权限说明文案）或接原生 SDK 时，用 Xcode 工程流程。

Project Settings 关键项（iOS）

Info.plist 权限文案：调相机/相册/定位等权限时，必须写"用户能看懂的理由"文案；不写或写得太笼统，苹果审核直接 2.1 拒审（见 0504）。

TestFlight 流程

1. Xcode 或 UE 打出分发 ipa。
2. 用 Transporter（苹果官方上传工具）或 Xcode 上传到 App Store Connect。
3. 后台"TestFlight"标签等构建处理（10~30 分钟），可能被自动扫描拒。
4. 加内测人员（邮箱邀请），发测试邀请邮件。

TestFlight 的好处： - 内测包带"反馈按钮"，玩家可直接发反馈带截图。 - 每个构建版本都可独立下载（多人可并行测不同版本）。 - 上架前最后一次真机验收：TestFlight 包与正式包是同一构建产物，可信度远高于自己 ad-hoc 装的包。

App Store 上架流程

1. 构建上传：同 TestFlight 流程，上传后在后台"提交审核"。
2. 商店资料：
3. 截图（必须 6.9" iPhone 最新尺寸 + 可选 iPad）
4. 描述、关键词、支持 URL、隐私政策 URL（必须）
5. 年龄分级问卷
6. App 隐私问卷（收集了什么数据、用途声明——不真实填报会被查）
7. 提交审核：平均 1~2 天，常见拒因见 0504。
8. 通过后发布：可选"自动发布"或"手动发布"（配合宣发选时机）。

常见坑与解法

坑 1：上传时报"无效的包"

原因：常见是图标缺失（1024 图标问题）、Info.plist 权限文案缺、或 Bundle ID 与后台不符。

解法：先看苹果返回的邮件/错误码；缺图标补图标（注意 UE5 的图标设置要走 Project Settings 而不是只放 Xcode）。

坑 2：构建在 TestFlight 里"处理失败"

原因：用了私有 API、或发布构建里包含调试代码（如调试签名）。

解法：确认用分发签名；查苹果邮件说明。反复失败可在后台查看构建详情。

坑 3：审核被拒"Guideline 2.1 - 性能/App 不完整"

原因：测试账号没提供/账号登录不上、关键功能崩溃、占位内容。

解法：提交时填可用的演示账号；提交前完整过一遍主线流程（见 0505 清单）。

坑 4：上架后改不了 Bundle ID

原因：设计如此。

解法：上架前确定 Bundle Identifier，一旦上线永久绑定。

相关节点速查

• 官方打包指南：https://www.wanxiangyundang.top/read/unreal-engine-5-8-docs/packaging-ios-projects-in-unre-ccfe
• 上传工具：Transporter（Mac App Store 可下）
• 后台：App Store Connect

心得：iOS 上架的成败 80% 在准备：账号类型、Bundle ID、权限文案、演示账号、截图尺寸——这五样在第一次提审前就在清单里逐项打勾，大多数项目能一次过。靠审核员"高抬贵手"是不存在的。