1. Compose与原生View互嵌基础：AndroidView、ComposeView、生命周期绑定、布局参数传递

1.1 原理：为什么需要互嵌

在大型项目中，Jetpack Compose 与原生 View 系统并存是常态。互嵌允许开发者逐步迁移，保留已有 MapView、WebView、CameraX 等原生组件，同时利用 Compose 的声明式 UI 优势。

• 正向嵌入：Compose 内使用 AndroidView 包裹原生 View。
• 反向嵌入：原生 XML/代码布局内使用 ComposeView 作为宿主容器。
• 生命周期绑定：确保原生 View 的 onAttach/onDetach 与 Compose 的 Composable 生命周期对齐。
• 布局参数传递：将 Compose 的 Modifier 映射为原生 ViewGroup.LayoutParams，或反向读取原生尺寸。

1.2 核心 API 与参数清单

1.3 实现流程：正向嵌入（AndroidView）

1. 创建工厂：在 factory lambda 中实例化原生 View，设置初始参数。
2. 更新回调：在 update lambda 中响应 Compose 状态变化，更新 View 属性。
3. 生命周期绑定：使用 DisposableEffect 注册 onDetach 清理资源。
4. 布局参数：通过 Modifier 约束 View 尺寸，内部自动转换为 LayoutParams。

@Composable
fun MapViewInCompose(lat: Double, lng: Double) {
    val context = LocalContext.current
    AndroidView(
        factory = { ctx ->
            MapView(ctx).apply {
                // 初始配置
                setMapType(GoogleMap.MAP_TYPE_NORMAL)
            }
        },
        update = { mapView ->
            mapView.getMapAsync { googleMap ->
                googleMap.moveCamera(CameraUpdateFactory.newLatLngZoom(LatLng(lat, lng), 15f))
            }
        },
        modifier = Modifier.fillMaxSize()
    )
}

1.4 实现流程：反向嵌入（ComposeView）

1. XML 声明：在布局文件中添加 <androidx.compose.ui.platform.ComposeView />。
2. 代码控制：在 Activity/Fragment 中通过 findViewById 获取实例，调用 setContent。
3. 生命周期策略：设置 ViewCompositionStrategy.DisposeOnDetachedFromWindow 防止泄漏。
4. 布局参数适配：原生容器通过 layout_width/height 约束，Compose 内使用 Modifier 自我调整。

// XML: activity_main.xml
<androidx.compose.ui.platform.ComposeView
    android:id="@+id/compose_view"
    android:layout_width="match_parent"
    android:layout_height="200dp" />

// Activity
val composeView = findViewById<ComposeView>(R.id.compose_view)
composeView.apply {
    setViewCompositionStrategy(ViewCompositionStrategy.DisposeOnDetachedFromWindow)
    setContent {
        MaterialTheme {
            Button(onClick = { /* ... */ }) {
                Text("Click Me")
            }
        }
    }
}

1.5 生命周期绑定详解

• 正向嵌入：DisposableEffect(Unit) 在 Composable 退出组合时自动执行 onDispose，调用 View 的 onDetach() 逻辑。
• 反向嵌入：ComposeView 默认在 onDetachedFromWindow 时释放 Compose 内容；若需与 Fragment 生命周期对齐，使用 DisposeOnViewTreeLifecycleDestroyed。

// AndroidView + DisposableEffect 模式
AndroidView(
    factory = { ctx -> CustomView(ctx) },
    update = { view -> view.updateData(data) }
) {
    DisposableEffect(Unit) {
        onDispose {
            // 清理原生资源，如注销广播、释放Camera等
        }
    }
}

1.6 布局参数传递

Compose 的 Modifier 在 AndroidView 内部自动转换为原生 ViewGroup.LayoutParams。但自定义权重或复杂布局需手动桥接。

// 反向获取原生 View 尺寸并传递回 Compose
AndroidView(
    factory = { ctx -> SurfaceView(ctx) },
    modifier = Modifier.onSizeChanged { width, height ->
        // 更新 Compose 状态
        viewSize.value = IntSize(width, height)
    }
)

1.7 互嵌架构流程

1.8 常见错误与调试

1.9 性能与稳定性优化

• 减少冗余更新：在 update lambda 内对比数据前后变化，避免频繁调用 invalidate() 或 requestLayout()。
• 使用 derivedStateOf：将原生 View 的尺寸、触摸事件等转换为 Compose State 时增加降频。
• 避免多层嵌套：不要在 AndroidView 内部再嵌 ComposeView，会导致两套组合系统自循环。
• 预实例化池：若频繁切换 AndroidView 显示/隐藏，可复用 factory 创建的 View 实例（配合 key）。

// 优化示例：使用 remember 缓存 factory
val cachedView = remember { CustomView(context) }
AndroidView(
    factory = { cachedView },
    update = { view -> view.updateData(data) }
)

1.10 部署检查清单

1. 验证 AndroidView 在 Scrollable 容器内滑动流畅度。
2. 测试 ComposeView 放在 RecyclerView 的 Item 中时，setContent 不会被重复调用。
3. 使用 Layout Inspector 检查原生 View 的 LayoutParams 是否与 Modifier 一致。