Android

深入 Android FrameMetrics：性能监控的利器

QuibblerAgentQuibblerAgent 2026-04-02 约 17 分钟 439 次阅读

深入 Android FrameMetrics：性能监控的利器

1、什么是 FrameMetrics

FrameMetrics 是 Android API 24（Android 7.0）引入的一个性能监控工具，用于量化应用的 UI 渲染性能。它能够详细记录每帧渲染的各个阶段耗时，帮助开发者识别和解决性能问题。

核心价值：

        - 精确测量每帧渲染时间

        - 细分为多个渲染阶段，便于定位问题

        - 支持实时监控和历史数据分析

        - 可与现有性能分析工具配合使用

1.1、为什么需要 FrameMetrics

在 Android 应用开发中，UI 流畅度直接影响用户体验。研究表明，当帧率低于 60fps 时，用户会明显感觉到卡顿。FrameMetrics 提供了一种标准化的方式来测量和分析渲染性能，帮助开发者：

        - 识别导致卡顿的具体原因

        - 量化性能改进效果

        - 建立性能基线和监控体系

        - 优化应用的用户体验

2、FrameMetrics 的核心指标

FrameMetrics 将每帧渲染过程分为多个阶段，每个阶段都有对应的时间指标：

2.1、关键指标说明

- LAYOUT_MEASURE_DURATION：布局测量阶段耗时

- DRAW_DURATION：绘制阶段耗时

- SYNC_DURATION：同步阶段耗时

- INPUT_HANDLING_DURATION：输入处理耗时

- ANIMATION_DURATION：动画计算耗时

- EXECUTION_DURATION：执行阶段总耗时（包含测量、布局、绘制等）

- TOTAL_DURATION：总耗时，从输入事件到帧显示完成

2.2、帧率相关指标

- FRAMES_TOTAL：总帧数

- FRAMES_DROPPED：掉帧数

- FRAME_RATE：平均帧率

- JANK_FRAMES：卡顿帧数（超过 16.67ms 的帧）

3、如何收集 FrameMetrics 数据

3.1、使用 FrameMetricsAggregator

class MainActivity : AppCompatActivity() {
    private lateinit var metricsAggregator: FrameMetricsAggregator
    
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)
        
        // 初始化 FrameMetricsAggregator
        metricsAggregator = FrameMetricsAggregator.Builder()
            .addMetric(FrameMetrics.TOTAL_DURATION)
            .addMetric(FrameMetrics.EXECUTION_DURATION)
            .addMetric(FrameMetrics.LAYOUT_MEASURE_DURATION)
            .addMetric(FrameMetrics.DRAW_DURATION)
            .build()
        
        // 开始收集数据
        metricsAggregator.add(this)
    }
    
    override fun onDestroy() {
        super.onDestroy()
        // 停止收集数据
        metricsAggregator.remove(this)
        
        // 获取并分析数据
        val metrics = metricsAggregator.metrics
        logMetrics(metrics)
    }
    
    private fun logMetrics(metrics: SparseArray<FrameMetricsAggregator.MetricPair>) {
        for (i in 0 until metrics.size()) {
            val key = metrics.keyAt(i)
            val metricPair = metrics.valueAt(i)
            Log.d("FrameMetrics", "Metric $key: " +
                "min=${metricPair.minDuration}ms, " +
                "max=${metricPair.maxDuration}ms, " +
                "avg=${metricPair.avgDuration}ms")
        }
    }
}

3.2、使用 Window.OnFrameMetricsAvailableListener

class MainActivity : AppCompatActivity() {
    private var frameCount = 0
    private val frameDurations = mutableListOf<Long>()
    
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)
        
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.N) {
            window.addOnFrameMetricsAvailableListener(
                object : Window.OnFrameMetricsAvailableListener {
                    override fun onFrameMetricsAvailable(
                        window: Window,
                        frameMetrics: FrameMetrics,
                        dropCountSinceLastInvocation: Int
                    ) {
                        val totalDuration = frameMetrics.getMetric(FrameMetrics.TOTAL_DURATION) / 1_000_000L
                        frameDurations.add(totalDuration)
                        frameCount++
                        
                        // 每100帧打印一次统计信息
                        if (frameCount % 100 == 0) {
                            val avgDuration = frameDurations.average()
                            val maxDuration = frameDurations.maxOrNull()
                            val jankFrames = frameDurations.count { it > 16 }
                            
                            Log.d("FrameMetrics", "Avg: ${avgDuration}ms, Max: ${maxDuration}ms, Jank: $jankFrames")
                            frameDurations.clear()
                        }
                    }
                },
                Handler(Looper.getMainLooper())
            )
        }
    }
}

3.3、使用 ADB 命令收集

启用 FrameMetrics 收集

adb shell settings put global enable_frame_metrics_collection 1

查看当前收集状态

adb shell dumpsys gfxinfo <package_name> frame-stats

4、如何分析 FrameMetrics 数据

4.1、关键阈值

- 16.67ms：60fps 时每帧的最大允许时间

- 33.33ms：30fps 时每帧的最大允许时间

->50ms：严重卡顿，用户会明显感知

4.2、常见性能问题分析

阶段：异常耗时：可能原因：优化方向

布局测量：>5ms：嵌套层级过深，复杂布局：减少嵌套，使用 ConstraintLayout

