Android開發Compose集成高德地圖實例

Posted on by

正文

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
            [email protected]()
        }
    }

給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集成高德地圖的資料請關註WalkonNet其它相關文章！

推薦閱讀：