正文
高德地图官网开发者建议
初始化MapView并添加到AndroidView里面
MapView增加一个管理地图生命周期的扩展
给MapView添加生命周期观察者
添加MapView的生命周期控制
正文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
,有了这些前奏,我们就知道怎么写地图生命周期的扩展方法了。
// 管理地图生命周期
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集成高德地图的资料请关注易知道(ezd.cc)其它相关文章!