测试跑完了,输出目录却缺少某些语言的截图,或者同一文件夹里混着不同设备画面?
验收结论:fastlane snapshot 能自动采集多语言、多设备截图,但任务结束不等于素材合格。按目标语言、设备覆盖、真实界面、文件结果和 App Store Connect 展示逐项复核;模拟器产物不能代替商店素材检查或审核结论。
独立开发者:你要为 iOS App 生成或更新多语言商店截图,想减少重复采集和人工漏检。
多语言维护者:你需要确认不同语言与设备对应的文件都真实可用。
发布或自动化负责人:你想把截图任务接入 Mac 构建流程,并确保部分失败不会被误报为完整交付。
01 先把截图交付范围写清楚
先列出要交付的内容,再配置 fastlane snapshot。不要从“跑多少次”开始规划:截图数量取决于目标语言、设备、测试中触发的截图点和实际执行结果,配置里的组合不是实测产物清单。
交付范围至少写明:
- 目标语言:采用 App 内实际支持、并准备提交的语言标识;分别确认应用界面文案与地区格式。
- 关键界面:列出要展示的功能页。确认 UI 测试会进入这些页面,而不是停在登录页、启动页或加载状态。
- 设备和方向:确定本次需要覆盖的 iPhone、iPad 等目标及横竖屏。不要沿用旧项目里的设备名称清单,先看当前可用模拟器和商店要求。
- 输出位置:记录 Snapfile 中的输出目录,以及清理旧截图的设置。旧文件混入新结果时,很容易把上次运行的素材误认成本次产物。
fastlane 官方文档说明,可以在 Snapfile 设置 languages、devices 和 output_directory,并按语言及设备整理生成的截图。可查看 fastlane 的截图入门文档与 snapshot 参数说明;它们描述的是采集配置,不是 Apple 商店对素材的最终验收。
02 多语言维护者:核对画面,不只核对文件名
文件名带有语言标记,不能单独证明截图里的应用已经使用目标语言。打开图像,对照代表性界面检查按钮、提示语、日期、数字和地区格式;还要留意文本截断、未翻译的字符串、回退语言和测试占位内容。
逐语言检查时,可按这组顺序走:
- 找出每种目标语言的一张代表性截图。
- 核对页面上的关键文案是否与目标语言一致。
- 检查日期、数字和地区相关显示,确认不是仅翻译了部分界面。
- 对照同一版本 App 的相同功能页,确认各语言展现的是同一功能状态。
- 发现异常时,回到 UI 测试运行路径与应用本地化设置定位原因,不要通过改文件名掩盖问题。
fastlane 的 SnapshotHelper 提供用于读取测试设备语言的 deviceLanguage,可帮助 UI 测试确认当前语言环境;具体用法以 fastlane snapshot 文档为准。对照语言环境仍不等于完成画面内容验收。
03 设备负责人:区分模拟器目标和商店展示要求
iOS 模拟器截图是采集结果,App Store Connect 则按平台、设备展示尺寸和本地化管理素材。两者需要逐项对照,不能因为测试用某个模拟器运行成功,就推断生成文件满足当前提交要求。
| 验收对象 | 你要核对什么 | 通过条件 |
|---|---|---|
| fastlane 采集目标 | Snapfile 配置的设备、语言和方向 | 与本次发布计划一致,且 UI 测试实际执行到截图步骤 |
| 输出图片 | 方向、尺寸、格式和图像内容 | 符合提交目标,并能看清应用实际界面 |
| 商店位置 | App Store Connect 中的语言和设备尺寸位置 | 上传后素材出现在正确位置,排序与产品页一致 |
| 审核内容 | 图片是否真实呈现应用及功能 | 没有只展示启动页、登录页或被营销覆盖遮挡的主功能画面 |
Apple 当前的截图规格说明规定了支持的尺寸、文件类型和设备展示要求。页面说明每种设备尺寸可上传 1 至 10 张 .jpeg、.jpg 或 .png 图片,且图片不能带透明通道;规格可能更新,提交前应以当时的官方页面为准。
如果产品界面在不同设备尺寸上相同,App Store Connect 可能会缩放已提交图片;若需要每种尺寸使用指定画面,则要在对应设备位置另行管理。查看 Apple 的上传截图与管理本地化素材说明,再决定要交哪些尺寸,不要把模拟器目标列表直接当成商店必交清单。
04 发布负责人:把失败记录和文件结果合起来验收
任务成功状态、文件存在、画面合格、上传完成,是不同的检查项。fastlane 文档说明,某台设备上的 snapshot 任务发生错误时,流程可能继续处理后续设备或语言;如需遇错即停,可检查 stop_after_first_error 配置。自动化脚本因此应保留测试结果和日志,而不是只读取最终进程状态。
| 现象 | 先查哪里 | 建议处理 |
|---|---|---|
| 某语言文件缺失 | 该语言对应的测试结果和日志 | 定位测试失败或语言启动配置,再单独重跑受影响组合 |
| 有文件但内容不对 | 图片画面、UI 测试运行路径、本地化设置 | 修复页面状态或本地化问题后重新采集,不要仅重命名文件 |
| 输出目录混入旧图 | 清理设置、文件时间和本次任务记录 | 将本次结果隔离保存,再核对旧文件是否被误交付 |
| 命令退出但局部失败 | 各设备与语言的任务日志 | 把每个预期组合的结果纳入验收条件;按需要启用遇错停止 |
按下面的步骤把验收接到发布流程:
- 固定本次范围。记录 App 版本、本次目标语言、设备和关键截图页面。
- 核对配置。检查 Snapfile 的
languages、devices、output_directory及清理设置;确认使用的模拟器目标仍有效。 - 检查运行结果。逐项查看测试结果与日志,找出失败或未执行的语言、设备组合。
- 对照预期文件。检查输出目录中的文件、路径和内容;文件名只作索引,不能代替人工确认画面。
- 检查图片规格和界面。按当前 Apple 规格检查尺寸、格式及透明通道;逐张确认应用处于真实、可展示的使用状态。
- 核对上传后的产品页。在 App Store Connect 选择正确语言和设备位置,确认素材、顺序与本次版本一致。
- 保留复核记录。留存生成结果、失败日志和上传后页面记录;把“生成成功”“上传成功”和“审核通过”分开记录。
05 素材审核者:自动采集合格不代表内容合规
Apple 的截图指南要求截图展示应用实际使用状态,而不是仅展示标题艺术、登录页或启动页。其指南还说明,对每种受支持设备提交的截图集合,需要多数截图展示应用运行中的功能;可查看官方的截图指南 2.3.3。所以,文件格式正确只解决文件检查,不能替代对实际内容的判断。
逐张查看 iOS App Store 截图,确认重点功能没有被加载状态、错误数据或登录流程遮住。若加入文字或图形叠加,核对其没有遮挡主要功能,也没有让画面表达与应用实际体验不符的内容。Apple 的本地化说明介绍了从成功测试生成本地化截图的方式;无论用哪种采集途径,最终产品页素材都应回到实际语言、画面和展示位置复核。
06 用远程 Mac 执行采集时,先确认责任边界
如果本地 Mac 不常驻,或项目需要在远程环境运行 Xcode 和 iOS 模拟器,可以先从 CALMVPS 的 Mac 环境入口了解远程使用方式。你要提前核对项目依赖、模拟器运行需求、测试数据和截图文件的取回路径;远程环境能提供运行条件,但不会替你确认每张图片的语言与商店位置。
按任务频率选择环境:只为一轮截图验收准备临时环境,可先对照方案与费用信息核算使用周期;需要持续运行自动化时,再确认所选环境能否满足团队的工具链与文件留存要求。若你依赖本地连接的设备或特定物理接口,远程 Mac 未必适合;若当前方案是手工逐台采集、借用开发机或把模拟器产物当作商店审核凭证,常见问题是重复操作、环境难复现,以及发布前缺少上传后复核。需要临时补齐 Xcode 和模拟器环境时,可以评估租用 CALMVPS 的 Mac,再按本文清单独立完成素材验收。
07 常见问题
fastlane snapshot 怎样为不同语言生成 iOS 截图?
在 Snapfile 中声明目标语言和模拟器设备,并确保 UI 测试确实走到需要截取的界面。fastlane snapshot 会为配置的语言、设备组合运行测试并收集截图;具体产物仍要检查输出目录、画面文案和设备对应关系。语言配置代表采集目标,不代表每个目标都已成功生成文件。
截图任务成功结束,但输出目录缺了几张图该怎么查?
不要只看命令行最后的成功提示。检查每个设备和语言对应的测试结果、日志与输出目录;snapshot 遇到设备执行错误时可能继续后续任务,所以部分失败不一定会让整批流程立刻停止。需要快速失败时,核对当前 fastlane 文档中的 stop_after_first_error 选项,并保留失败任务的日志供复跑。
怎样确认生成的截图语言和模拟器设备没有对错?
对照 Snapfile 中的语言、设备与输出路径,再直接打开图片检查文案、日期、地区格式及屏幕布局。文件名只能辅助定位,不能证明应用实际切换到了目标语言。选择代表性界面横向比较同一版本的各语言产物;如果界面仍显示回退语言或占位数据,应先修 UI 测试状态和本地化资源。
iOS 模拟器截图生成后能直接当作 App Store 截图吗?
可以作为候选素材,但生成成功不等于尺寸、透明通道、展示位置和内容要求都已通过检查。先按 App Store Connect 当前规格核对文件,再确认画面真实展示应用使用状态,最后到对应语言和设备位置上传并检查排序及呈现。模拟器文件本身不能证明上传成功,也不能证明审核已通过。