Android SupportMapFragment显示对话框后地图动画卡顿解决求助

阿华AIGC实验室

2026-5-15

Android Google Maps 相机动画在显示BottomSheetDialog时卡顿的解决办法

问题描述

我在Android应用中使用SupportMapFragment展示空气质量监测站的读数。当点击地图标记时，我想要同时完成两个操作：弹出详情BottomSheetDialog，以及将地图缩放到选中的站点位置。但目前对话框显示后，地图的相机动画出现严重卡顿，无法流畅运行。

我的实现代码如下：

map.setOnMarkerClickListener { marker ->
    if (!clusterManager.onMarkerClick(marker)) {
        BottomSheetDialog(context!!).apply {
            // 设置对话框内容
            show()
        }
    }
    map.animateCamera(CameraUpdateFactory.newCameraPosition(
        CameraPosition(marker.position, 14f, TILT, BEARING)
    ))
    true
}

解决方案：错开动画与对话框的资源抢占时机

出现卡顿的核心原因是：BottomSheetDialog的初始化和显示会触发大量UI绘制操作，和地图的相机动画在同一时间段内抢占主线程资源，导致动画丢帧。我们可以把地图动画延迟到对话框完成布局渲染后再执行，避免资源竞争。

修改后的代码示例

map.setOnMarkerClickListener { marker ->
    if (!clusterManager.onMarkerClick(marker)) {
        BottomSheetDialog(context!!).apply {
            // 设置对话框内容
            // 监听对话框显示完成的事件，确保布局渲染完毕再执行地图动画
            setOnShowListener {
                map.animateCamera(
                    CameraUpdateFactory.newCameraPosition(
                        CameraPosition(marker.position, 14f, TILT, BEARING)
                    ),
                    500, // 自定义动画时长，和对话框弹出节奏匹配
                    null
                )
            }
            show()
        }
    } else {
        // 如果是集群标记被点击，直接执行动画即可
        map.animateCamera(
            CameraUpdateFactory.newCameraPosition(
                CameraPosition(marker.position, 14f, TILT, BEARING)
            )
        )
    }
    true
}

额外优化建议

简化相机更新操作：如果不需要调整倾斜角和方位角，直接用CameraUpdateFactory.newLatLngZoom(marker.position, 14f)，减少不必要的计算开销。
排查对话框布局性能：用Android Studio的Layout Inspector和Profile GPU Rendering工具检查BottomSheet的布局，避免过度绘制、嵌套过深的问题。
短暂延迟兜底：如果setOnShowListener仍有卡顿，可以尝试给动画加100ms左右的延迟，确保对话框完全渲染：
```
view?.postDelayed({
    map.animateCamera(...)
}, 100)
```
避免动画期间的额外操作：不要在相机动画执行时触发网络请求、列表刷新等主线程任务，减少线程负担。