TestFlight 与正式 App Review 衔接指南:构建、外部测试、审核备注与测试账号
把 TestFlight 当正式 Review 预演:内部到外部测试节奏、构建号陷阱、审核备注怎么写、测试账号与邀请说明,减少「审核员走不通」类拒信。Telegram @hagee66。
官网传送门(可直接点击跳转)
打开本文 · 指南库 · 苹果上架 · 谷歌上架 · 双端上架
Telegram 询价 @hagee66 · 官网 goee.cc
问题:包发给同事了,审核员仍走不通
TestFlight 的价值是用同一构建预演正式 App Review:安装、登录、权限弹窗、订阅沙盒、账号删除、截图对应的界面,都在点「提交审核」之前走一遍。只把它当成给同事传包的渠道,正式审核时仍会出现测试账号失效、验证码打到私人手机、备注里的按钮在这一构建已经改名。
衔接目标只有一个:审核员只看备注和账号,就能完成你们声称的关键路径。材料总表见 App Store 上架材料清单。测试员人数、外部测试是否需要 Beta 审核、构建有效期,会随 App Store Connect 调整,以官方当前页面为准。本文不承诺审核通过或审核时长。
上架通(goee.cc)在苹果上架协作中,把「陌生人按备注走通」当作提交前的门槛。路径不确定时,可把备注草稿发给 Telegram @hagee66。
适用读者
| 读者 | 本文用法 |
|---|---|
| 准备从 TestFlight 转正式提审的负责人 | 核对构建号、备注、账号是否是同一套 |
| iOS 开发 | 确认提审构建没有调试入口和错误环境 |
| 需要登录、邀请码或订阅的产品 | 把限制写进备注,并准备可用账号 |
| 被「无法登录 / 无法复现」打回的团队 | 把拒信步骤改成 TestFlight 用例再修 |
| 外包或代上架协作 | 用文末交接单移交构建与账号 |
提交前要确认的五件事
- Connect 里选中的构建,就是复测通过的那一版,能安装、主流程能走完。
- 测试账号在提交前仍能登录,验证方式有人值守或已改为可重复获取。
- 审核备注的步骤已经由未参与开发的人只看文字走通。
- 截图、描述、关键词与该构建的界面一致。元数据见 App Store 元数据清单。
- 若有内购或订阅,沙盒路径按 内购注意事项 演示成功。
五件事里有一件失败,就先改构建或改备注,再提交。
内部测试与外部测试
| 项目 | 内部测试 | 外部测试 |
|---|---|---|
| 适合谁 | 团队成员快速验证崩溃、文案、权限 | 更接近陌生用户的安装与反馈 |
| 典型用途 | 一天多次换包、定位必现问题 | 按备注走查、收集可复述的问题 |
| 提审前的用法 | 开发自测通过的候选包 | 至少一次「只看备注」的走查 |
| 要注意 | 内部能过,不代表审核员有你们的上下文 | 外部测试的合规提示和测试信息以当前页面为准 |
无论哪一种,正式提审前都要有一次陌生人视角:把备注发给没有看过需求文档的人,让对方从安装后的第一屏开始操作。对方提问的地方,就是备注该补的句子。
外部测试的组规模、是否先经过 Beta App Review、公开链接是否可用,都可能变化。以 App Store Connect 当前页面为准,不要用旧截图规划当天的发布。
构建号:选错包是最贵的低级错误
- 上传后等处理完成,再确认构建号、营销版本号与测试记录一致。
- 团队约定递增规则:哪一位负责上传、如何避免把 staging 配置打进候选包。
- 修拒审时写明这次是新构建,还是仅修改元数据。仅改截图时不要让审核员去找一个不存在的新包。
- 导出合规、加密问答等上传时的必填项,按当前构建的真实情况填写,避免卡在处理中。
候选构建确定后,冻结界面文案再截商店图。先截图再改按钮名称,是元数据不符的常见来源。
用同一构建预演审核员会碰到的路径
建议在 TestFlight 安装的包上逐项打勾,而不是在 Xcode 调试器里打勾。
| 路径 | 预演时看什么 |
|---|---|
| 冷启动 | 是否闪退、是否停在空白页、是否要特定网络 |
| 登录 | 账号、密码、验证码、二次验证是否按备注可完成 |
| 权限 | 相机、定位、跟踪等弹窗的用途说明是否具体 |
| 核心功能 | 备注里的每一步是否还有这个按钮 |
| 内购 | 沙盒购买、权益到账、恢复购买 |
| 账号删除 | 若提供账号,删除或注销入口能否演示 |
| 空状态与错误 | 断网、无数据时是否有可理解的提示 |
权限弹窗不要写「用于提升体验」这类空话。写清这一次申请是为了完成哪一个功能。若功能可以不用该权限,备注里说明如何跳过,以及跳过后仍能审到什么。
审核备注:从能登录写到能审完
最低限度的账号密码不够。审核员不知道下一步点哪里,就会停在登录页。建议按下面的结构写,并保证顺序与当前构建一致。
【构建】
版本号 / 构建号:
本次相对上次的变化(如被拒后重提):
【账号】
用户名:
密码:
验证码或二次验证:如何获取、谁值守、有效时长
若有第二个角色(管理员 / 已购用户):
用户名:
密码:
【路径】
1. 安装后第一屏做什么
2. 使用上述账号登录
3. 进入要演示的功能,点哪些按钮
4. 内购入口、沙盒说明、恢复购买位置(如有)
5. 账号删除入口(如有)
【限制】
地区、邀请码、必须切换的语言、必须允许的权限:
【请不要】
不要使用生产环境真实扣款账号;购买请用备注中的沙盒说明。
备注用审核员能执行的动词:点「继续」、选择「示例项目」、等待列表出现。避免「体验一下核心玩法」这种无法判定完成的句子。
测试账号怎么管
- 提交前 24 小时内再登录一次。过期密码是「无法复现」类拒信的高频原因。
- 验证码不要只绑在无人看管的私人手机上。提供可重复获取的方式,或在审核期间安排值守,并在备注写明响应时间。
- 若产品强制手机号,提供审核可用的号码策略,或提供与正式用户一致、但已说明获取方式的测试号。不要做只对审核 IP 放开的隐藏开关。审核看到的路径应与真实用户路径一致。
- 多角色应用至少准备审核所需的那个角色。只给一个没有任何数据的新账号,可能导致核心界面是空的。可以预置一份演示数据,并在备注说明这些数据是示例。
- 账号不要和某个人的私人订阅、私人通讯录绑死。人员休假时审核仍要能登录。
与内购、订阅的衔接
沙盒账号和登录应用的测试账号分开写。恢复购买的菜单位置写到能点到的那一层。自动续费的价格、周期和取消说明,在购买前的屏幕上确认可见。商品在后台的状态要是审核能买到的状态。细节见 内购与订阅上架注意事项。
在 TestFlight 上用沙盒完成一次购买和一次恢复,把结果记到构建记录里:时间、构建号、操作人、看到的权益变化。正式提交时备注与这次记录一致。
元数据与构建锁在一起
截图、预览视频、描述里的界面,来自当前候选构建。描述里的「支持某某功能」,在备注路径里要能到达。关键词和副标题不要使用包里不存在的能力。对不上时,先改文案或先改包,再提交。不要寄希望于审核员忽略差异。
年龄分级、隐私营养标签若与这次构建新加的 SDK 或登录方式有关,提交同一天复核。标签填写方法见材料清单中的隐私部分,不要在 TestFlight 阶段把声明留到「等被拒再填」。
提审前检查清单
- 候选构建已在真机通过 TestFlight 安装
- Connect 选中的构建号与走查记录一致
- 冷启动和备注中的每一步可完成
- 权限文案具体,跳过权限后的路径已说明
- 测试账号在 24 小时内登录成功
- 验证码或二次验证有值守或可重复获取
- 截图与该构建一致
- 文案无包内不存在的功能,无无法证明的绝对化承诺
- 内购沙盒路径已走通(如适用)
- 若曾被拒:拒信中的步骤已在新构建上复测
被拒之后怎么用 TestFlight
把拒信里的复现步骤抄成用例:从哪一屏开始、点了什么、期望是什么、实际是什么。在新构建上逐条打勾,记录构建号。再按 拒审整改流程 写回复,附上新构建号和仍然有效的账号。感觉修好了,但没有人按拒信步骤重走,是二次被拒的常见原因。
若拒信只涉及截图或描述,可以不换包,但回复里要明确「构建未变,修改的是哪一项元数据」,避免审核员去找一个新构建。
提审交接单
【TestFlight → App Review 交接】
App 名称:
Bundle ID:
营销版本 / 构建号:
TestFlight 走查人与日期:
走查结论:通过 / 阻塞(阻塞点:)
登录账号与获取验证码的方式:
沙盒或购买说明:
备注全文:见附件
截图是否对应该构建:是 / 否
曾被拒的条款与本次修复点:
值守联系人与时段:
交接单和账号分开渠道保管。需要上架通协助提交时,把走查结论一并发给 @hagee66,并说明材料是否已按 goee.cc 的清单核对。审核结论以 Apple 当次回复为准。
从内部包到提交的时间顺序
把候选包留出走查时间,比提交前夜改按钮更稳。下面的天数是团队节奏示例,不是 Apple 的时限。
- 内部测试。 研发上传构建,处理完成后再安装。此阶段修崩溃、环境地址和明显的调试入口。出口合规等上传问答按这一构建的真实情况填写,避免一直停在处理中。具体问项以 Connect 当前页面为准。
- 冻结界面。 确定不再改按钮名称和空状态文案,然后截商店图、写审核备注。
- 陌生人走查。 用外部测试或把内部链接发给未参与开发的人,只提供备注和账号。对方问的每一句都补进备注。
- 提交前 24 小时。 再登录一次,确认验证码渠道有人值守,核对 Connect 选中的构建号与走查记录相同。
- 提交。 备注、账号、截图、隐私标签指向同一构建。曾被拒的,在备注开头写上次问题对应的修复点。
TestFlight 里的崩溃和截图反馈要在提交前看完。同一崩溃在走查人手机上出现,就不要带着它进 App Review。反馈邮件里的步骤抄进用例,修完在新构建上打勾。组的人数、公开链接和是否需要 Beta 审核会变,当天以官方当前页面为准。
备注里不写内部代号、不写「看需求文档第 4 节」、不写只有办公室网络才能打开的地址。若功能依赖示例数据,写明数据已经在测试账号里,以及列表为空时点哪里可以生成一条。走查人若用了十秒以上寻找某个按钮,把按钮的屏幕位置补进对应步骤,例如「底部第三个标签」。提交时备注、账号和构建号来自同一次走查,不要混用上周的密码和这周的包。
决策:换构建、改备注,还是先停下来
提交前夜用记录做决定,不用群里最后一句感觉。从最近一次陌生人走查开始往下看。
最近一次走查
├─ 备注里的步骤没有走完
│ ├─ 按钮改名、闪退、环境地址错误、界面与备注不符 → 修包并升构建号,重新走查
│ └─ 账号过期、验证码无人接、步骤顺序写反 → 不换包,改备注或换值守后再走查
├─ 走查通过,但截图、描述或预览与这一构建不一致
│ └─ 改元数据或重截图。构建号保持走查通过的那一个
├─ 曾被拒,拒信里的步骤还没有在这一构建上打勾
│ └─ 先复测,再按拒审整改流程写回复
└─ 走查通过,且 24 小时内登录仍成功
└─ 可以提交。审核结论以 Apple 当次回复为准
外部测试要不要先经过 Beta 审核、构建能保留多久、公开链接是否还能用,当天打开 App Store Connect 看。以官方当前页面为准。 走查通过只说明这条路径当时能走通,不表示正式审核会通过。
备注逐句验收
把备注交给没有看过需求的人之前,先自己对每一句做这张表。对不上的句子删掉或改成能执行的动作。
| 句子类型 | 合格 | 需要改写 |
|---|---|---|
| 位置 | 「底部第三个标签 → 示例项目」 | 「进入核心功能体验一下」 |
| 账号 | 用户名、密码、验证码获取方式分开写 | 「用测试账号登录」 |
| 完成标志 | 「列表出现一条标题为示例的记录」 | 「看看是否正常」 |
| 限制 | 「需允许相机;拒绝后仍可走相册上传」 | 「请打开需要的权限」 |
| 购买 | 「用备注中的沙盒账号,不要用个人付款账号」 | 「可以用自己的 Apple ID 买一下」 |
备注里不出现内部代号、需求文档章节号、只有办公室网络能打开的地址。功能依赖示例数据时,写明数据已经在这个账号里。走查人寻找某个按钮超过十秒,把屏幕位置补进对应步骤。
走查记录与构建日志
审核备注给审核员看。走查记录和构建日志给下一班的人看。三份文件使用同一个构建号。
【TestFlight 走查记录】
日期 / 走查人(未参与本包开发):
营销版本 / 构建号:
设备与系统版本:
冷启动:通过 / 失败(现象:)
登录账号(只写代号,密码不写进本记录):
验证码:当场完成 / 等待分钟数:
权限:允许与拒绝各测一次的结果:
备注步骤 1:
备注步骤 2:
备注步骤 3:
内购或订阅(如有):沙盒结果:
账号删除(如有):入口与删除后再次登录的现象:
走查人原话提问(这些句子补进备注):
结论:可提交 / 先改备注 / 先换构建
【构建日志】
日期 | 构建号 | 上传人 | 环境(正式 / 已注明的测试) | 相对上一包的变化 | 走查结论
日志只追加,不覆盖。提审时选中的构建必须能在日志里找到「走查通过」的那一行。修拒审时新开一行,写明拒信条款和这次改的是包还是元数据。
三条容易被跳过的路径
登录成功只说明账号有效。下面三项在 TestFlight 安装的包上各做一次,结果写进走查记录。
| 路径 | 做一次什么 | 备注里要有的句子 |
|---|---|---|
| 拒绝权限 | 系统弹窗点不允许,看主流程能否继续 | 跳过后仍能审到哪一屏 |
| 空列表 | 用没有预置数据的账号打开核心列表 | 如何生成一条示例,或改用已预置数据的账号 |
| 删除账号 | 从设置走到确认,再用同一账号登录 | 删除后看到的提示;若需人工处理,写明值守时长 |
删除若要人工审核才完成,审核期间必须有人处理。只写「联系客服删除」而没有人接,这条路径等于没有。入口的具体要求以官方当前页面为准。
权限弹窗的用途字符串对应这一次操作,例如「用于扫描二维码加入房间」。首次启动不要连续弹出全部权限。能延后到用户点下对应功能时再申请的,就放到那一步。
提交当天的小时级清单
- 打开 Connect,抄下当前选中的构建号,与走查记录一致
- 用备注中的账号再登录一次,验证码渠道有人值守
- 截图、预览、描述里的按钮名称仍存在于这一构建
- 隐私营养标签与这一构建的登录方式和 SDK 一致
- 内购沙盒路径与 内购注意事项 的记录是同一次构建
- 曾被拒的,备注开头写了上次问题对应的修复点
- 值守人知道审核可能跨自己的下班时间,备份联系人已写进交接单
五项里任何一项对不上,就回到决策树的对应分支,不要带着已知缺口点提交。
协作:接收人只做一件事
外包、代上架或跨时区值班时,接收人要么「按备注再走一遍」,要么「按已通过的走查提交」。不要把两件事混成「你看着办」。
【TestFlight 协作交接 · 接收人】
接收人:
App 名称 / Bundle ID:
构建号与上传时间:
环境:
走查记录结论:可提交 / 需再走查
审核备注全文位置:
登录账号交付方式(密码不写在本单):已单独发送 / 待发送
验证码值守时段与备份联系人:
沙盒说明是否另附:
截图是否对应该构建:是 / 否
请接收人做的唯一动作:按备注再走一遍 / 按记录提交
提交后回写:提交时间与当时的构建号
账号密码走单独渠道。上架通协助提交时,把走查结论和这张单发给 @hagee66,并说明是否已按 goee.cc 的材料清单核对。审核结论以 Apple 当次回复为准。
问与答
内部已经有很多人用过,还要陌生人走查吗?
要。同事知道按钮在哪。审核员只看备注。使用次数不能代替「只看文字」的那一次。
备注写很长会不会有问题?
步骤写全可以。每一句都要能执行。把「体验核心功能」改成「点底部第三个标签,打开示例项目」。
审核期间又上传了新构建,备注要不要改?
以这次审核实际挂上的构建为准。换了构建,备注、账号和截图一起改到新构建。只换包不改备注,容易在下一步出现界面不符。
验证码能不能写成一个固定数字?
只有产品对所有用户都如此时才这样写。给审核单独留一套隐藏入口,不在本文的做法里。提供可重复获取的正常渠道,或安排值守。
外部测试通过了,正式审核是不是同一件事?
不是。外部测试可能涉及单独的测试审核,正式上架是另一次审核。入口和要求会变,以官方当前页面为准。外部测试通过不表示正式审核会通过。
被拒后 TestFlight 上已经好了,回复里附什么?
新构建号、仍有效的账号、按拒信步骤复测的结果。写法见 拒审整改流程。
只改了截图,需要升构建号吗?
不需要为了截图单独升构建。回复和备注里写明构建未变、改的是哪一项元数据。截图必须来自当前这个构建。
预览视频里的点击和备注不一致怎么办?
以构建里的真实界面为准,重做视频或改备注,使两者描述同一次操作。材料总表见 App Store 上架材料清单。
常见错误
- 走查用的是调试包,提交用的是另一构建。 以 Connect 里选中的构建号为准再走一遍。
- 备注还在写旧按钮名称。 冻结文案后再写备注、再截图。
- 验证码打到已离职同事的手机。 提交当天换可用渠道。
- 给审核员空账号,核心列表没有数据。 预置示例数据并在备注说明。
- 用隐藏开关让审核看到另一套功能。 审核路径与用户路径保持一致。
- 外部测试的规则按记忆配置。 人数、链接和 Beta 审核要求以官方当前页面为准。
- 被拒后不复测拒信步骤就重提。 先在 TestFlight 打勾,再写回复。