OSMDroid+Jetpack Compose模式切换地图异常问题求助

1. 调整ViewModel职责，避免持有View实例 #

ViewModel不应持有Activity或View实例，改为存储地图状态数据，并提供瓦片源适配逻辑：

class MainViewModel(application: Application) : ViewModel() {
    // 存储多边形Overlay，确保主题切换时不丢失
    val polygonOverlays = mutableStateListOf<Polygon>()

    // 根据主题返回对应瓦片源的TileProvider
    fun getTileProvider(context: Context, isDarkMode: Boolean): MapTileProviderBasic {
        val tileSource = if (isDarkMode) {
            // 替换为深色瓦片源，可使用自定义在线瓦片或OSMDroid内置深色源
            OnlineTileSourceBase(
                "Mapnik Dark",
                0, 19, 256, ".png",
                arrayOf("https://tiles.stadiamaps.com/tiles/alidade_smooth_dark/{z}/{x}/{y}.png")
            )
        } else {
            TileSourceFactory.MAPNIK
        }
        return MapTileProviderBasic(context, tileSource).apply {
            tileRequestCompleteHandlers.add(SimpleInvalidationHandler(null))
        }
    }
}

2. 修复MapView Composable，适配主题切换 #

在Composable中处理主题变化时的瓦片更新，同步Overlay列表：

@Composable
fun MapView(
    modifier: Modifier = Modifier,
    isDarkMode: Boolean = isSystemInDarkTheme(),
    polygonOverlays: List<Polygon>,
    onMapReady: ((MapView) -> Unit)? = null
) {
    val mapView = rememberMapViewWithLifecycle()
    val context = LocalContext.current
    val viewModel = viewModel<MainViewModel>()

    // 主题切换时更新瓦片源
    LaunchedEffect(isDarkMode) {
        mapView.tileProvider = viewModel.getTileProvider(context, isDarkMode)
        mapView.invalidate()
    }

    // 同步多边形Overlay，避免切换主题时丢失
    LaunchedEffect(polygonOverlays) {
        mapView.overlays.removeAll { it is Polygon }
        mapView.overlays.addAll(polygonOverlays)
        mapView.invalidate()
    }

    AndroidView(
        factory = { mapView },
        modifier = modifier
    ) { view ->
        view.apply {
            id = R.id.map
            clipToOutline = true
            zoomController.setVisibility(CustomZoomButtonsController.Visibility.NEVER)
            setMultiTouchControls(true)
        }
        onMapReady?.invoke(view)
    }
}

3. 改造MapScreen，传递必要参数 #

@Composable
fun MapScreen(
    paddingValues: PaddingValues,
    mainViewModel: MainViewModel = viewModel()
) {
    val isDarkMode = isSystemInDarkTheme()

    MapView(
        modifier = Modifier.padding(paddingValues),
        isDarkMode = isDarkMode,
        polygonOverlays = mainViewModel.polygonOverlays,
        onMapReady = { mapView ->
            // 初始化地图位置、缩放等配置
            val mapController = mapView.controller
            mapController.setZoom(15.0)
            mapController.setCenter(GeoPoint(39.9042, 116.4074))
        }
    )
}

4. 管理多边形Overlay的添加逻辑 #

添加多边形时直接写入ViewModel的状态列表，确保状态持久化：

// 示例：添加多边形方法
fun addPolygon(viewModel: MainViewModel) {
    val polygon = Polygon().apply {
        addPoint(GeoPoint(39.9042, 116.4074))
        addPoint(GeoPoint(39.9052, 116.4084))
        addPoint(GeoPoint(39.9062, 116.4074))
        fillColor = Color.argb(128, 255, 0, 0)
        strokeColor = Color.RED
        strokeWidth = 2f
    }
    viewModel.polygonOverlays.add(polygon)
}

核心说明 #

• ViewModel只存状态：避免持有MapView这类View层控件，防止内存泄漏和生命周期冲突。
• 主题切换强制更新瓦片：不同主题对应不同瓦片源，切换时重新绑定TileProvider并刷新地图。
• Overlay状态同步：将多边形存储在ViewModel的可变状态列表中，主题切换时自动重新添加到MapView。
• 依赖rememberMapViewWithLifecycle：该方法已封装MapView的生命周期管理（onPause/onResume等），无需手动调用。

内容的提问来源于stack exchange，提问作者Pion Developer