兼容与共生:如何在旧项目中优雅地引入 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

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

相关推荐
2601_9605679617 小时前
电商套图自动化效率的工程量化分析——从逐张生成到批量套图的架构演进
运维·架构·自动化
shiyi.十一17 小时前
第2章:应用层 — 知识要点与架构
网络·计算机网络·架构
张忠琳18 小时前
【NVIDIA】 NVIDIA Container Toolkit v1.19.1 — OCI 模块超深度分析之三
云原生·容器·架构·kubernetes·nvidia
执明wa19 小时前
LayoutInflater详解: XML是如何变成View的?
android·xml·开发语言·android studio
404_coder19 小时前
源码视角下的 Android 开机流程:从 Zygote、SystemServer 到 Launcher
android
XUHUOJUN19 小时前
Azure Local VM 部署第 1 篇:Hyperconverged 路径完整实战
架构·azure local
二流小码农19 小时前
鸿蒙开发:以登录案例了解代码架构MVVM
android·ios·harmonyos
用户693717500138420 小时前
从代码生产者到 AI 协作者:软件工程师的角色重构
android·前端·后端
GitLqr21 小时前
别在 Flutter 的 main() 里乱锁屏幕方向,小心 iPad 分屏功能被你搞没了
android·flutter·ios