1. 项目概述：从“抓个trace”到“精准性能剖析”

在Android应用和系统性能优化的日常工作中，我们经常会遇到一些“玄学”问题：应用启动时偶尔会卡顿一下，滑动列表时掉帧，或者某个后台服务莫名消耗了大量CPU。面对这些难以稳定复现的性能瓶颈，光靠代码Review和打点日志往往力不从心。这时，一个强大的工具就显得至关重要——systemtrace（系统跟踪）。它就像是给Android系统做的一次“全身CT扫描”，能够以极细的粒度记录下CPU调度、线程活动、渲染流水线、磁盘I/O等关键事件。

然而，很多开发者对systemtrace的认知还停留在Android Studio的图形化界面操作上。图形化工具固然直观，但在自动化测试、持续集成、远程调试或者资源受限的服务器环境中，就显得捉襟见肘。这时，adb shell命令行就成了我们手中的“手术刀”。通过adb shell直接捕获systemtrace，意味着我们可以将性能剖析无缝集成到自动化流程中，可以在任何有adb连接的环境下（包括真机、模拟器甚至嵌入式设备）快速抓取性能数据，并且能够通过脚本对抓取过程进行精细控制。

这个项目的核心，就是深入探索如何通过adb shell命令，高效、精准地捕获和分析systemtrace数据。这不仅仅是记住几个命令那么简单，它涉及到对Android性能体系的理解、对perfetto/systrace工具的掌握，以及对命令行参数背后意义的洞察。掌握了这项技能，你就能在性能攻坚战中，从被动猜测变为主动取证。

2. 核心工具链与原理浅析

在动手之前，我们需要理清Android性能跟踪工具的演进和当前的核心工具链。早期的systrace（一个Python脚本）曾是我们的主力，但它正逐渐被功能更强大、架构更现代的Perfetto所取代。Perfetto是Google推出的下一代系统级性能检测和跟踪框架，它不仅能做systrace能做的所有事，还支持更长的跟踪时间、更多的数据源（如内存、电量、网络）以及更强大的SQL查询分析能力。

2.1 Perfetto与Systrace的关系

你可以把Perfetto看作一个强大的“数据收集与存储引擎”，而systrace是它的一种“数据呈现视图”。当我们通过命令行捕获systemtrace时，底层调用的已经是Perfetto的组件了。adb shell中与跟踪相关的命令也主要围绕perfetto展开。

关键命令：adb shell perfetto这是最核心的命令。它通过一个配置文件（protobuf文本格式）来定义要捕获哪些数据源（data sources），跟踪多长时间，以及如何输出。

为什么是配置文件而不是一堆参数？因为一次完整的性能剖析可能需要同时监听CPU频率、GPU活动、内核函数调用、应用层函数跟踪（atrace）等数十种数据源。通过一个结构化的配置文件，可以清晰、灵活地定义复杂的跟踪方案，并且这个配置可以保存、复用和版本化管理。

2.2 理解跟踪配置文件

一个最基本的跟踪配置文件大概长这样：

buffers: { size_kb: 10240 fill_policy: DISCARD } data_sources: { config { name: "linux.ftrace" ftrace_config { ftrace_events: "sched/sched_switch" ftrace_events: "sched/sched_wakeup" ftrace_events: "irq/irq_handler_entry" ftrace_events: "power/cpu_frequency" atrace_categories: "gfx" atrace_categories: "view" atrace_categories: "webview" atrace_categories: "sched" } } } duration_ms: 5000

我们来拆解一下：

• buffers: 定义内存缓冲区大小。跟踪事件会先写入这里。size_kb建议根据跟踪时长和事件密度设置，太大会浪费内存，太小会导致事件丢失（如果配置了DISCARD策略）。对于5-10秒的跟踪，10240 KB（10MB）通常是个安全的起点。
• data_sources: 定义数据来源。linux.ftrace是最重要的一个，它通过Linux内核的ftrace机制捕获底层事件。
  • ftrace_events: 指定要收集的内核事件，如进程调度（sched_switch）、CPU频率变化等。
  • atrace_categories: 指定要收集的Android应用层跟踪类别，如gfx（图形）、view（视图系统）、webview等。这是分析应用卡顿的关键。
