上架前核对 · 2026
TestFlight 是连接「开发者账号是否可用」和「能不能提审」的中间环。账号能登录,不代表构建一定能传上去。下面按交付现场顺序给出可打印核对清单,覆盖权限、证书、设备位、构建号与隐私合规。
01先看会不会卡在入口
很多人一上来就 Archive,结果卡在上传、处理或 TestFlight 可见性。建议先确认这三条主链路都通:
- 账号链路:能进 developer.apple.com 与 App Store Connect,协议未阻断
- 签名链路:证书 / 描述文件 / Bundle ID 与工程一致
- 构建链路:Build 号可递增,上传后能在 TestFlight 看到处理结果
买现货个人号做 ipa / TF 时,把「设备余量 + 能否上传构建」写成硬指标,比只看登录页更靠谱。
02账号与权限核对
- Account Holder / Admin / App Manager 角色是否足够上传构建
- App Store Connect 能打开对应 App 记录(或有权限新建)
- Agreements、税务、银行信息无阻断(Paid Apps 相关协议尤其要看)
- 双重认证与信任设备可用,避免上传当天锁号
- 若多人协作,确认谁持有恢复码与邮箱收件权
03证书与描述文件
- Distribution 证书未过期,本地 Keychain 私钥匹配
- App ID / Bundle ID 与 Xcode 工程一致
- 描述文件包含正确能力(Push、Associated Domains、Sign in with Apple 等)
- 本地 Xcode 登录的团队与后台团队一致
- Automatic Signing 若失败,能切 Manual 并指出缺哪张证书
常见翻车点:换了 Bundle ID 却沿用旧描述文件;或证书在一台 Mac 能签、另一台缺私钥。
04设备、构建号与 TestFlight
- 若走 Ad Hoc / 开发调试,设备 UDID 额度是否还够
- Build 号递增,未与已上传冲突
- 版本号(Marketing Version)与提审文案计划一致
- TestFlight 内部/外部测试组是否建好,外部测试合规信息是否齐
- 上传后 Processing 失败时,先看邮件与 Transporter / Xcode 报错原文
| 场景 | 优先核对 | 失败常见原因 |
|---|---|---|
| 仅内部测试 | 权限 + 构建处理 | 协议阻断、证书过期 |
| 外部测试 | 合规问卷 + 测试信息 | 缺出口合规/内容说明 |
| 现货号接手 | 设备位 + 能否上传 | 角色不够、证书私钥缺失 |
05提审前最后 10 分钟
- 用新安装路径走一遍登录与支付沙盒
- 检查隐私政策链接与权限用途说明是否可打开
- 截图与描述未把测试账号明文放到公开区(按审核要求放 Demo 账号)
- 确认加密 / 出口合规问卷已填
- 核对 App 分类、年龄分级、联系邮箱可回信
06FAQ
能登录开发者后台,为什么 TestFlight 还是传不上去?
常见是协议未接受、角色权限不足、证书/描述文件不匹配,或 Build 号冲突。按「协议 → 角色 → 签名 → Build」顺序查。
设备额度满了还能上 TestFlight 吗?
TestFlight 分发不依赖把设备写进 Ad Hoc 描述文件;但真机调试 / Ad Hoc 仍受设备位限制。先分清你走的是哪条分发路径。
现货号交付当天就要传构建,最少验哪几项?
建议最少验:协议状态、角色权限、证书私钥可导出/可用、能否创建或打开 App、试传一个最小构建。