Android Compose集成高德地图

软件发布|下载排行|最新软件

当前位置:首页IT学院IT技术

Android Compose集成高德地图

Halifax   2022-09-29 我要评论

正文

Compose中我们应该怎么使用地图呢?像之前我们在xml里面创建MapView,都是在Activity里面,管理MapView生命周期,和其他的监听器,Compose里面怎么搞?

下面我们以高德地图为例,在Compose中创建地图MapView,然后用AndroidView添加MapView,像下面这样:

AndroidView(modifier = Modifier, factory = { MapView }){...}

高德地图官网开发者建议

我们看到,高德地图官网,给开发者的建议:

所以我们需要做什么,大家晓得了哇,生命周期回调我们要拿到,那我们应该怎么搞?

我们需要用到LocalLifecycleOwner.current.lifecycle去添加生命周期观察者, LifecycleObserver是一个接口,它长下面这样:

我们看注释可以看到,我们可以使用DefaultLifecycleObserver或者LifecycleEventObserverDefaultLifecycleObserver里面它提供了所有的生命周期事件的回调,并且默认情况下都是什么都不做。 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个方法: onConfigurationChangedonLowMemory

onConfigurationChanged: 设备配置发生改变,组件还在运行时

onLowMemory:系统运行的内存不足时,可以通过实现该方法去释放内存或不需要的资源,我们需要在这个方法里面,调用MapView#onLowMemory

在上面官方文档中,我们看到地图的生命周期管理,需要调用下面4个方法: MapView#onCreateMapView#onResumeMapView#onPauseMapView#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个生命周期的回调,onResumeonPause

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集成的高德地图效果

Copyright 2022 版权所有 软件发布 访问手机版

声明:所有软件和文章来自软件开发商或者作者 如有异议 请与本站联系 联系我们