SuperAPI AI 工具集

store-screenshots

编程与开发

查看项目

更新于 10-16 18:29

技能介绍

用途 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 命令,可重新生成两个平台的整套截图,测量每个输出,并停在磁盘文件阶段,不上传,也不需要商店凭据。

流程要点:

  1. 先构建截图计划,输出为表格并确认。需要回答:哪些商店(App Store、Play 或两者);应用实际声明了哪些设备家族(iOS 读取 Xcode target 中的 TARGETED_DEVICE_FAMILY,1 为仅 iPhone,模板默认 1,2 声明 iPad 并使 iPad 截图在 App Store Connect 中成为必需;Android 是仅手机,还是也包含平板 / Wear / TV);每个槽位多少张、哪些语言区域。Apple 要求所有本地化使用相同的截图尺寸。
  2. 锁定确定性,否则一次糟糕的运行意味着全部重拍。
  3. 用 Maestro 流程驱动应用。
  4. 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 通道。
  5. 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 表示这些命令“可能并非在所有设备上都能工作”,需目视检查第一张截图。
  6. 自动化:iOS 用 fastlane snapshot,Android 用 fastlane screengrab。
  7. 交付路径: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 上传对话框重新核对。
  • 具体价格、收费、平台支持范围等事实资料未提供。