用途:为 Apple 平台应用生成 App Store 截图自动化流水线,通过 UI 测试抓取截图、叠加本地化营销文案、添加设备边框,并导出 App Store Connect 所需的全部尺寸,减少每次发版的手工截图工作。需 Swift 5.9+,iOS 16+/macOS 13+,并存在 UI 测试目标。
主要能力:生成截图模式控制器(检测 --screenshot-mode 启动参数,关闭引导、分析、内购,加载示例数据)、截图计划配置(屏幕、设备、语言、输出路径)、XCUITest 截图类与辅助工具(含 tapUnhittable() 扩展)、后处理编排与本地化文案叠加渲染、端到端导出脚本、示例内容生成器、macOS 桌面准备脚本(用 trap 恢复设置),以及隔离截图测试的专属 xctestplan。
使用方式:生成前先做项目上下文与冲突检测(如已有 fastlane snapshot 会询问替换或增强)及本地化检测,再通过 AskUserQuestion 确认截图方式(纯 XCUITest / fastlane snapshot / 两者)、目标设备、语言、是否加边框与文案位置。典型运行:xcodebuild test -project YourApp.xcodeproj -scheme "YourAppUITests" -destination "platform=iOS Simulator,name=iPhone 16 Pro Max" -only-testing "YourAppUITests/ScreenshotUITests";完整流水线:swift ScreenshotAutomation/ScreenshotExportScript.swift;截图测试计划:xcodebuild test -testPlan "ScreenshotTests" ...。支持接入 Xcode Cloud、GitHub Actions 与 fastlane。
限制:未提供具体价格与授权信息;输出须为 PNG 且像素尺寸严格匹配设备档位,文件按字母顺序决定 App Store Connect 展示顺序;模拟器与真机渲染存在差异,状态栏需固定;macOS 截图会拍到真实桌面,需先运行准备脚本;截图测试较慢,不宜混入常规 Cmd+U 流程。