2. Profiler工具链选型与配置：Android Studio Profiler、Systrace、Perfetto、自定义Trace标记

性能评估并非黑盒猜谜。对 Material 3 组件进行精确分析，需要正确的观察方式。本章将建立一套完整的 Profiler 工具链，涵盖从快速预览到深度系统级追踪的选型策略，并手把手配置自定义 Trace 标记，让每一帧卡顿、每一次重排都无所遁形。

2.1 工具链全景：什么场景用什么“刀”

Android 平台提供了多个层次的性能分析工具，三者之间是互补而非替代关系。下表给出了选型决策的核心依据：

2.2 原理：追踪数据从何处来，往何处去

无论使用哪个 UI 工具，底层数据源都来自 ftrace（内核跟踪事件）和 atrace（Android 用户空间标记）。Perfetto 统一了这两个通道，并额外支持插入自定义 Trace 事件。

• 内核层： Scheduling、IRQ、CPU Frequency 等通过 ftrace 写入 ring buffer。
• 用户层： 应用通过 android.os.Trace 或 Perfetto SDK 写入 trace_events。
• 数据桥接： Perfetto 后台进程 traced 将两类数据合并成一条时间线。

一张架构图可以清晰呈现四者之间的协作关系：

2.3 实现流程：搭建基础监控框架

1. 集成自定义 Trace — 在待分析组件的方法首尾添加标记。
2. 配置 Perfetto 或 Systrace 抓取规则 — 决定录制时长、缓冲区大小、额外数据源。
3. 开启录制 — 通过命令行或 AS Profiler 启动。
4. 重现或自动交互 — 引导应用触发目标组件渲染。
5. 停止录制并收集 trace 文件。
6. 加载到可视化工具 — Perfetto UI 或 Systrace HTML 进行时间线分析。
7. 查看自定义 Trace 范围 — 定位耗时异常区。

2.4 配置与代码：从 Gradle 到 ADB 命令

2.4.1 在 Gradle 中启用 Tracing

// app/build.gradle.kts
android {
    buildTypes {
        debug {
            // 务必在 debug 构建中开启详细追踪
            isDebuggable = true
        }
    }
}

// 无需额外依赖，Trace API 存在于 framework 中

2.4.2 自定义 Trace 标记——核心 API

在 Material 3 组件的关键方法内插入标记。以下示例对 AdvancedComposable 的 Measure 阶段进行计时：

import android.os.Trace

// 在 Compose 组合函数中
@Composable
fun AppTheme(content: @Composable () -> Unit) {
    Trace.beginSection("AppTheme_Composition")
    // ... 主题构建逻辑
    Trace.endSection()
}

class MyCustomButtonModifier : Modifier.Element {
    override fun MeasureScope.measure(
        measurable: Measurable,
        constraints: Constraints
    ): MeasureResult {
        Trace.beginSection("MyCustomButton_onMeasure")
        val result = measurable.measure(constraints)
        Trace.endSection()
        return result
    }
}

2.4.3 Perfetto 命令行抓取示例

# 1. 确认设备连接 & 支持 Perfetto (API 28+)
adb shell perfetto --version

# 2. 定义 Trace 配置（至少 5 秒，包含调度和自定义标记）
adb shell perfetto \
  -o /data/misc/perfetto-traces/comp_trace.perfetto-trace \
  -t 5s \
  sched freq idle am wm gfx view \
  --app com.your.app.package

# 3. 拉取 trace 文件到本地
adb pull /data/misc/perfetto-traces/comp_trace.perfetto-trace

# 4. 访问 https://ui.perfetto.dev 并打开该文件

2.4.4 兼容性选项：Systrace 命令（仅限旧设备 Android 9 及以下）

# 录制 5 秒，捕获 gfx、view、wm 等类别
python $ANDROID_HOME/platform-tools/systrace/systrace.py \
  -t 5 \
  gfx view wm am ss sched freq \
  -o systrace_output.html

2.5 调试：验证 Trace 点是否生效

打开抓取到的 Perfetto trace，在搜索栏输入自定义标记名称的前缀，例如 "MyCustomButton"。如果看到对应的切片出现在时间线上，说明标记已正确插入。常见失效原因：

• 未指定 --app 参数，导致 Perfetto 未监听目标应用的 Category。
• 二进制权限问题：trace_marker 需要 GROUP_SYSTEM 级别的权限，普通用户进程在 debug 构建中自动获得。
• 重入导致死锁：在 Trace 标记内部调用了导致重入的方法（如启动新线程并立即等待），会造成 Trace 范围混乱。

2.6 部署：将 Profiler 配置加入组件库发布流程

1. 在 CI/CD 中增加 性能门控（Performance Gate） 步骤。每次合入 MR 前，自动运行一组基准 UI 测试并收集 Perfetto trace。
2. 通过 Perfetto SQL 查询自动解析自定义 Trace 标记的耗时，与基线对比。
3. 若某个标记的 P95 分位数超出阈值（例如 onDraw > 16ms），则阻止合并。

# 示例：SQL 查询提取自定义 Trace 耗时
-- 使用 Perfetto SQL shell
SELECT
    name,
    dur / 1e6 AS duration_ms
FROM slice
WHERE name GLOB '*MyCustomButton*'
ORDER BY dur DESC LIMIT 10;

2.7 常见错误与避坑清单

2.8 性能与稳定性优化：基于 Trace 的反向优化

工具永远为优化服务。当从自定义 Trace 中发现某 Material 3 组件的 Layout 执行频繁且耗时占比高时，反向推导优化动作：

1. 减少不必要的重组： 是否因为使用了链式 Lambda 导致 Stable 注解失效？添加 @Stable 到状态持有类。
2. 缓存昂贵的计算： remember 在自定义 Modifier 中缓存 Shape 和 Brush 的构造。
3. 异步化非 UI 工作： 把 measure 期间不必须的自定义 Parcelable 序列化移出主线程。