前言：虽然有翻译软件，虽然有chatgpt,毕竟语言隔阂，对这个工具还是一知半解，因此想通过翻译的方式和大家来一起学习下Perfetto这个强大的工具
#####################以下分割线#####################
英文原文在这里
Perfetto可以从各种数据源（通过ftrace的内核调度程序、通过atrace的用户空间instrumentation以及本网站中列出的所有其他数据源）收集安卓设备的系统范围性能trace。
开启tracing service
Perfetto基于自Android 9（P）以来的系统service，但默认情况下仅自Android 11（R）以来启用。在Android 9（P）和10（Q）上，您需要执行以下操作，以确保在开始之前开启tracing service：
# Needed only on Android 9 (P) and 10 (Q) on non-Pixel phones.
adb shell setprop persist.traced.enable 1
如果Android版本早于P，您仍然可以使用record_Android_trace脚本使用Perfetto来抓取trace。请参阅下面通过cmdline抓取trace的说明。
抓取trace
命令行工具
1 使用 tools/record_android_trace 直接抓取
2 直接使用 /system/bin/perfetto 命令抓取参考这里
可视化抓取工具
1 通过Perfetto UI的抓取界面
2 使用设备上的System Tracing App
使用Perfetto UI抓取trace
打开ui.perfetto.dev这个网址，然后从左侧菜单中选择Record new trace。在此页面中，选择并打开需要trace的数据源。有关不同数据源的更多详细信息，请参阅文档的数据源部分。
如果不确定抓取数据源，请先打开“CPU”选项卡下的“调度详细信息”。
首先需要确保设备已连接，然后选择“添加ADB设备”。一旦设备成功配对（可能需要允许在设备上进行USB调试），请点击“开始录制”按钮。
等待trace抓取完成（默认为10秒），然后就可以看到trace出现。
如果选择的数据源不同，收集到的trace也会不一样。
使用命令行抓取trace
前提
通过命令行抓取，需要系统变量Path中包含了adb可执行文件的路径。适用于Linux、Mac或Windows的ADB二进制文件可以从https://developer.android.com/studio/releases/platform-tools这里下载。
使用helper脚本
我们建议使用tools/record_android_trace 这个脚本从命令行记录跟踪。这相当于运行adb shell perfetto，但它有助于获得正确的路径，完成后拉取trace并在浏览器上打开它。此外，在旧版本的Android上，它负责sideloading tracebox二进制文件，以弥补tracing系统服务的不足。
如果您已经熟悉systrace或atrace，那么这两个cmdline工具都支持与systrace等效的语法：
Linux 和 Mac:
curl -O https://raw.githubusercontent.com/google/perfetto/master/tools/record_android_trace
chmod u+x record_android_trace
# See ./record_android_trace --help for more
./record_android_trace -o trace_file.perfetto-trace -t 10s -b 32mb \
sched freq idle am wm gfx view binder_driver hal dalvik camera input res memory
Windows
curl -O https://raw.githubusercontent.com/google/perfetto/master/tools/record_android_trace
python3 record_android_trace -o trace_file.perfetto-trace -t 10s -b 32mb \
sched freq idle am wm gfx view binder_driver hal dalvik camera input res memory
使用设备上的/system/bin/perfetto命令
如果你想直接直接设备上的perfetto命令
adb shell perfetto -o /data/misc/perfetto-traces/trace_file.perfetto-trace -t 20s \
sched freq idle am wm gfx view binder_driver hal dalvik camera input res memory
直接使用adb shell perfetto的注意事项：
Ctrl+C通常会导致trace的终止，但在使用ADB shell perfetto时，ADB一般不会响应Ctrl+C，只在使用 PTY-based 的交互式会话时相应Ctrl+C
1 在安卓12之前的非root设备上，由于SELinux规则过于严格，配置只能作为cat config|adb shell perfetto-c（-：stdin）的方式传递。在Android 12上/data/misc/perfetto-configs可以用于存储配置。
2 在Android 10之前的设备上，adb无法直接提取/data/misc/perfetto-traces。使用adb-shell cat/data/misc/perfetto-traces/trace>trace将perfetto-traces从手机上复制出来。
3 当捕获较长的traces时，例如在基准测试或CI的上下文中，使用PID=PID来停止。
Full trace config
简单的命令仅启用部分数据源；要完全控制trace的配置，请在输入中传递完整的trace配置。
有关如何配置Perfetto的所有各种选项的详细说明，请参阅trace 配置界面和每个数据源文档页面中的示例。
如果在Mac或Linux主机上运行，或者在Windows上使用基于bash的终端，则可以使用以下方法：
提示：以下的命令参数在Android P是不能运行的，因为--txt 参数是Android Q版本引入的。在Android P上应该使用protobuf 格式的二进制格式。详细信息在trace 配置界面
cat<<EOF>config.pbtx
duration_ms: 10000
buffers: {
size_kb: 8960
fill_policy: DISCARD
}
buffers: {
size_kb: 1280
fill_policy: DISCARD
}
data_sources: {
config {
name: "linux.ftrace"
ftrace_config {
ftrace_events: "sched/sched_switch"
ftrace_events: "power/suspend_resume"
ftrace_events: "sched/sched_process_exit"
ftrace_events: "sched/sched_process_free"
ftrace_events: "task/task_newtask"
ftrace_events: "task/task_rename"
ftrace_events: "ftrace/print"
atrace_categories: "gfx"
atrace_categories: "view"
atrace_categories: "webview"
atrace_categories: "camera"
atrace_categories: "dalvik"
atrace_categories: "power"
}
}
}
data_sources: {
config {
name: "linux.process_stats"
target_buffer: 1
process_stats_config {
scan_all_processes_on_start: true
}
}
}
EOF
./record_android_trace -c config.pbtx -o trace_file.perfetto-trace
如果直接在设备上使用perfetto命令
cat config.pbtx | adb shell perfetto -c - --txt -o /data/misc/perfetto-traces/trace.perfetto-trace
也可以先推送config 文件，再执行perfetto命令
adb push config.pbtx /data/local/tmp/config.pbtx
adb shell 'cat /data/local/tmp/config.pbtx | perfetto --txt -c - -o /data/misc/perfetto-traces/trace.perfetto-trace'
提示：由于严格的SELinux规则，在Android的非root版本上，直接将文件路径传递为-c/data/local/tmp/config将失败，因此上面使用了-c-+stdin管道。在Android 12（S）中，可以使用/data/misc/perfetto-configs/。
然后使用adb pull /data/misc/perfetto-traces/trace ~/trace.perfetto-trace 命令从手机上拷贝出来，最后在Perfetto UI界面打开。
完整的perfetto命令行参数可以在这里找到
#####################以上分割线#####################
后记：
1 本次主要使用百度翻译，虽然被骂，但至少翻译这个工具降低了门槛。
2 英文文档中的长难句真的是又长又难，基于百度的翻译，然后自己再调整下，水平实在有限。
3 技术背景知识不够，有些专有名词不知道怎么翻译，也不知道百度翻译的是否准确，功夫在诗外。
4 万事开头难，中间难不难，还不知道。中间的事后面再说，正确一天翻译一篇。
5 虽然可能会有人不屑，但总要有人去做不起眼的小事。
6 google 厉害，这个perfetto 工具也很厉害。君子善假于物也。
7 工具的使用是最简单的入门，背后还有更多的东西值得学习。
8 水平实在有限，闻过则喜，希望有更多的人反馈，期待更好的建议
