目录
正文
Compose中我们应该怎么使用地图呢?像之前我们在xml里面创建MapView,都是在Activity里面,管理MapView生命周期,和其他的监听器,Compose里面怎么搞?
下面我们以高德地图为例,在Compose中创建地图MapView,然后用AndroidView添加MapView,像下面这样:
AndroidView(modifier = Modifier, factory = { MapView }){...}
高德地图官网开发者建议
我们看到,高德地图官网,给开发者的建议:
所以我们需要做什么,大家晓得了哇,生命周期回调我们要拿到,那我们应该怎么搞?
我们需要用到LocalLifecycleOwner.current.lifecycle
去添加生命周期观察者, LifecycleObserver
是一个接口,它长下面这样:
我们看注释可以看到,我们可以使用DefaultLifecycleObserver或者LifecycleEventObserver, DefaultLifecycleObserver
里面它提供了所有的生命周期事件的回调,并且默认情况下都是什么都不做。 LifecycleEventObserver,它提供了一个onStateChanged
方法,所有的生命周期事件都可以在这里被接受到。
所以,我们这里就使用LifecycleEventObserver,为啥懂的都懂。
我们有了2个需要初始化的东西,一个是MapView,一个是添加生命周期观察者。
为什么要添加生命周期观察者,看了上面的官方文档应该知道是为什么,是需要管理地图的生命周期,下面我们来讲讲如何做,该怎么做。
初始化MapView并添加到AndroidView里面
val context = LocalContext.current // aMapOptionsFactory: () -> AMapOptions = { AMapOptions() } val mapView = remember { MapView(context, aMapOptionsFactory()).apply{ id = R.id.map } } // 添加MapView AndroidView(modifier = modifier, factory = { mapView })
我们来拆解一下,如何添加生命周期管理者,我们给大家聊聊:registerComponentCallbacks,这个ComponentCallbacks里面提供了2个方法: onConfigurationChanged
、onLowMemory
onConfigurationChanged
: 设备配置发生改变,组件还在运行时
onLowMemory
:系统运行的内存不足时,可以通过实现该方法去释放内存或不需要的资源,我们需要在这个方法里面,调用MapView#onLowMemory
在上面官方文档中,我们看到地图的生命周期管理,需要调用下面4个方法: MapView#onCreate
、MapView#onResume
、MapView#onPause
、MapView#onDestory
,有了这些前奏,我们就知道怎么写地图生命周期的扩展方法了。
MapView增加一个管理地图生命周期的扩展
// 管理地图生命周期 private fun MapView.lifecycleObserver(): LifecycleEventObserver = LifecycleEventObserver { _, event -> when (event) { Lifecycle.Event.ON_CREATE -> this.onCreate(Bundle()) Lifecycle.Event.ON_RESUME -> this.onResume() // 重新绘制加载地图 Lifecycle.Event.ON_PAUSE -> this.onPause() // 暂停地图的绘制 Lifecycle.Event.ON_DESTROY -> this.onDestroy() // 销毁地图 else -> {} } } private fun MapView.componentCallbacks(): ComponentCallbacks = object : ComponentCallbacks { // 设备配置发生改变,组件还在运行时 override fun onConfigurationChanged(config: Configuration) {} // 系统运行的内存不足时,可以通过实现该方法去释放内存或不需要的资源 override fun onLowMemory() { // 调用地图的onLowMemory this@componentCallbacks.onLowMemory() } }
给MapView添加生命周期观察者
@Composable private fun MapLifecycle(mapView: MapView) { val context = LocalContext.current val lifecycle = LocalLifecycleOwner.current.lifecycle DisposableEffect(context, lifecycle, mapView) { val mapLifecycleObserver = mapView.lifecycleObserver() val callbacks = mapView.componentCallbacks() // 添加生命周期观察者 lifecycle.addObserver(mapLifecycleObserver) // 注册ComponentCallback context.registerComponentCallbacks(callbacks) onDispose { // 删除生命周期观察者 lifecycle.removeObserver(mapLifecycleObserver) // 取消注册ComponentCallback context.unregisterComponentCallbacks(callbacks) } } }
添加MapView的生命周期控制
使用起来也很容易,先初始化MapView然后添加到AndroidView,最后添加MapView的生命周期控制:
val context = LocalContext.current val mapView = remember { MapView(context, aMapOptionsFactory()).apply{ id = R.id.map } } AndroidView(modifier = modifier, factory = { mapView }) MapLifecycle(mapView)
这样只能说满足我们的正常地图显示,实际上我们开发过程中,常见的地图拖拽选点、定位蓝点、标记位等都需要我们去扩展。
拿地图拖拽选点功能来说,我们就需要在MapLifecycle添加2个生命周期的回调,onResume和onPause
MapLifecycle( mapView = mapView, // 从mapView.lifecycleObserver回调回来即可 onResume = { mapView.map.apply{ setOnMapLoadedListener(...) setOnCameraChangeListener(...) } }, onPause = { mapView.map.apply{ setOnMapLoadedListener(null) setOnCameraChangeListener(null) } } )
剩下的功能,都是拿AMap对象去做事情,添加覆盖物,移动相机镜头等等。
注意: 初始化地图的时候,传入的aMapOptionsFactory,可以从外面初始化好传进来。
aMapOptionsFactory: () -> AMapOptions = { AMapOptions() }
Compose集成的高德地图效果
以上就是Android开发Compose集成高德地图实例的详细内容,更多关于Android Compose集成高德地图的资料请关注其它相关文章!