📚 课程目录第3章 Compose与第三方原生SDK集成

第3章 Compose与第三方原生SDK集成：通过AndroidView封装、回调桥接、线程切换

3.1 原理

Compose 与第三方原生 SDK（如地图、视频播放器、支付组件）集成时，核心矛盾在于：Compose 声明式 UI 层无法直接持有原生 View 实例及其生命周期，而 SDK 通常基于传统 View 体系、依赖 Activity/Fragment 生命周期、回调运行在未知线程。解决方案围绕三个维度：

AndroidView 封装 – 将原生 View 包装为 Composable，自动管理 create/dispose 与布局测量。
回调桥接 – 将 SDK 的监听器/回调转换为 Compose 可观察的 State 或 Flow。
线程切换 – 保证原生回调中 UI 更新必须回到主线程，避免 CalledFromWrongThreadException。

3.2 实现流程

在 AndroidView 工厂 lambda 中创建原生 View 并返回。
使用 DisposableEffect 监听 Composable 生命周期，在 onDispose 中释放 SDK 资源。
通过 remember 创建 mutableStateOf 持有回调数据，并在原生监听器里写入该状态。
在回调体内用 withContext(Dispatchers.Main) 或 LaunchedEffect 桥接线程。
Compose 自动根据状态变化触发重组。

关键约定：AndroidView 的 update lambda 在重组时会被调用，应避免在其中重复创建原生 View；只在初始创建时注册一次回调，后续仅更新数据。

3.3 核心 API 与配置

API / 组件	职责	线程安全
`AndroidView`	包装原生 View，提供工厂与更新回调	Compose 侧主线程
`DisposableEffect`	管理生命周期，用于注册/注销 SDK 监听器	主线程
`mutableStateOf`	响应式容器，驱动重组	线程安全（写入需主线程）
`LaunchedEffect`	协程作用域，用于从任意线程切换至主线程	任意线程
`Dispatchers.Main`	协程分派到主线程	N/A

3.4 代码示例：集成第三方地图 SDK

以下示例演示如何将 DemoMapView（第三方 SDK 中的原生 View）封装为 Compose 组件，并将相机移动回调桥接到 Compose 状态。

@Composable
fun MapComponent(
    onCameraMove: (LatLng) -> Unit
) {
    // 1. 持有原生 View 引用（避免重组重建）
    val mapView = remember { DemoMapView(LocalContext.current) }

    // 2. 创建状态容器接收回调数据
    var cameraPosition by remember { mutableStateOf(LatLng(0.0, 0.0)) }

    // 3. 生命周期管理 & 回调注册
    DisposableEffect(Unit) {
        val listener = object : DemoOnCameraMoveListener {
            override fun onMove(latLng: LatLng) {
                // 桥接：切换到主线程更新状态
                // 使用 CoroutineScope 或 LaunchedEffect 均可
                // 这里用 LaunchedEffect 在外部处理，更推荐
            }
        }
        mapView.addOnCameraMoveListener(listener)

        onDispose {
            mapView.removeOnCameraMoveListener(listener)
        }
    }

    // 4. 线程桥接：当原生回调到来时，使用 LaunchedEffect 更新 Compose 状态
    LaunchedEffect(Unit) {
        // 实际场景可通过 Flow 或回调事件触发
        // 此处省略具体实现，仅展示模式
    }

    // 5. AndroidView 封装（工厂只创建一次）
    AndroidView(
        factory = { mapView },
        modifier = Modifier.fillMaxSize()
    ) { view ->
        // update lambda：仅在需要更新 view 属性时使用
    }
}

线程陷阱：原生回调可能运行在任意线程（如 IO、数据库线程），直接写入 mutableStateOf 会抛出异常。务必使用 withContext(Dispatchers.Main) 或 LaunchedEffect 将更新主线程。

3.5 调试技巧

在回调入口处打印线程信息：Log.d("SDK", "callback on ${Thread.currentThread().name}")。
使用 StrictMode 检测线程违规：StrictMode.setThreadPolicy(...)。
在主线程写入 mutableStateOf 后，检查重组次数是否异常（LayoutInspector + 日志）。

3.6 部署注意事项

ProGuard 规则：保留 SDK 中供反射调用的类和方法，例如：
```
-keep class com.thirdparty.** { *; }
```
权限声明：如果 SDK 需要定位、相机等，在 AndroidManifest.xml 添加，并在运行时请求。
多 Activity 支持：若 SDK 依赖 Activity 生命周期，使用 LocalContext.current 确保为 ComponentActivity 实例。

3.7 常见错误

错误现象	根因	解决方案
应用崩溃：CalledFromWrongThreadException	原生回调直接更新 Compose 状态	使用 `Dispatchers.Main` 切换线程
内存泄漏：SDK 持有 Activity 引用	未在 `DisposableEffect.onDispose` 中注销监听器	正确实现 onDispose
AndroidView 多次重建	在 `update` lambda 中重复创建 View	将 View 实例通过 `remember` 持有
回调丢失或重复	多个 Composable 实例共享同一 SDK 对象	使用 `remember` 确保单例

3.8 性能与稳定性优化

避免过度重组：将回调数据合并为一次状态更新（如 Snapshot 一次写入多个属性）。
使用视图池：对于列表中使用 AndroidView，使用 LazyColumn 的 key 参数防止 View 被频繁销毁重建。
异步初始化：如果 SDK 初始化耗时，用 LaunchedEffect 异步初始化，期间显示占位 UI。
SurfaceView / TextureView 兼容：部分 SDK 使用 SurfaceView，需在 AndroidView 中设置正确 Z 顺序。

3.9 本章总结

通过 AndroidView、DisposableEffect 与状态桥接模式，Compose 可以安全、高效地集成任意第三方原生 SDK。关键控制点在：生命周期同步、线程安全、状态绑定。掌握本章流程后，可在项目中复用该模式封装地图、播放器、支付等原生组件。