• duration_ms: 跟踪的持续时间，单位毫秒。

注意：手动编写protobuf配置比较繁琐。更常见的做法是在开发机上使用perfetto命令行工具生成配置，或者参考Android源码中的预定义配置。一个快速获取包含常用类别的配置的方法是使用adb shell perfetto --query查看可用数据源，但直接手写容易出错。

3. 实战：通过ADB Shell捕获Trace的完整流程

理论铺垫完毕，我们进入实战环节。我将以一个最常见的场景为例：抓取一个包含图形渲染和调度信息的5秒trace，用于分析界面卡顿。

3.1 第一步：准备配置文件

我们不在设备上手动编写配置，而是利用主机上的perfetto工具生成一个标准配置，然后推送到设备上。这是最可靠的方式。

首先，在你的开发机（Windows/Mac/Linux）上，确保有perfetto工具。如果你有Android SDK，它可能在platform-tools/目录下，或者你可以从 Perfetto官网 下载独立的可执行文件。

打开终端，执行以下命令生成一个配置文件：

# 生成一个基础的配置文件，保存到当前目录的`config.pbtx` perfetto --txt -c - -o config.pbtx <<EOF buffers: { size_kb: 10240 } data_sources: { config { name: "linux.ftrace" ftrace_config { ftrace_events: "sched/sched_switch" ftrace_events: "sched/sched_wakeup" ftrace_events: "power/cpu_frequency" ftrace_events: "cpu/cpu_idle" atrace_categories: "gfx" atrace_categories: "view" atrace_categories: "input" atrace_categories: "webview" atrace_categories: "sched" } } } duration_ms: 5000 EOF

这个命令创建了一个名为config.pbtx的文件，它定义了跟踪内核调度、CPU状态以及Android图形、视图、输入等关键事件，持续5秒。

3.2 第二步：将配置推送到设备并执行跟踪

接下来，通过adb将配置文件推送到设备的临时目录，然后使用adb shell perfetto命令启动跟踪。

# 将配置文件推送到设备 adb push config.pbtx /data/local/tmp/trace_config.pbtx # 在设备上执行跟踪，结果输出到`/data/local/tmp/trace.perfetto-trace` adb shell perfetto -c /data/local/tmp/trace_config.pbtx -o /data/local/tmp/trace.perfetto-trace

执行第二条命令后，终端会挂起，直到5秒的跟踪完成。完成后，你会在设备的/data/local/tmp/目录下得到一个trace.perfetto-trace文件。

实操心得：

• 输出路径权限：确保输出路径设备可写。/data/local/tmp/是通常安全的选择。
• 后台运行：如果你希望命令立即返回并在后台执行跟踪，可以在命令末尾加上&，但你需要用其他方法（如等待一段时间后拉取文件）来确定跟踪是否完成。对于自动化脚本，更推荐使用timeout命令或判断文件大小是否不再增长。
• 指定进程：如果只想跟踪特定应用，可以在ftrace_config中添加atrace_apps: "com.example.myapp"。这能显著减少trace文件大小，聚焦分析目标。

3.3 第三步：拉取Trace文件并分析

跟踪完成后，将结果文件拉取到本地进行分析。

adb pull /data/local/tmp/trace.perfetto-trace .

现在，你可以用强大的Perfetto UI（ ui.perfetto.dev ）打开这个.perfetto-trace文件。直接在浏览器中打开该网站，点击"Open trace file"按钮，选择你刚拉取的文件即可。

在Perfetto UI中，你可以：

1. 查看CPU频率和利用率：确认跟踪期间是否有CPU降频或满载。
2. 分析线程状态：查看关键线程（如UI线程、RenderThread）是处于运行（R）、可运行（R+）还是休眠（S）状态，找到阻塞点。
3. 检查渲染帧：在“Counters”轨道或“Android Frame Timeline”中，查看每一帧的耗时，是否超过16.6ms（60Hz屏幕）的阈值，定位掉帧帧。
4. 查看函数调用：如果启用了atrace标签，你可以看到应用代码中Trace.beginSection()标记的区间，这对于定位自定义代码块的性能问题非常有用。

