兼容与共生:如何在旧项目中优雅地引入 Compose?

前言

作为一名 Android 老兵,我们面临的最现实问题往往不是"如何写一个全新的 Compose 项目",而是"如何在拥有成百上千个 Activity/Fragment 的旧项目中引入 Compose"。

你不可能一夜之间推翻重来。幸运的是,Google 在设计 Compose 之初就考虑到了这一点,提供了极其强大的互操作性(Interoperability)

今天,我们就来聊聊 Compose 与传统 View 体系的"双向奔赴":如何在 XML 里塞进 Compose,以及如何在 Compose 里调用那些复杂的旧插件。


一、 场景 A:在 View 体系中引入 Compose (Top-down)

这是最常见的场景:你想用 Compose 写一个新功能,或者重构某一个复杂的列表项。

1. 使用 ComposeView

在 XML 布局中,你可以直接放置一个 ComposeView 作为占位符:

xml 复制代码
<androidx.compose.ui.platform.ComposeView
    android:id="@+id/compose_view"
    android:layout_width="match_parent"
    android:layout_height="wrap_content" />

然后在 Activity/Fragment 中绑定:

kotlin 复制代码
binding.composeView.setContent {
    MatherialTheme {
        MyNewComposeFeature()
    }
}

2. 在 Fragment 中使用

如果你想把一整个页面换成 Compose,直接在 onCreateView 中返回 ComposeView 即可,甚至连 XML 都不需要了。

老兵 Tips :记得设置 ViewCompositionStrategy。默认情况下,Compose 会在 View 从窗口移除时销毁。在 Fragment 中,建议设置为 DisposeOnViewTreeLifecycleDestroyed,以匹配 Fragment 的生命周期。


二、 场景 B:在 Compose 中调用传统 View (Bottom-up)

有些复杂的旧插件(如谷歌地图 Google Maps、WebView、或者公司内部沉淀的视频播放器)还没有 Compose 版本。

使用 AndroidView

kotlin 复制代码
@Composable
fun LegacyWebView(url: String) {
    AndroidView(
        factory = { context ->
            WebView(context).apply {
                webViewClient = WebViewClient()
            }
        },
        update = { webView ->
            webView.loadUrl(url)
        }
    )
}
  • factory:只在第一次组合时运行,用于创建 View 实例。
  • update :在重组时运行。如果 url 变了,update 块会被触发,你可以在这里更新 View 的属性。

三、 状态同步:两个世界的桥梁

混合开发最难的是数据同步。

  1. View -> Compose :将 View 的监听器转换为 Compose 的 MutableState
  2. Compose -> View :在 AndroidViewupdate 块中,根据 Compose 状态调用 View 的 Setter 方法。
  3. ViewModel 共享 :这是终极方案。由于 Compose 和 View 都可以绑定到同一个 ViewModel(通过 Activity 作用域),你可以让两套体系观察同一个 StateFlow,实现真正的无缝衔接。

四、 给开发者的混编建议

  1. 从"叶子节点"开始重构:不要一上来就改 Activity。先从一个小按钮、一个复杂的列表 Item 开始。
  2. 主题统一 :这是视觉灾难的高发区。如果你在旧体系用了 AppCompat 主题,在 Compose 中需要通过 Adapter(如 MdcTheme)将 XML 颜色映射到 Compose 的 MaterialTheme
  3. 性能陷阱 :避免在 AndroidViewupdate 块中执行耗时操作。虽然它能工作,但频繁重组时会导致 View 的 Setter 被过度调用。

结语

Compose 与 View 的混编不是一种权宜之计,而是一个长期的过渡状态。掌握了双向互操作,你就拥有了"渐进式重构"的主动权。你可以一边保持业务的稳定运行,一边享受声明式 UI 带来的开发红利。


下一篇我们将开启最终阶段:Compose Multiplatform 揭秘:一套代码如何搞定 Android、iOS、Desktop 和 Web

如果你觉得有帮助,欢迎点赞关注,我们在代码上演进,在原理上深耕。

相关推荐
两万五千个小时2 小时前
Claude Code 上下文管理(一):为什么 Agent 会"失忆"?
人工智能·架构·开源
Xiaoda112 小时前
从一个请求开始:LLM 推理系统如何完成一次生成?
架构
Flynt2 小时前
Room 3.0 包名重构 + KMP 迁移:我把项目升级踩了个遍
android·数据库·kotlin
杉氧2 小时前
性能优化实战:如何定位冗余重组并榨干 Compose 的每一帧性能?
android·架构·android jetpack
行者全栈架构师2 小时前
PolarDB + Spring Boot 实战:从自建MySQL到云原生数据库的零停机迁移
java·后端·架构
alexhilton14 小时前
将应用迁移到Navigation 3:痛点、加班和紧急修复
android·kotlin·android jetpack
Elcker18 小时前
KoiWeave-构建企业级LLM-WIKI,打造下一阶段软件AI研发流程
架构
杉氧19 小时前
Navigation Compose 深度实践:如何优雅地串联起你的全栈 App?
android·架构·android jetpack