1. 卡顿与耗电调优核心指标：帧率、卡顿率、电池容量消耗、工具链总览

1.1 为什么必须先定义核心指标

在调优工作启动前，必须将“卡顿”和“耗电”量化为可复现、可对比的数值。主观感受无法作为优化依据，只有帧率、卡顿率、电池容量消耗这三大指标，才能支撑A/B测试与回归验证。本章逐一拆解它们的定义、采集手段与工具链全景。

1.2 核心指标详解

1.3 帧率与卡顿率的深度辨析

帧率平均值并不代表体验良好——60fps 平均帧率下可能掩盖大量卡顿。必须同时观测 帧时间（Frame Time） 分布。以下命令可直接采集单帧耗时分布：

# 输出最近 120 帧的绘制时间（单位 ms）
adb shell dumpsys gfxinfo <package> framestats

# 解析 pipeline 阶段耗时
adb shell dumpsys gfxinfo <package> framestats | grep "PROFILE_DATA"

1.4 电池容量消耗的精确测量方法

应使用 BatteryHistorian 导出电量轨迹，而非依赖系统中“设定→电池”的模糊百分比。采集步骤：

1. 重置电量统计：adb shell dumpsys batterystats --reset
2. 开始测试场景（例如：连续滑动列表 5 分钟）。
3. 导出原始数据：adb bugreport bugreport.zip
4. 上传至 https://bathist.com 或本地部署 BatteryHistorian 解析。

1.5 工具链总览框架

调优工具链分为监控层、分析层、优化层。下图展示核心工具及其协作关系：

1.6 工具链快速入门命令

以下是最简命令集，建议每周进行至少一次基线采集：

# 帧率与卡顿率（需在测试前后分别执行）
adb shell dumpsys gfxinfo <package> | grep "Total frames rendered"

# 电池电流（需 root 或基于 BatteryHistorian）
adb shell dumpsys batterystats --charged <package>

# 录制 Systrace（分析长卡顿）
adb shell atrace --async_start -b 2048 gfx input view sched freq
# 操作后停止
adb shell atrace --async_dump > trace_output.systrace

# JankStats 集成（Kotlin 代码内）
# 在 Application 或 Activity 中初始化 JankStats 并回调统计

1.7 常见误区与调优起点

• 误区1：只优化 FPS 平均值，忽略帧率抖动（Frame Jitter）。
  正确做法：同时关注 P95 帧时间和卡顿帧占比。
• 误区2：将电池消耗完全归咎于屏幕亮度或网络，忽略 App 后台唤醒锁。
  正确做法：使用 adb shell dumpsys batterystats --unplug 查看各组件消耗排行。
• 误区3：在 USB 连接状态下测性能。
  必须断开数据线（或使用无线 ADB），否则充电电流会严重干扰耗电数据。