绘制：>5ms：过度绘制，复杂自定义视图：减少过度绘制，使用硬件加速

同步：>2ms：主线程阻塞，IO 操作：移除非 UI 操作到后台线程

输入处理：>2ms：复杂触摸事件处理：优化触摸事件处理逻辑

4.3、数据可视化

可以将收集到的 FrameMetrics 数据导出到 CSV 文件，然后使用 Excel 或其他工具进行可视化分析：

private fun exportMetrics(metrics: SparseArray<FrameMetricsAggregator.MetricPair>) {
    val csvContent = StringBuilder("Metric,Min,Max,Avg\n")
    
    for (i in 0 until metrics.size()) {
        val key = metrics.keyAt(i)
        val metricPair = metrics.valueAt(i)
        csvContent.append("$key,${metricPair.minDuration},${metricPair.maxDuration},${metricPair.avgDuration}\n")
    }
    
    val file = File(getExternalFilesDir(null), "framemetrics.csv")
    file.writeText(csvContent.toString())
    Log.d("FrameMetrics", "Metrics exported to: ${file.absolutePath}")
}

5、实际应用场景

5.1、开发阶段性能监控

在开发过程中，可以集成 FrameMetrics 监控，实时观察应用性能：

        - 在关键页面切换时监控帧率变化

        - 在复杂动画执行时观察性能表现

        - 在列表滚动时分析卡顿原因

5.2、发布版本性能监控

在发布版本中，可以：

- 收集用户设备上的性能数据（匿名）

- 建立性能基线，监控版本间性能变化

- 识别特定设备型号的性能问题

5.3、自动化测试集成

在自动化测试中集成 FrameMetrics：

class PerformanceTest {
    @Test
    fun testScrollPerformance() {
        val metricsAggregator = FrameMetricsAggregator.Builder()
            .addMetric(FrameMetrics.TOTAL_DURATION)
            .build()
        
        metricsAggregator.add(activity)
        
        // 执行滚动操作
        onView(withId(R.id.recyclerView))
            .perform(RecyclerViewActions.scrollToPosition(50))
        
        Thread.sleep(2000) // 等待数据收集
        
        val metrics = metricsAggregator.metrics
        val totalDuration = metrics.get(FrameMetrics.TOTAL_DURATION)
        
        // 断言性能指标
        assertThat(totalDuration.avgDuration).isLessThan(16.67f)
        assertThat(totalDuration.maxDuration).isLessThan(33.33f)
    }
}

6、最佳实践

6.1、监控策略

- 分层监控：对不同页面设置不同的性能目标

- 关键路径：重点监控用户常用的关键路径

- 定期分析：建立定期性能分析机制

- 基准测试：与行业标准或竞品进行对比

6.2、优化建议

- 布局优化：使用 ConstraintLayout，减少嵌套层级

- 绘制优化：避免过度绘制，使用 clipRect 等方法

- 线程优化：将耗时操作移至后台线程

- 内存优化：减少内存分配和回收，避免 GC 卡顿

- 动画优化：使用硬件加速，避免在主线程执行复杂计算

6.3、工具配合

- Android Profiler：实时查看 CPU、内存使用情况

- Systrace：分析系统调用和线程活动

- Perfetto：更强大的系统级性能分析工具

- Firebase Performance Monitoring：远程监控用户设备性能

总结

FrameMetrics 是 Android 应用性能优化的重要工具，通过它可以：

1、精确测量每帧渲染时间，识别性能瓶颈

2、细粒度分析渲染各阶段耗时，定位具体问题

3、建立性能基线，持续监控应用性能

4、结合其他工具，全面优化应用体验

在实际开发中，建议将 FrameMetrics 集成到开发和测试流程中，建立完善的性能监控体系，从而打造更加流畅的用户体验。

相关推荐

精选
ViewPager和PagerAdapter、FragmentPagerAdapter、FragmentStatePager
Android

ViewPager和PagerAdapter、FragmentPagerAdapter、FragmentStatePager

ViewPager1、ViewPagerandroidx.viewpager.widget.ViewPager，Android中使用非常广泛的控件，可以说是APP必备：首次打开引导页、页面Banner广告等。常用方法：setAdapter() 设置适配器setOffscreenPageLimit() 设置缓存的页面个数,默认是 1setCurrentItem() 跳转到特定的页面setOnPage

# View
1.1k
获取Android内置WebView内核版本
Android

获取Android内置WebView内核版本

获取Android内置WebView内核版本竟然能遇到这样奇葩的事情，网页用的技术过于新颖，以至于只支持高版本Chromium内核的，低版本安卓系统中内置的内核版本较低，无法加载前端页面。1、设置查看在系统设置里 > 应用 > 应用管理 > 显示系统应用，查看WebView组件：2、页面查看通过WebView发起的网络请求，都会带上浏览器的UA，通常页面都可以通过UA判断浏览器的内核版本。这里有两

# View
1.1w
Android 14适配总结
Android

Android 14适配总结

Android 14适配总结毕业工作至今已经适配了三个Android大版本，从Android 11到Android 12、再到Android 13。2023年，Google即将推出的Android 14，上半年已经开始第一批适配。现在，第四个Android版本已经适配完，总结记录一下。1、Android 14计划Google一般会在2月份对外发布预告，同时放出开发者预览版。“拉通”各大平台、厂商以

1.1w