用途:在 IntelliJ / Android Studio 中调查 Jetpack Compose 重组问题。Cascade 回答“改动这个 composable 会牵连什么”,Heatmap 回答“某次滚动或动画中哪个 composable 重组最热”。两者位于同一插件的 Compose Stability Analyzer 工具窗口,含 Explorer、Cascade、Heatmap 三个标签页。
主要能力:Cascade 从光标所在 @Composable 出发,沿静态调用图向下展开,最大深度 10 层,用已访问集合做环检测,每个节点带稳定性徽章,双击可跳转源码。Heatmap 通过 ADB 订阅 logcat 标签 Recomposition,在已插桩的 composable 上方显示重组计数与热度配色内联块,点击可聚焦事件历史,悬停显示 5 秒提示。
使用方式:Cascade 需光标位于 @Composable 内,右键选择 Analyze Recomposition Cascade。Heatmap 需先用 @TraceRecomposition 注解目标 composable,连接设备并运行应用,确认 logcat 出现 D/Recomposition 行,再右键 Toggle Recomposition Heatmap;插件执行 adb logcat -s Recomposition:D -T 1。可用 Clear Recomposition Data 重置计数。
限制:Cascade 是静态估算,不代表运行时一定重组,需用 Heatmap 确认。Heatmap 会带来 logcat I/O 与 PSI 开销,运行 Macrobenchmark 或生成 Baseline Profile 前必须关闭。ComposeStabilityAnalyzer.setEnabled(true) 不得进入生产,需用 BuildConfig.DEBUG 或专用开关控制。无 @TraceRecomposition 时不会出现内联块。纯源码诊断、CI 稳定性门禁、发布级测量等场景应使用其他技能。