用途 store-screenshots 用于自动化生成 App Store 与 Play Store 所需的应用商店截图,确保每张截图都符合各商店槽位要求的精确像素尺寸,并且可以在下一次发版时复现。它强调:绝不要通过放大截图来达到目标尺寸,而应更换设备,而不是改变像素。
主要能力
- 在接触设备之前先构建截图计划:确定哪些商店、哪些槽位、每个槽位多少张、哪些语言区域。
- 锁定确定性:使用种子数据、固定时钟、关闭通知与动画。
- 用 Maestro 流程把应用驱动到每个目标界面。
- iOS 路径:启动模拟器、覆盖状态栏、用 simctl io screenshot 截图。
- Android 路径:从当前 SDK 实际存在的配置文件创建 AVD、进入演示模式、用 adb exec-out screencap 截图。
- 截图清单稳定后,用 fastlane snapshot / fastlane screengrab 替换手动步骤,实现按需重新生成整套截图。
- 仅在截图不符合规格时,用 ffmpeg 调整尺寸、补边并去除 alpha 通道。
- 把文件移动到 deliver/supply 读取的路径。
使用方式 该技能提供 /mobile-release:screenshots 命令,可重新生成两个平台的整套截图,测量每个输出,并停在磁盘文件阶段,不上传,也不需要商店凭据。
流程要点:
- 先构建截图计划,输出为表格并确认。需要回答:哪些商店(App Store、Play 或两者);应用实际声明了哪些设备家族(iOS 读取 Xcode target 中的 TARGETED_DEVICE_FAMILY,1 为仅 iPhone,模板默认 1,2 声明 iPad 并使 iPad 截图在 App Store Connect 中成为必需;Android 是仅手机,还是也包含平板 / Wear / TV);每个槽位多少张、哪些语言区域。Apple 要求所有本地化使用相同的截图尺寸。
- 锁定确定性,否则一次糟糕的运行意味着全部重拍。
- 用 Maestro 流程驱动应用。
- iOS:xcrun simctl list devices available、boot、bootstatus,覆盖状态栏(时间 9:41、WiFi、蜂窝、电池等),设置外观,用 xcrun simctl io booted screenshot --type png --mask ignored 截图,最后清除状态栏覆盖。--mask ignored 保存未遮罩的帧缓冲;App Store 拒绝 alpha 通道。
- Android:sdkmanager 安装 platform-tools、emulator、system-images;avdmanager list device -c 先列出再创建 AVD;启动 emulator;adb wait-for-device;关闭动画;通过 SystemUI 演示模式设置干净状态栏;adb exec-out screencap -p 截图;退出演示模式。演示模式仅在 Nexus 和 Pixel 设备上经过认证,Google 表示这些命令“可能并非在所有设备上都能工作”,需目视检查第一张截图。
- 自动化:iOS 用 fastlane snapshot,Android 用 fastlane screengrab。
- 交付路径:iOS 的 fastlane deliver 从 fastlane/screenshots 上传;Android 的 fastlane supply 读取 fastlane/metadata/android/<locale>/images/<type>Screenshots/,其中 <type> 为 phone、sevenInch、tenInch、tv、wear 之一。supply 上传时按字典序排列,因此文件名应加数字前缀。
适用场景
- 需要为 App Store 和/或 Play Store 生成符合规格的截图集。
- 需要在下一次发版时可复现地重新生成整套截图。
- 需要同时处理 iOS 与 Android 两个平台的截图流程。
- 需要把截图自动交付到 fastlane deliver / supply 读取的路径。
限制
- 不要求商店凭据,也不会上传文件,只把文件写到磁盘。
- 绝不应通过放大截图来达到目标尺寸;应更换设备。
- 演示模式仅在 Nexus 和 Pixel 设备上经过认证,可能并非在所有设备上都能工作。
- 部分命令与尺寸映射的置信度标注为 [snippet] 或 [unverified],需在实际运行时确认。
- 文档中标注的 Apple 数据来自 developer.apple.com 截图规格页面(2026-08-05 获取);Play 数据仅为二手来源,因 support.google.com 在侦察期间无法访问,需对照 Play Console 上传对话框重新核对。
- 具体价格、收费、平台支持范围等事实资料未提供。