SuperAPI AI 工具集

android-compose-migration

编程与开发

查看项目

更新于 10-15 22:13

技能介绍

用途:把 Android 项目中的 XML 布局迁移为 Jetpack Compose,按结构化 10 步工作流执行,优先级为 P1(高)。

主要能力与步骤:1)确定迁移目标:优先选择叶子布局、自定义 View 少、避免首次迁移复杂 RecyclerView 适配器;2)分析布局结构,列出所有 View、数据绑定、点击监听、样式引用及需要 AndroidView 包装的自定义 View;3)生成每个 View 到 Composable 的映射清单并请用户确认;4)获取基线截图用于视觉对比;5)检查 build.gradle.kts 或 libs.versions.toml 中的 Compose BOM 与编译器,缺失则补充;6)按需建立最小 Compose 主题,把 XML 颜色与样式映射到 Compose,不迁移整个主题;7)逐个转换 View 为对应的 Composable,列表密集界面使用 LazyColumn 或 LazyRow,每个新 Composable 添加 @Preview;8)替换调用处,在 View 中用 ComposeView 承载 Compose,或在 Compose 中用 AndroidView 承载 View;9)用基线截图与 Compose Preview 对比,迭代直至视觉一致;10)清理已迁移的 XML 文件与旧测试,只删除无其他引用的代码。

验证项:Compose Preview 正确渲染、与原始 XML 视觉一致、./gradlew build 成功、删除 XML 后无失效引用。

限制与反模式:不要迁移整个主题,只迁移目标布局所需;不要在 AndroidView 更新中新建 View 实例,应修改已有实例;ComposeView 必须设置 ViewCompositionStrategy,避免内存泄漏。资料中还提供依赖设置与互操作模式的参考章节。