第3章：抓取SystemUI动画trace的环境准备

3.1 现象识别：什么情况需要抓取SystemUI动画trace？

当设备上出现以下掉帧现象时，应启动trace采集流程：

• 锁屏/解锁动画出现明显卡顿、跳帧
• 通知栏下拉回弹不跟手，帧率低于30fps
• 快速切换最近任务时界面撕裂或黑屏瞬间
• 壁纸缩放、过渡动画出现断续或白色闪块

掉帧阈值判断规则（可通过dumpsys gfxinfo或systrace确认）：

3.2 数据采集：抓取SystemUI动画trace的完整环境清单

3.2.1 手机root要求

虽然atrace基础功能无需root，但捕获SystemUI的图形流水线细节（如hwc、surfaceflinger）以及长时间高频率trace需要root权限。推荐两种方案：

3.2.2 adb命令环境

最低adb版本要求：1.0.41（可通过adb version检查）。建议使用最新Platform Tools。关键命令清单：

# 检查设备是否识别
adb devices -l

# 若为root设备，获取root shell
adb root
adb shell

# 查看SystemUI进程是否存活
adb shell ps -ef | grep systemui

# 验证atrace可用性（非root用户也能运行基础版本）
adb shell atrace --list_categories

3.2.3 开启atrace标签

SystemUI动画掉帧涉及的核心atrace标签及作用：

开启标签的命令示例（root环境）：

adb shell atrace -b 32768 gfx input view hwc sched freq -t 10 -o /data/local/tmp/animation_trace.html

3.2.4 设置缓冲区大小

SystemUI动画通常持续1~3秒，但涉及高频信号（VSync、surfaceflinger事件），缓冲区不足会导致trace被截断，丢失关键帧。推荐缓冲区大小（-b参数）按场景调整：

若trace文件中出现buffer overflow或truncated提示，请立即增大缓冲区至64MB或以上。

3.3 环境准备完整流程图

3.4 原因定位：环境准备常见失败检查表

当trace采集失败或数据异常时，按以下排查表逐一验证：

3.5 修复动作与复测

根据排查表修复后，执行复测脚本验证环境：

#!/system/bin/sh
# 复测环境准备脚本（在adb shell中执行）
echo "=== 1. 检查进程 ==="
ps -A | grep -E "systemui|surfaceflinger" | wc -l
echo "=== 2. 检查root权限 ==="
id
echo "=== 3. 测试atrace基础标签 ==="
atrace -b 8192 gfx view -t 2 -o /dev/null && echo "atrace OK"
echo "=== 4. 检查输出路径可写 ==="
touch /data/local/tmp/test_trace.html && rm /data/local/tmp/test_trace.html && echo "路径可写"

若以上全部通过，则环境准备完成，可进入下一章“trace采集命令实战”。

3.6 预防：环境标准化

• 为团队所有测试机固定编译userdebug版本，避免root兼容问题
• 将常用atrace命令封装为脚本（如get_sysui_trace.sh），内置最佳标签和缓冲区
• 在新设备接入时，运行本章复测脚本，通过后方可用于性能测试
• 建立“环境准备检查单”，纳入CI/CD流程