ScreenshotNg

工具介绍

ScreenshotNg 是一个基于定制版 scrcpy 和 adb 的 Windows 桌面测试工具。程序会读取 Android SDK 配置，扫描已连接设备，在本地 screenshot 目录下按设备序列号和运行时间戳保存截图，并根据图片文件名中的毫秒时间戳计算开始图与结束图之间的时间差。代码明确实现了连续截图、额外点位截图、连续截图间隔下限校验、运行时长与结束缓冲配置、设备自动刷新、图片目录选择、坏图过滤、缩略预览、放大浏览、键盘切图、统计结果展示、CSV 保存会话和 Windows app-image 打包。CSV 文件保存在 screenshot/summary 下，文件名使用开始保存数据时的时间戳，并使用 UTF-8 BOM 便于 Excel 打开。它的数据来源是本地 adb/scrcpy 输出、本地截图文件和用户选择的起止图片；代码中未明确实现业务异常自动检测、云端接入、多用户协作或跨平台桌面运行能力。

核心能力

适用测试场景

• 在 Android 操作流程中按固定毫秒间隔连续截图，形成每次运行独立保存的画面时间线。
• 从截图序列中选择开始图和结束图，计算页面切换、动画完成或操作结束的时间差。
• 在一次测试会话中持续保存多组统计结果，自动写入按开始保存时间命名的 CSV 汇总文件。
• 通过缩略图、放大预览和上一张/下一张切换，辅助测试人员人工定位关键帧。
• 将工具打包为可双击启动的 Windows app-image，交付给本地测试人员直接使用。

环境与依赖

运行平台

Windows 桌面环境；被测对象为可通过 adb 连接的 Android 设备。

系统范围

代码中未明确限制 Windows 版本或 Android 系统版本。从源码重新打包时需要 JDK 21 或兼容版本；已打包的 Windows app-image 自带 Java 运行时。程序路径解析已使用 URI 方式，适配包含中文或空格的安装目录。

接入方式

主要通过 Windows GUI 可执行程序启动，也保留 Java 命令行入口用于传入设备序列号和截图间隔。

工具包

ScreenshotNg.rar

权限与依赖

• Android 设备需要开启 USB 调试，并完成 adb 授权。
• 需要可访问的 adb；程序会优先使用随 scrcpy-win64 打包的 adb，也会查找 Android SDK 路径下的 adb。
• 需要有效的 Android SDK 路径；程序读取 ANROID_SDK_ROOT、ANDROID_SDK_ROOT 或 ANDROID_HOME。
• 需要项目或打包目录中的 scrcpy-win64，包含 scrcpy 可执行文件和 scrcpy-server。
• 需要对应用根目录下的 screenshot 输出目录具备本地写入权限，包括截图目录和 screenshot/summary 统计汇总目录。
• 如需重新打包，需要 javac、jar 和 jpackage。

支持范围与说明

明确支持

• 代码明确实现 Swing GUI、Java 命令行入口、adb devices 设备列表读取和设备序列号选择。
• 代码明确实现连续截图间隔、额外点位截图次数、额外点位截图间隔、开始前准备、运行时长和结束缓冲等运行参数；GUI 默认连续截图间隔为 80ms，启用连续截图时要求间隔大于 40ms。
• 代码明确将截图输出到应用根目录下的 screenshot/<设备序列号>/<运行时间戳>/，连续截图优先使用 screenshot/<设备序列号>/<运行时间戳>/continual/。
• 代码明确从图片文件名开头数字解析毫秒时间戳，并计算结束图时间戳减开始图时间戳。
• 代码明确实现“开始保存数据”和“结束保存”，在 screenshot/summary 下创建 UTF-8 BOM CSV，并在每次统计成功后追加统计时间、设备序列号、图片目录、开始图片、结束图片、开始时间戳、结束时间戳、耗时(ms)和备注字段。
• 代码明确使用 URI 解析应用路径，使用 UTF-8 读写配置和 CSV，并在 scrcpy 未及时退出时进行强制结束兜底。
• build_exe.bat 明确使用 javac -encoding UTF-8、jar 和 jpackage 生成 Windows app-image，并复制 config.txt 与 scrcpy-win64。

合理推断

• 该工具适合页面加载、页面切换、动画完成和操作流程响应时间的人工取证、对比与结果汇总，但代码没有把这些场景定义为独立测试模式。
• 由于源码、README 和打包脚本都围绕 Windows、scrcpy-win64 与 app-image 展开，可合理判断 Windows 本地测试环境是主要交付目标。
• 异常检测范围主要限于路径、参数、设备连接、adb/scrcpy 可用性、图片文件名解析、坏图过滤和 CSV 写入错误提示；代码中未体现业务异常或视觉异常的自动检测。

• 能力边界清晰，聚焦 Android 截图取证、关键帧选择、时间差统计和本地 CSV 记录，不包装成通用测试平台。
• 每次运行创建独立时间戳目录，连续截图保存在该运行目录下的 continual 子目录，便于回溯单次测试过程。
• 截图文件名以毫秒时间戳为统计依据，图片列表会过滤 0 字节、非时间戳命名和不可读取的默认关键帧候选。
• 内置设备发现、SDK 路径设置、截图参数配置、日志显示、图片预览和 CSV 保存会话，减少手动执行 adb/scrcpy 命令与手工填写统计表的步骤。

下载与使用说明

工具包

RAR

大小

56.2 MB

更新时间

2026-05-22

下载

登录后下载

工具以本地运行和真实 QA 工作流为前提设计，适合安卓 App 专项测试，不依赖外部测试平台。

下载 RAR