4. 高级技巧与参数详解

掌握了基础流程后，我们可以探索一些更高级的用法，让性能抓取更具针对性。

4.1 触发式跟踪与脚本集成

很多时候，我们不想盲目地跟踪一段时间，而是希望在发生特定事件（如点击某个按钮、进入某个页面）时开始和停止跟踪。这可以通过adb shell发送信号来实现。

Perfetto支持通过--background和--stop参数进行后台触发式跟踪。

# 1. 启动一个后台跟踪会话，并获取其PID adb shell perfetto -c /data/local/tmp/trace_config.pbtx -o /data/local/tmp/trace.perfetto-trace --background # 命令会输出类似：`Started tracing with session ID: 12345` # 记下这个ID或进程PID。 # 2. 执行你的测试场景，例如启动一个Activity adb shell am start -n com.example.myapp/.MainActivity # 3. 手动触发停止跟踪（假设会话ID是12345） adb shell perfetto --stop 12345

在自动化测试脚本中，你可以将启动跟踪、执行测试用例、停止跟踪的步骤串联起来，为每个测试用例生成独立的性能报告。

4.2 扩展数据源：内存与电量

Perfetto的强大之处在于其模块化数据源。除了ftrace，你还可以轻松添加内存和电量信息。

修改你的配置文件，在data_sources列表中添加：

