Android16之命令atrace用法实例(二百六十七)

简介：CSDN博客专家、《Android系统多媒体进阶实战》作者

博主新书推荐：《Android系统多媒体进阶实战》🚀
Android Audio工程师专栏地址：Audio工程师进阶系列【原创干货持续更新中……】🚀
Android多媒体专栏地址：多媒体系统工程师系列【原创干货持续更新中……】🚀
推荐1：AAOS车载系统+AOSP14系统攻城狮入门视频实战课🚀
推荐2：Android14 Binder之HIDL与AIDL通信实战课🚀
推荐3：Android15快速自定义与集成音效实战课🚀
推荐4：Android15音频策略实战课🚀

人生格言：人生从来没有捷径，只有行动才是治疗恐惧和懒惰的唯一良药.

🌻1. 前言

本篇目的：Android16之命令atrace用法实例

🌻2. Android16 atrace 系统跟踪命令顺序介绍

atrace是Android平台内置的系统级跟踪工具，最早随Jelly Bean引入，用于以几乎零开销的方式收集内核ftrace与用户空间trace事件。进入Android16后，atrace在AOSP build/envsetup.sh中被封装为可直接在主机端调用的shell函数，使开发者无需记忆复杂长命令即可对真机或模拟器进行性能剖析。工具首先依赖adb与设备端atrace可执行文件，当用户在主机终端输入atrace时，封装函数会顺序完成以下动作：自动检测连接设备、根据当前lunch目标选择对应root权限、向设备写入/sys/kernel/debug/tracing/events/目录下的可用事件掩码、配置环形缓冲区大小、启动跟踪、实时回显已捕获事件数量，并在用户按下Ctrl-C后拉取trace文件到主机标准输出或指定文件，随后自动关闭ftrace，恢复默认状态，保证对系统性能影响降到最低。

在内核层面，atrace顺序打开ftrace，通过trace_marker写入用户态事件，同时使能调度、irq、workqueue、ext4、gfx等预置标签；在用户态，它顺序绑定libutils的Trace类与atrace客户端，保证app层TRACE.begin/TRACE.end事件与内核事件时间戳一致。Android16新增顺序化缓冲区写入策略，避免高负载下事件乱序，同时支持按CPU分别回读，保证多核场景数据一致性。

主机端封装还提供顺序参数解析：先处理-c清理旧数据，再处理-t秒数、-b缓冲区KB、-o输出文件名，最后追加事件标签列表。顺序解析保证命令行简洁且向后兼容。开发者可在顺序调用lunch后，直接atrace -t 10 -b 4096 -o /tmp/boot.trace sched gfx view，即可在10秒内获得调度与图形绘制详情。

顺序化设计使atrace成为Android16性能调优的入口工具，可无缝衔接systrace.py、perfetto等后续可视化流程，为帧率、启动速度、内存抖动提供第一手数据。

🌻3. 代码实例

🌻3.1 收集10秒图形与输入事件

sourcebuild/envsetup.sh lunch aosp_x86_64 eng atrace-t10-b2048gfx input>/tmp/gfx.trace

输出
capturing trace…done, file pulled 845 KB

🌻3.2 查看冷启动阶段锁竞争

adb shell setprop debug.atrace.tags.enableflags 0x2D atrace-t5-acom.android.launcher3 sched freq>cold.trace

输出
trace written to cold.trace 1.3 MB

🌻3.3 持续抓取直至手动停止

atrace--async_start-b4096sched gfx view&&sleep30&&atrace--async_stop-olong.trace

输出
async trace stopped, written 5.7 MB

🌻3.4 atrace 命令总结