立项背景:移动游戏性能测试长期割裂——QA 用通用工具看 FPS、CPU、内存,Unity 开发再用 Profiler 定位卡顿;两段数据时间轴不一致、报告分散、接入门槛高,版本回归时复现和判断成本很大。为此立项 PerfLab,目标是一套本地优先、无需改包、系统指标与 Unity 引擎数据同源的 Windows 性能采集与分析工具。
核心功能:1)设备与应用:USB 设备发现、前台进程识别、断线恢复;2)通用监控:基于真实 ADB 输出采集 FPS、帧时间、Jank、CPU 双口径、PSS/RSS、电池、温度、截图与 Logcat;3)Unity 深析:导入 UPM Package 后,将 FrameTiming、ProfilerRecorder、场景/Marker、GC、渲染与对象快照同系统指标放入同一时基,提供概况、区间、CPU、渲染、内存、资源、硬件、自定义 8 个页签;4)报告与门禁:报告库、2 至 5 份报告对比、四态门禁,并支持用 5 至 10 份稳定报告做 Median/MAD 校准;5)CI:CLI 输出 JSON/JUnit,退出码 0/2/3 区分通过、性能失败与基础设施失败;6)交付:自包含安装器,目标电脑无需安装 .NET、ADB 或 Unity Editor。
业务流程/路径:连接设备 → 选择应用 → 采集预检 → 选择通用或 Unity 模式 → 实时曲线、Tag、截图 → 停止自动汇总 → 报告分析/对比 → 导出 .perflab 或接入 CI 门禁。
整体架构:本地优先的 Windows 单机架构。WPF + WebView2 桌面壳承载 React 工作区;ASP.NET Core 本地服务提供 37 个 REST 接口与 WebSocket,并调度共享采集核心;采集核心通过 adb shell / exec-out 读取设备真实指标;Unity UPM Package 以 TCP JSONL、经每设备独立 adb reverse 端口回传引擎数据;数据写入 SQLite WAL,附件按会话目录保存,最终打包为 .perflab 报告。
技术栈:后端 .NET 9 / C#(Minimal API、xUnit);前端 React + TypeScript + Vite + ECharts(Vitest、Playwright);存储 SQLite WAL + 1/5/30 秒聚合;设备端 Unity 2022.3 LTS+ C# Runtime;交付为自包含安装器,内置 .NET、ADB/aapt。
负责模块与结果:本人负责整体架构、核心模块开发与验收交付。完成 12 个 Preview 迭代,代码约 1.9 万行(后端与测试 1.25 万、前端 0.4 万、Unity Runtime 0.24 万),交付 37 个 API、8 个深析页签、170+ 项自动化测试和 25 份设计/验收文档;在 Samsung 真机与 Unity 2022.3.62f2 IL2CPP 环境完成验证,Runtime P95 主线程开销 0.87ms,4 小时 144FPS 长稳测试 207 万帧无截断。
难点与解决:1)各厂商 ADB 输出差异大,建立逐级降级的解析器与 source/quality 元数据,不可得指标显式 Unavailable,绝不补 0;2)采集命令耗时导致周期堆积,改为跳过过期周期并记录 skipped_schedule_count,避免把工具延迟误判为数据缺失;3)Unity IL2CPP 帧数据与系统时间轴难对齐,用设备单调时钟 + 服务端时钟校准统一时基,并以 adb reverse 自动重连保证恢复;4)大数据量报告首屏卡顿,改为服务端分页 + 前端虚拟化 + 曲线降采样(≤2000 点);5)现场排障信息不足,增加启动预检、逐指标覆盖率与脱敏诊断包。