data_sources: { config { name: "linux.process_stats" # 进程级内存和线程统计 } } data_sources: { config { name: "android.power" # Android电源管理事件（需要设备支持） } }

添加linux.process_stats后，你可以在Perfetto UI中看到每个进程的RSS内存、线程数随时间的变化曲线，对于分析内存泄漏或线程爆炸问题非常有帮助。

4.3 调整缓冲区与避免丢包

在跟踪高负载场景（如快速滑动、游戏）时，事件产生速率极快，如果缓冲区太小或写满策略不当，会导致事件丢失，trace中出现令人困惑的断层。

• 策略：fill_policy默认为DISCARD（写满后丢弃新事件）。对于不能丢失关键事件的场景，可以设置为RING_BUFFER（环形缓冲区，覆盖旧事件），但这可能导致时间线不连续。更好的办法是增大size_kb。
• 估算大小：一个粗略的估算方法是，每秒每个CPU核心可能产生数万到数十万事件。一个包含gfx、view等类别的5秒跟踪，在旗舰机上，设置size_kb: 51200（50MB）也不为过。如果设备存储空间紧张，可以先从小缓冲区开始，观察trace文件末尾是否有[丢失事件]的警告，再逐步调大。
• 输出格式：-o指定的输出文件格式是二进制的Perfetto Trace格式。你也可以通过--txt参数输出为文本格式，但文件会巨大，一般只用于调试配置本身。

5. 常见问题排查与实战心得

即使按照步骤操作，你也可能会遇到一些问题。这里记录了一些典型的坑和解决方法。

5.1 权限问题与SELinux

问题：执行adb shell perfetto命令时，提示Permission denied，或者跟踪文件生成失败。排查：

1. 输出路径：确保输出目录可写。/data/local/tmp/通常没问题。不要尝试写到/sdcard/根目录，某些应用权限受限。
2. SELinux上下文：在严格SELinux策略的设备上，perfetto进程可能没有权限访问某些ftrace事件或写入特定位置。错误日志中可能会看到avc: denied。
   • 临时解决：对于调试设备，可以临时将SELinux设置为宽容模式：adb shell setenforce 0。注意，生产环境或安全测试中切勿这样做。
   • 根本解决：需要定制SELinux策略，这通常涉及设备系统源码的修改。

5.2 Trace文件为空或过小

问题：拉取下来的trace文件只有几KB，在Perfetto UI中打开几乎没内容。排查：

1. 配置错误：检查配置文件语法，特别是data_sources的名称和atrace_categories的拼写。一个错误的类别名会导致整个数据源收集不到数据。使用adb shell perfetto --query可以列出设备支持的所有数据源和类别。
2. 跟踪未实际开始：确认adb shell perfetto命令执行后，是否等待了足够的时长（由duration_ms指定）。如果命令立即退出，可能是配置解析失败，检查命令输出是否有错误信息。
3. Atrace类别未生效：atrace_categories依赖于目标应用或系统服务是否启用了对应的跟踪点。如果应用是Release版本且未包含调试信息，部分view或自定义跟踪点可能无效。可以尝试先通过adb shell atrace --list_categories查看可用类别，并确保你的应用在debuggable模式下运行以获取最全信息。

5.3 在自动化脚本中的稳定性处理

在CI/CD流水线中自动抓取trace，需要更高的稳定性。

#!/bin/bash # 一个简单的自动化抓取脚本示例 CONFIG_FILE="config.pbtx" DEVICE_PATH="/data/local/tmp/trace_config.pbtx" OUTPUT_PATH="/data/local/tmp/auto_trace.perfetto-trace" LOCAL_OUTPUT="trace_$(date +%Y%m%d_%H%M%S).perfetto-trace" # 1. 推送配置 adb push "$CONFIG_FILE" "$DEVICE_PATH" if [ $? -ne 0 ]; then echo "推送配置文件失败" exit 1 fi # 2. 启动跟踪（设置超时，避免命令挂死） timeout 15 adb shell perfetto -c "$DEVICE_PATH" -o "$OUTPUT_PATH" TRACE_EXIT_CODE=$? # 3. 检查跟踪是否正常结束 if [ $TRACE_EXIT_CODE -eq 124 ]; then echo "跟踪命令超时，可能仍在进行或已挂起。尝试强制停止并拉取已有数据。" # 可以尝试查找并kill perfetto进程 # adb shell pkill -f perfetto elif [ $TRACE_EXIT_CODE -ne 0 ]; then echo "跟踪命令执行失败，退出码: $TRACE_EXIT_CODE" exit 1 fi # 4. 拉取文件并检查大小 adb pull "$OUTPUT_PATH" "$LOCAL_OUTPUT" FILE_SIZE=$(stat -f%z "$LOCAL_OUTPUT" 2>/dev/null || stat -c%s "$LOCAL_OUTPUT" 2>/dev/null) if [ ! -f "$LOCAL_OUTPUT" ] || [ "$FILE_SIZE" -lt 10240 ]; then # 小于10KB认为可能无效 echo "警告：Trace文件过小（${FILE_SIZE}字节），可能未捕获到有效数据。" # 可以在这里加入重试逻辑 fi echo "Trace抓取完成，文件: $LOCAL_OUTPUT"

心得：在脚本中，一定要检查每一步的返回状态，并对输出文件做基本验证（如文件存在性和最小大小）。对于超时情况，要有清理机制，避免残留的perfetto进程占用资源。

5.4 解析与分享的便捷技巧

抓到的trace文件可能很大（几十到几百MB），直接分享给同事不方便。Perfetto UI提供了压缩和分享功能。

1. 打开Trace后，在Perfetto UI右上角点击“Share”按钮。
2. 它会将trace文件上传到Google的临时存储（请注意隐私，敏感数据勿用），并生成一个短链接。
3. 任何人用浏览器打开这个链接，都能直接在线查看和分析这个trace，无需下载原始文件。

对于内部团队，可以搭建一个本地的Perfetto Trace处理器服务，实现更安全、快速的内部分享和归档。

从图形化工具依赖到命令行精准掌控，通过adb shell捕获systemtrace这项技能，将Android性能分析的能力从开发桌面延伸到了整个研发流程的每一个环节。它让性能测试自动化成为可能，让问题定位不再依赖特定IDE环境，也让深度性能剖析的门槛降低了许多。最关键的是，它培养了一种“数据驱动”的性能优化思维——遇到问题，先抓个trace看看，让数据说话，而不是凭空猜想。